document exit values; from daniel dickman
authorjmc <jmc@openbsd.org>
Wed, 21 Jul 2010 20:02:29 +0000 (20:02 +0000)
committerjmc <jmc@openbsd.org>
Wed, 21 Jul 2010 20:02:29 +0000 (20:02 +0000)
usr.bin/ar/ar.1
usr.bin/at/at.1
usr.bin/du/du.1
usr.bin/tsort/tsort.1
usr.bin/who/who.1

index a3a9a88..2396ae9 100644 (file)
@@ -1,4 +1,4 @@
-.\"    $OpenBSD: ar.1,v 1.16 2009/08/16 09:41:08 sobrado Exp $
+.\"    $OpenBSD: ar.1,v 1.17 2010/07/21 20:02:29 jmc Exp $
 .\"    $NetBSD: ar.1,v 1.7 1995/08/18 15:05:11 pk Exp $
 .\"
 .\" Copyright (c) 1990, 1993
@@ -33,7 +33,7 @@
 .\"
 .\"    @(#)ar.1        8.1 (Berkeley) 6/29/93
 .\"
-.Dd $Mdocdate: August 16 2009 $
+.Dd $Mdocdate: July 21 2010 $
 .Dt AR 1
 .Os
 .Sh NAME
@@ -297,9 +297,7 @@ into the archive; this will fail if the user is not the owner of the
 extracted file or the superuser.
 .El
 .Pp
-The
-.Nm
-utility exits 0 on success or >0 if an error occurred.
+.Ex -std ar
 .Sh ENVIRONMENT
 .Bl -tag -width indent -compact
 .It Ev TMPDIR
index d596037..30bce22 100644 (file)
@@ -1,4 +1,4 @@
-.\" $OpenBSD: at.1,v 1.40 2010/07/02 23:40:09 krw Exp $
+.\" $OpenBSD: at.1,v 1.41 2010/07/21 20:02:29 jmc Exp $
 .\"
 .\" Copyright (C) 1993, 1994  Thomas Koenig
 .\" Copyright (C) 1993  David Parsons
@@ -24,7 +24,7 @@
 .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
 .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd $Mdocdate: July 2 2010 $
+.Dd $Mdocdate: July 21 2010 $
 .Dt AT 1
 .Os
 .Sh NAME
@@ -297,6 +297,17 @@ An empty
 .Pa /var/cron/at.deny
 means that every user is allowed to use these commands.
 This is the default configuration.
+.Pp
+The
+.Nm
+utility exits with one of the following values:
+.Pp
+.Bl -tag -width Ds -compact -offset indent
+.It 0
+Jobs were successfully submitted, removed, or listed.
+.It \*(Gt0
+An error occurred.
+.El
 .Sh FILES
 .Bl -tag -width /var/cron/at.allow -compact
 .It Pa /var/cron/atjobs
index 4c03ab8..4007c63 100644 (file)
@@ -1,4 +1,4 @@
-.\"    $OpenBSD: du.1,v 1.26 2009/08/16 09:41:08 sobrado Exp $
+.\"    $OpenBSD: du.1,v 1.27 2010/07/21 20:02:29 jmc Exp $
 .\"    $NetBSD: du.1,v 1.6 1996/10/18 07:20:31 thorpej Exp $
 .\"
 .\" Copyright (c) 1990, 1993
@@ -30,7 +30,7 @@
 .\"
 .\"    @(#)du.1        8.2 (Berkeley) 4/1/94
 .\"
-.Dd $Mdocdate: August 16 2009 $
+.Dd $Mdocdate: July 21 2010 $
 .Dt DU 1
 .Os
 .Sh NAME
@@ -121,6 +121,8 @@ Files having multiple hard links are counted (and displayed) a single
 time per
 .Nm
 execution.
+.Pp
+.Ex -std du
 .Sh ENVIRONMENT
 .Bl -tag -width BLOCKSIZE
 .It Ev BLOCKSIZE
index 0845122..cfe8770 100644 (file)
@@ -1,4 +1,4 @@
-.\"    $OpenBSD: tsort.1,v 1.20 2009/02/08 17:33:02 jmc Exp $
+.\"    $OpenBSD: tsort.1,v 1.21 2010/07/21 20:02:29 jmc Exp $
 .\"    $NetBSD: tsort.1,v 1.6 1996/01/17 20:37:49 mycroft Exp $
 .\"
 .\" Copyright (c) 1990, 1993, 1994
@@ -33,7 +33,7 @@
 .\"
 .\"     @(#)tsort.1    8.3 (Berkeley) 4/1/94
 .\"
-.Dd $Mdocdate: February 8 2009 $
+.Dd $Mdocdate: July 21 2010 $
 .Dt TSORT 1
 .Os
 .Sh NAME
@@ -95,6 +95,8 @@ Exit with exit code the number of cycles
 .Nm
 had to break.
 .El
+.Pp
+.Ex -std tsort
 .Sh EXAMPLES
 Faced with the input:
 .Bd -literal -offset indent
index 6047053..d4f42f1 100644 (file)
@@ -1,4 +1,4 @@
-.\"    $OpenBSD: who.1,v 1.22 2009/02/08 17:15:10 jmc Exp $
+.\"    $OpenBSD: who.1,v 1.23 2010/07/21 20:02:29 jmc Exp $
 .\"    $NetBSD: who.1,v 1.5 1994/12/07 04:28:47 jtc Exp $
 .\"
 .\" Copyright (c) 1986, 1991, 1993
@@ -30,7 +30,7 @@
 .\"
 .\"     @(#)who.1      8.2 (Berkeley) 12/30/93
 .\"
-.Dd $Mdocdate: February 8 2009 $
+.Dd $Mdocdate: July 21 2010 $
 .Dt WHO 1
 .Os
 .Sh NAME
@@ -115,6 +115,8 @@ and
 Logouts produce an output line without any user name.
 For more information on the special characters, see
 .Xr utmp 5 .
+.Pp
+.Ex -std who
 .Sh FILES
 .Bl -tag -width /var/log/wtmp.[0-6] -compact
 .It Pa /var/run/utmp