document, consistently, those apps which also exist as built-ins

on certain shells; do not try to document changes between the
implementations, but at least warn of their existence;

diff from Ingo Schwarze

11 files changed, 86 insertions, 73 deletions

diff --git a/bin/echo/echo.1 b/bin/echo/echo.1
index a6d796e2b63..0f9ee059215 100644
--- a/bin/echo/echo.1
+++ b/bin/echo/echo.1
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: echo.1,v 1.16 2009/01/04 11:19:55 sobrado Exp $
+.\"	$OpenBSD: echo.1,v 1.17 2009/01/06 23:29:02 jmc Exp $
 .\"	$NetBSD: echo.1,v 1.7 1995/03/21 09:04:26 cgd Exp $
 .\"
 .\" Copyright (c) 1990, 1993
@@ -33,7 +33,7 @@
 .\"
 .\"	@(#)echo.1	8.1 (Berkeley) 7/22/93
 .\"
-.Dd $Mdocdate: January 4 2009 $
+.Dd $Mdocdate: January 6 2009 $
 .Dt ECHO 1
 .Os
 .Sh NAME
@@ -60,8 +60,17 @@ The options are as follows:
 Do not print the trailing newline character.
 .El
 .Pp
+.Nm
+also exists as a built-in to
+.Xr csh 1
+and
+.Xr ksh 1 ,
+though with a different syntax.
+.Pp
 .Ex -std echo
 .Sh SEE ALSO
+.Xr csh 1 ,
+.Xr ksh 1 ,
 .Xr printf 1
 .Sh STANDARDS
 The
diff --git a/bin/kill/kill.1 b/bin/kill/kill.1
index 93d7b74d46a..71e3fc41882 100644
--- a/bin/kill/kill.1
+++ b/bin/kill/kill.1
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: kill.1,v 1.31 2007/11/01 16:09:31 jmc Exp $
+.\"	$OpenBSD: kill.1,v 1.32 2009/01/06 23:29:03 jmc Exp $
 .\"	$NetBSD: kill.1,v 1.8 1995/09/07 06:30:26 jtc Exp $
 .\"
 .\" Copyright (c) 1980, 1990, 1993
@@ -33,7 +33,7 @@
 .\"
 .\"	@(#)kill.1	8.2 (Berkeley) 4/28/95
 .\"
-.Dd $Mdocdate: November 1 2007 $
+.Dd $Mdocdate: January 6 2009 $
 .Dt KILL 1
 .Os
 .Sh NAME
@@ -131,15 +131,12 @@ A signal number of 0
 checks the validity of a certain PID, to see if it exists.
 An exit code of 0 means that the specified process exists.
 .Pp
-The
-.Nm
-utility exists as a built-in to most shells;
-they allow job specifiers of the form
-.Dq %...
-as arguments,
-so process IDs are not as often used as
 .Nm
-arguments.
+also exists as a built-in to
+.Xr csh 1
+and
+.Xr ksh 1 ,
+though with a different syntax.
 .Sh EXAMPLES
 Forcibly terminate process ID 1234:
 .Pp
@@ -153,9 +150,9 @@ daemon the hangup signal, instructing it to re-read its configuration from
 .Dl # kill -HUP `cat /var/run/inetd.pid`
 .Sh SEE ALSO
 .Xr csh 1 ,
+.Xr ksh 1 ,
 .Xr pkill 1 ,
 .Xr ps 1 ,
-.Xr sh 1 ,
 .Xr kill 2 ,
 .Xr sigaction 2
 .Sh STANDARDS
diff --git a/bin/pwd/pwd.1 b/bin/pwd/pwd.1
index 40252868d5e..a8bb142590f 100644
--- a/bin/pwd/pwd.1
+++ b/bin/pwd/pwd.1
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: pwd.1,v 1.15 2009/01/04 11:19:55 sobrado Exp $
+.\"	$OpenBSD: pwd.1,v 1.16 2009/01/06 23:29:03 jmc Exp $
 .\"	$NetBSD: pwd.1,v 1.10 1995/09/07 06:47:30 jtc Exp $
 .\"
 .\" Copyright (c) 1990, 1993
@@ -33,7 +33,7 @@
 .\"
 .\"     @(#)pwd.1	8.2 (Berkeley) 4/28/95
 .\"
