sh(1): Clean up documentation of built-in commands.

Make sure all built-in commands are in the subsection named such, except
exp, let and wordexp which are deliberately undocumented. The text said only
built-ins that really need to be a built-in were documented there but in
fact almost all of them were already documented.
This commit is contained in:
Jilles Tjoelker 2010-12-03 23:24:27 +00:00
parent c1ecc6cd22
commit 25f6b31fac
Notes: svn2git 2020-12-20 02:59:44 +00:00
svn path=/head/; revision=216168

View File

@ -32,7 +32,7 @@
.\" from: @(#)sh.1 8.6 (Berkeley) 5/4/95
.\" $FreeBSD$
.\"
.Dd December 1, 2010
.Dd December 3, 2010
.Dt SH 1
.Os
.Sh NAME
@ -1593,12 +1593,7 @@ To include a
.Ql - ,
make it the first or last character listed.
.Ss Built-in Commands
This section lists the commands which
are built-in because they need to perform some operation
that cannot be performed by a separate process.
In addition to
these, built-in versions of essential utilities
are provided for efficiency.
This section lists the built-in commands.
.Bl -tag -width indent
.It Ic \&:
A null command that returns a 0 (true) exit value.
@ -1649,15 +1644,19 @@ subsection.
Continue the specified jobs
(or the current job if no jobs are given)
in the background.
.It Ic bind Oo Fl aeklrsv Oc Oo Ar key Oo Ar command Oc Oc
List or alter key bindings for the line editor.
This command is documented in
.Xr editrc 5 .
.It Ic break Op Ar num
See the
.Sx Flow-Control Constructs
subsection.
.It Ic builtin Ar cmd Op Ar arg ...
Execute the specified built-in command,
.Ar cmd .
This is useful when the user wishes to override a shell function
with the same name as a built-in command.
.It Ic bind Oo Fl aeklrsv Oc Oo Ar key Oo Ar command Oc Oc
List or alter key bindings for the line editor.
This command is documented in
.Xr editrc 5 .
.It Ic cd Oo Fl L | P Oc Op Ar directory
Switch to the specified
.Ar directory ,
@ -1759,6 +1758,10 @@ a shell keyword
or
an alias for
.Ar value .
.It Ic continue Op Ar num
See the
.Sx Flow-Control Constructs
subsection.
.It Ic echo Oo Fl e | n Oc Op Ar string ...
Print a space-separated list of the arguments to the standard output
and append a newline character.