Improve shell documentation:

* Consistently misspell built-in as builtin.

* Add a builtin(1) manpage and create builtin(1) MLINKS for all shell
  builtin commands for which no standalone utility exists.  These MLINKS
  replace those that were created for csh(1).

* Add appropriate xrefs for builtin(1) to the csh(1) and sh(1) manpages,
  as well as to the manpages of standalone utilities which are supported
  as shell builtin commands in at least one of the shells. In such
  manpages, explain that similar functionality may be provided as a
  shell builtin command.

* Improve sh(1)'s description of the cd builtin command. Csh(1) already
  describes it adequately. Replace the cd(1) manpage with a builtin(1)
  MLINKS link.

* Clean up some mdoc problems: use Xr instead of literal "foo(n)"; use
  Ic instead of Xr for shell builtin commands.

* Undo English contractions.

Reviewed by:	mpp, rgrimes

1 files changed, 7 insertions, 6 deletions

diff --git a/usr.bin/login/login.1 b/usr.bin/login/login.1
index 2ee22ef..3d1a9c7 100644
--- a/usr.bin/login/login.1
+++ b/usr.bin/login/login.1
@@ -143,13 +143,12 @@ The login class also controls the maximum and current process resource
 limits granted to a login, process priorities and many other aspects of
 a user's login environment.
 .Pp
-The standard shells,
-.Xr csh 1
-and
-.Xr sh 1 ,
-do not fork before executing the
+Some shells may provide a builtin
 .Nm
-utility.
+command which is similar or identical to this utility. Consult
+the
+.Xr builtin 1
+manual page.
 .Sh FILES
 .Bl -tag -width /var/mail/userXXX -compact
 .It Pa /etc/fbtab
@@ -180,7 +179,9 @@ makes login quieter
 configure authentication services
 .El
 .Sh SEE ALSO
+.Xr builtin 1 ,
 .Xr chpass 1 ,
+.Xr csh 1 ,
 .Xr passwd 1 ,
 .Xr rlogin 1 ,
 .Xr skey 1 ,