-.Dd $Mdocdate: January 4 2009 $
+.Dd $Mdocdate: January 6 2009 $
 .Dt PWD 1
 .Os
 .Sh NAME
@@ -46,21 +46,18 @@ The
 .Nm
 utility prints the absolute pathname of the current working directory to
 the standard output.
-Both the Bourne shell
-.Pq Xr sh 1
-and Korn shell
-.Pq Xr ksh 1
-have their own built-in version of
-.Nm pwd .
 For an explanation of the directory hierarchy,
 see
 .Xr hier 7 .
 .Pp
+.Nm
+also exists as a built-in to
+.Xr ksh 1 ,
+though with a different syntax.
+.Pp
 .Ex -std pwd
 .Sh SEE ALSO
-.Xr csh 1 ,
 .Xr ksh 1 ,
-.Xr sh 1 ,
 .Xr getcwd 3 ,
 .Xr hier 7
 .Sh STANDARDS
diff --git a/bin/test/test.1 b/bin/test/test.1
index f18f5cf0559..1429e155ec1 100644
--- a/bin/test/test.1
+++ b/bin/test/test.1
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: test.1,v 1.22 2007/05/31 19:19:15 jmc Exp $
+.\"	$OpenBSD: test.1,v 1.23 2009/01/06 23:29:03 jmc Exp $
 .\"	$NetBSD: test.1,v 1.6 1995/03/21 07:04:03 cgd Exp $
 .\"
 .\" Copyright (c) 1991, 1993
@@ -33,7 +33,7 @@
 .\"
 .\"     @(#)test.1	8.1 (Berkeley) 5/31/93
 .\"
-.Dd $Mdocdate: May 31 2007 $
+.Dd $Mdocdate: January 6 2009 $
 .Dt TEST 1
 .Os
 .Sh NAME
@@ -293,6 +293,11 @@ Symbolic links are followed for all primaries except
 .Fl h
 and
 .Fl L .
+.Pp
+.Nm
+also exists as a built-in to
+.Xr ksh 1 ,
+though with a different syntax.
 .Sh GRAMMAR AMBIGUITY
 The
 .Nm
