svn commit: r216168 - head/bin/sh

[Jilles Tjoelker]

Author: jilles
Date: Fri Dec  3 23:24:27 2010
New Revision: 216168
URL: http://svn.freebsd.org/changeset/base/216168

Log:
  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.

Modified:
  head/bin/sh/sh.1

Modified: head/bin/sh/sh.1
==============================================================================
--- head/bin/sh/sh.1	Fri Dec  3 23:07:45 2010	(r216167)
+++ head/bin/sh/sh.1	Fri Dec  3 23:24:27 2010	(r216168)
@@ -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.