Page MenuHomeFreeBSD
Files F151961421

D55333.id172085.diff
No OneTemporary
Actions

D55333.id172085.diff
View Options

diff --git a/bin/sh/sh.1 b/bin/sh/sh.1
--- a/bin/sh/sh.1
+++ b/bin/sh/sh.1
@@ -41,7 +41,7 @@
.\" the referee document. The original Standard can be obtained online at
.\" http://www.opengroup.org/unix/online.html.
.\"
-.Dd February 9, 2026
+.Dd February 17, 2026
.Dt SH 1
.Os
.Sh NAME
@@ -82,6 +82,8 @@
plus a few Berkeley extensions.
This man page is not intended to be a tutorial nor a complete
specification of the shell.
+Each shell command, option, or feature, mentioned in this man page
+conforms to the POSIX standard, unless stated otherwise.
.Ss Overview
The shell is a command that reads lines from
either a file or the terminal, interprets them, and
@@ -228,6 +230,7 @@
.Fl V
option if it has been set;
set automatically when interactive on terminals).
+Non-standard option.
.It Fl e Li errexit
Exit immediately if any untested command fails in non-interactive mode.
The exit status of a command is considered to be
@@ -259,8 +262,10 @@
Ignore
.Dv EOF Ap s
from input when in interactive mode.
+Non-standard option.
.It Fl i Li interactive
Force the shell to behave interactively.
+Non-standard option.
.It Fl l
Force the shell to act as if it has been invoked as a login shell.
.It Fl m Li monitor
@@ -302,6 +307,7 @@
is sourced, and the contents of the
.Ev ENV
variable are ignored.
+This option is nonstandard.
.It Fl s Li stdin
Read commands from standard input (set automatically
if no file arguments are present).
@@ -337,6 +343,7 @@
command line editor (disables
.Fl E
if it has been set).
+Non-standard option.
.It Fl v Li verbose
The shell writes its input to standard error
as it is read.
@@ -1163,7 +1170,7 @@
.Ql } .
.Pp
Variables may be declared to be local to a function by
-using the
+using the nonstandard
.Ic local
command.
This should appear as the first statement of a function,
@@ -1942,7 +1949,7 @@
the first character of the character class.
A caret
.Pq Ql ^
-has the same effect but is non-standard.
+has the same effect but is nonstandard.
.Pp
To include a
.Ql \&]
@@ -2067,6 +2074,8 @@
List or alter key bindings for the line editor.
This command is documented in
.Xr editrc 5 .
+The behavior of this command depends on the library that is used
+to read user input, and thus can not be assumed to be standard.
.It Ic break Op Ar num
See the
.Sx Flow-Control Constructs
@@ -2076,6 +2085,7 @@
.Ar cmd .
This is useful when the user wishes to override a shell function
with the same name as a built-in command.
+This command is nonstandard.
.It Ic cd Oo Fl L | P Oc Oo Fl e Oc Op Ar directory
.It Ic cd Fl
Switch to the specified
@@ -2493,7 +2503,7 @@
command removes each specified
.Ar command
from the hash table (unless they are functions) and then locates it.
-With the
+With the nonstandard
.Fl v
option,
.Ic hash
@@ -2512,6 +2522,7 @@
See
.Sx Job Control
for a list of job ID forms.
+This command is nonstandard.
.It Ic jobs Oo Fl lps Oc Op Ar job ...
Print information about the specified jobs, or all jobs if no
.Ar job
@@ -2620,7 +2631,7 @@
option is specified, only the process IDs for the process group leaders
are printed, one per line.
.Pp
-If the
+If the nonstandard
.Fl s
option is specified, only the PIDs of the job commands are printed, one per
line.
@@ -2665,7 +2676,7 @@
.Fl t Ar timeout Oc Oo Fl er Oc Ar variable ...
The
.Ar prompt
-is printed if the
+is printed if the nonstandard
.Fl p
option is specified
and the standard input is a terminal.
@@ -2698,7 +2709,7 @@
.Va IFS ,
even if it is.
.Pp
-If the
+If the nonstandard
.Fl t
option is specified and the
.Ar timeout
@@ -2724,7 +2735,7 @@
.Ql 1h30m15s
which adds up to 5,415 seconds.
.Pp
-The
+The nonstandard
.Fl e
option exists only for backward compatibility with older scripts.
.Pp
@@ -2805,7 +2816,7 @@
.Ic setvar
command is intended to be used in functions that
assign values to variables whose names are passed as parameters.
-In general it is better to write
+This command is nonstandard, and in general it is better to write
.Dq Ar variable Ns = Ns Ar value
rather than using
.Ic setvar .
@@ -2867,7 +2878,7 @@
.Pp
Option
.Fl l
-causes the
+is nonstandard and causes the
.Ic trap
command to display a list of valid signal names.
.It Ic true
@@ -2924,6 +2935,7 @@
.Bl -tag -width indent
.It Fl b Ar sbsize
The maximum size of socket buffer usage, in bytes.
+Non-standard option.
.It Fl c Ar coredumpsize
The maximal size of core dump files, in 512-byte blocks.
Setting
@@ -2938,11 +2950,14 @@
(see
.Xr kqueue 2 )
for this user ID.
+Non-standard option.
.It Fl l Ar lockedmem
The maximal size of memory that can be locked by a process, in
kilobytes.
+Non-standard option.
.It Fl m Ar memoryuse
The maximal resident set size of a process, in kilobytes.
+Non-standard option.
.It Fl n Ar nofiles
The maximal number of descriptors that could be opened by a process.
.It Fl o Ar umtxp
@@ -2950,19 +2965,23 @@
(see
.Xr pthread 3 )
for this user ID.
+Non-standard option.
.It Fl p Ar pseudoterminals
The maximal number of pseudo-terminals for this user ID.
+Non-standard option.
.It Fl s Ar stacksize
The maximal size of the stack segment, in kilobytes.
.It Fl t Ar time
The maximal amount of CPU time to be used by each process, in seconds.
.It Fl u Ar userproc
The maximal number of simultaneous processes for this user ID.
+Non-standard option.
.It Fl v Ar virtualmem
The maximal virtual size of a process, in kilobytes.
.It Fl w Ar swapuse
The maximum amount of swap space reserved or used for this user ID,
in kilobytes.
+Non-standard option.
.El
.It Ic umask Oo Fl S Oc Op Ar mask
Set the file creation mask (see

File Metadata

Mime Type
text/plain
Expires
Sun, Apr 12, 7:19 PM (6 h, 51 m)
Storage Engine
blob
Storage Format
Raw Data
Storage Handle
28852565
Default Alt Text
D55333.id172085.diff (5 KB)

Event Timeline