@@ -318,6 +323,8 @@ missing.
 .It \*(Gt1
 An error occurred.
 .El
+.Sh SEE ALSO
+.Xr ksh 1
 .Sh STANDARDS
 The
 .Nm
diff --git a/sbin/mknod/mknod.8 b/sbin/mknod/mknod.8
index 0c0ed0292f2..d7b92884bb5 100644
--- a/sbin/mknod/mknod.8
+++ b/sbin/mknod/mknod.8
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: mknod.8,v 1.14 2008/04/17 13:44:27 jmc Exp $
+.\"	$OpenBSD: mknod.8,v 1.15 2009/01/06 23:29:03 jmc Exp $
 .\"	$NetBSD: mknod.8,v 1.9 1995/08/10 23:47:32 jtc Exp $
 .\"
 .\" Copyright (c) 1980, 1991, 1993
@@ -30,7 +30,7 @@
 .\"
 .\"     @(#)mknod.8	8.2 (Berkeley) 12/11/93
 .\"
-.Dd $Mdocdate: April 17 2008 $
+.Dd $Mdocdate: January 6 2009 $
 .Dt MKNOD 8
 .Os
 .Sh NAME
@@ -115,8 +115,13 @@ indicates a hexadecimal number, and a leading
 .Dq 0
 will cause the number to be interpreted as octal.
 .El
+.Pp
+.Nm
+also exists as a built-in to
+.Xr ksh 1 .
 .Sh SEE ALSO
 .Xr chmod 1 ,
+.Xr ksh 1 ,
 .Xr mkfifo 1 ,
 .Xr mkfifo 2 ,
 .Xr mknod 2 ,
diff --git a/usr.bin/false/false.1 b/usr.bin/false/false.1
index 9df74308ba1..5c19728eefc 100644
--- a/usr.bin/false/false.1
+++ b/usr.bin/false/false.1
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: false.1,v 1.7 2007/05/31 19:20:09 jmc Exp $
+.\"	$OpenBSD: false.1,v 1.8 2009/01/06 23:29:03 jmc Exp $
 .\" Copyright (c) 1983, 1990 The Regents of the University of California.
 .\" All rights reserved.
 .\"
@@ -31,7 +31,7 @@
 .\"
 .\"	from: @(#)false.1	6.6 (Berkeley) 7/24/91
 .\"
-.Dd $Mdocdate: May 31 2007 $
+.Dd $Mdocdate: January 6 2009 $
 .Dt FALSE 1
 .Os
 .Sh NAME
@@ -43,9 +43,12 @@
 The
 .Nm
 utility always exits with a non-zero exit code.
+.Pp
+.Nm
+also exists as a built-in to
+.Xr ksh 1 .
 .Sh SEE ALSO
-.Xr csh 1 ,
-.Xr sh 1 ,
+.Xr ksh 1 ,
 .Xr true 1
 .Sh STANDARDS
 The
diff --git a/usr.bin/nice/nice.1 b/usr.bin/nice/nice.1
index 60805f02ff6..09782c30798 100644
--- a/usr.bin/nice/nice.1
+++ b/usr.bin/nice/nice.1
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: nice.1,v 1.15 2007/07/27 13:27:46 jmc Exp $
+.\"	$OpenBSD: nice.1,v 1.16 2009/01/06 23:29:03 jmc Exp $
 .\"	$NetBSD: nice.1,v 1.6 1995/08/31 23:30:57 jtc Exp $
 .\"
 .\" Copyright (c) 1980, 1990, 1993
@@ -30,7 +30,7 @@
 .\"
 .\"	@(#)nice.1	8.1 (Berkeley) 6/6/93
 .\"
-.Dd $Mdocdate: July 27 2007 $
+.Dd $Mdocdate: January 6 2009 $
 .Dt NICE 1
 .Os
 .Sh NAME
@@ -64,6 +64,11 @@ priority of
 .Ar utility .
 .El
 .Pp
+.Nm
+also exists as a built-in to
+.Xr csh 1 ,
+though with a different syntax.
+.Pp
 The
 .Nm
 utility shall exit with one of the following values:
@@ -104,14 +109,3 @@ A
 .Nm
 utility appeared in
 .At v6 .
-.Sh BUGS
-.Nm
-is built into
-.Xr csh 1
-with a slightly different syntax than described here.
-The form
-.Ql nice +10
-nices to positive nice, and
-.Ql nice \-10
-can be used
-by the superuser to give a process more of the processor.
diff --git a/usr.bin/nohup/nohup.1 b/usr.bin/nohup/nohup.1
index 1f937ff36ff..5d3d1a864b6 100644
--- a/usr.bin/nohup/nohup.1
+++ b/usr.bin/nohup/nohup.1
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: nohup.1,v 1.12 2007/05/31 19:20:14 jmc Exp $
+.\"	$OpenBSD: nohup.1,v 1.13 2009/01/06 23:29:03 jmc Exp $
 .\"	$NetBSD: nohup.1,v 1.5 1995/08/31 23:35:24 jtc Exp $
 .\"
 .\" Copyright (c) 1989, 1990, 1993
@@ -33,7 +33,7 @@
 .\"
 .\"	@(#)nohup.1	8.1 (Berkeley) 6/6/93
 .\"
-.Dd $Mdocdate: May 31 2007 $
+.Dd $Mdocdate: January 6 2009 $
 .Dt NOHUP 1
 .Os
 .Sh NAME
@@ -81,6 +81,11 @@ will exit without invoking
 .Ar utility ,
 with an exit value as described below.
 .Pp
+.Nm
+also exists as a built-in to
+.Xr csh 1 ,
+though with a different syntax.
+.Pp
 The
 .Nm nohup
 command shall exit with one of the following values:
@@ -107,6 +112,7 @@ shall be that of
 User's home directory.
 .El
 .Sh SEE ALSO
+.Xr csh 1 ,
 .Xr signal 3
 .Sh STANDARDS
 The
diff --git a/usr.bin/time/time.1 b/usr.bin/time/time.1
index afd8dca6008..59ae2eca816 100644
--- a/usr.bin/time/time.1
+++ b/usr.bin/time/time.1
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: time.1,v 1.15 2007/05/31 19:20:17 jmc Exp $
+.\"	$OpenBSD: time.1,v 1.16 2009/01/06 23:29:03 jmc Exp $
 .\"	$NetBSD: time.1,v 1.5 1994/12/08 09:36:57 jtc Exp $
 .\"
 .\" Copyright (c) 1980, 1991, 1993
@@ -30,7 +30,7 @@
 .\"
 .\"     @(#)time.1	8.1 (Berkeley) 6/6/93
 .\"
-.Dd $Mdocdate: May 31 2007 $
+.Dd $Mdocdate: January 6 2009 $
 .Dt TIME 1
 .Os
 .Sh NAME
@@ -67,12 +67,12 @@ The output is formatted as specified by
 .St -p1003.2-92 .
 .El
 .Pp
-The
 .Nm
-utility exists as a built-in to most shells,
-although they may be syntactically different.
-The utility described here is available as
-.Pa /usr/bin/time .
+also exists as a built-in to
+.Xr csh 1
+and
+.Xr ksh 1 ,
+though with a different syntax.
 .Pp
 The
 .Nm
@@ -103,7 +103,7 @@ shall be that of
 .El
 .Sh SEE ALSO
 .Xr csh 1 ,
-.Xr sh 1 ,
+.Xr ksh 1 ,
 .Xr getrusage 2
 .Sh STANDARDS
 The
diff --git a/usr.bin/true/true.1 b/usr.bin/true/true.1
index ba2b68f60b5..7145392904e 100644
--- a/usr.bin/true/true.1
+++ b/usr.bin/true/true.1
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: true.1,v 1.8 2007/05/31 19:20:18 jmc Exp $
+.\"	$OpenBSD: true.1,v 1.9 2009/01/06 23:29:03 jmc Exp $
 .\"
 .\" Copyright (c) 1983, 1985, 1990 The Regents of the University of California.
 .\" All rights reserved.
@@ -32,7 +32,7 @@
 .\"
 .\"     from: @(#)true.1	6.4 (Berkeley) 6/27/91
 .\"
-.Dd $Mdocdate: May 31 2007 $
+.Dd $Mdocdate: January 6 2009 $
 .Dt TRUE 1
 .Os
 .Sh NAME
@@ -44,10 +44,13 @@
 The
 .Nm
 utility always returns with exit code 0.
+.Pp
+.Nm
+also exists as a built-in to
+.Xr ksh 1 .
 .Sh SEE ALSO
-.Xr csh 1 ,
 .Xr false 1 ,
-.Xr sh 1
+.Xr ksh 1
 .Sh STANDARDS
 The
 .Nm
diff --git a/usr.bin/which/which.1 b/usr.bin/which/which.1
index fb92b85b859..4598a3cdd3b 100644
--- a/usr.bin/which/which.1
+++ b/usr.bin/which/which.1
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: which.1,v 1.16 2007/08/14 17:41:10 sobrado Exp $
+.\"	$OpenBSD: which.1,v 1.17 2009/01/06 23:29:03 jmc Exp $
 .\"
 .\" Copyright (c) 1980, 1991 Regents of the University of California.
 .\" All rights reserved.
@@ -29,7 +29,7 @@
 .\"
 .\"     from: @(#)which.1	6.3 (Berkeley) 4/23/91
 .\"
-.Dd $Mdocdate: August 14 2007 $
+.Dd $Mdocdate: January 6 2009 $
 .Dt WHICH 1
 .Os
 .Sh NAME
@@ -51,6 +51,11 @@ flag is given,
 .Nm
 will return a list of all matches instead of just the first match.
 .Pp
+.Nm
+also exists as a built-in to
+.Xr csh 1 ,
+though with a different syntax.
+.Pp
 The
 .Nm
 utility exits with one of the following values:
@@ -85,7 +90,6 @@ name was not found in the path.
 .Xr csh 1 ,
 .Xr find 1 ,
 .Xr locate 1 ,
-.Xr sh 1 ,
 .Xr whereis 1 ,
 .Xr environ 7
 .Sh HISTORY
@@ -93,15 +97,3 @@ A
 .Nm
 command appeared in
 .Bx 3.0 .
-.Sh CAVEATS
-The
-.Nm
-command formerly was a
-.Xr csh 1
-script and could expand aliases.
-.Xr csh 1
-now has a built-in
-.Nm
-command so this version is intended for use
-with other shells like
-.Xr sh 1 .