Add EXIT STATUS messages in some manual pages.
authorSascha Wildner <saw@online.de>
Wed, 10 Apr 2013 17:10:53 +0000 (19:10 +0200)
committerSascha Wildner <saw@online.de>
Wed, 10 Apr 2013 17:10:53 +0000 (19:10 +0200)
bin/expr/expr.1
usr.bin/cmp/cmp.1
usr.bin/mesg/mesg.1
usr.bin/nohup/nohup.1
usr.bin/patch/patch.1

index 17e77bb..d1035f5 100644 (file)
@@ -29,9 +29,8 @@
 .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 .\"
 .\" $FreeBSD: src/bin/expr/expr.1,v 1.9.2.4 2003/05/16 22:55:19 keramida Exp $
-.\" $DragonFly: src/bin/expr/expr.1,v 1.2 2003/06/17 04:22:50 dillon Exp $
 .\"
-.Dd May 10, 2002
+.Dd April 10, 2013
 .Dt EXPR 1
 .Os
 .Sh NAME
@@ -103,6 +102,18 @@ otherwise 0.
 .El
 .Pp
 Parentheses are used for grouping in the usual manner.
+.Sh EXIT STATUS
+The
+.Nm
+utility exits with one of the following values:
+.Bl -tag -width indent -compact
+.It 0
+the expression is neither an empty string nor 0.
+.It 1
+the expression is an empty string or 0.
+.It 2
+the expression is invalid.
+.El
 .Sh EXAMPLES
 .Bl -enum
 .It
@@ -117,18 +128,6 @@ division operator.
 The following example returns the number of characters in variable a.
 .Dl expr $a Li : '.*'
 .El
-.Sh DIAGNOSTICS
-The
-.Nm
-utility exits with one of the following values:
-.Bl -tag -width indent -compact
-.It 0
-the expression is neither an empty string nor 0.
-.It 1
-the expression is an empty string or 0.
-.It 2
-the expression is invalid.
-.El
 .Sh SEE ALSO
 .Xr sh 1 ,
 .Xr test 1
index 603938d..772fd2e 100644 (file)
@@ -34,9 +34,8 @@
 .\"
 .\"     @(#)cmp.1      8.1 (Berkeley) 6/6/93
 .\" $FreeBSD: src/usr.bin/cmp/cmp.1,v 1.7.2.5 2003/02/24 22:37:41 trhodes Exp $
-.\" $DragonFly: src/usr.bin/cmp/cmp.1,v 1.2 2003/06/17 04:29:25 dillon Exp $
 .\"
-.Dd July 23, 2009
+.Dd April 10, 2013
 .Dt CMP 1
 .Os
 .Sh NAME
@@ -89,7 +88,7 @@ and
 respectively, where the comparison will begin.
 The offset is decimal by default, but may be expressed as a hexadecimal
 or octal value by preceding it with a leading ``0x'' or ``0''.
-.Pp
+.Sh EXIT STATUS
 The
 .Nm
 utility exits with one of the following values:
index 18a363e..7a51469 100644 (file)
@@ -31,9 +31,8 @@
 .\"
 .\"    @(#)mesg.1      8.1 (Berkeley) 6/6/93
 .\" $FreeBSD: src/usr.bin/mesg/mesg.1,v 1.7.2.1 2001/12/14 15:53:30 ru Exp $
-.\" $DragonFly: src/usr.bin/mesg/mesg.1,v 1.4 2008/05/01 22:06:06 swildner Exp $
 .\"
-.Dd March 4, 2005
+.Dd April 10, 2013
 .Dt MESG 1
 .Os
 .Sh NAME
@@ -67,17 +66,7 @@ Permits messages to be displayed.
 If no arguments are given,
 .Nm
 displays the present message status to the standard output.
-.Sh EXAMPLES
-Disallow messages from other users to the current terminal:
-.Pp
-.Dl "mesg n"
-.Pp
-Allow messages from other users to
-.Pa ttyp1
-(assuming you are also logged in on that terminal):
-.Pp
-.Dl "mesg y </dev/ttyp1"
-.Sh DIAGNOSTICS
+.Sh EXIT STATUS
 The
 .Nm
 utility exits with one of the following values:
@@ -90,6 +79,16 @@ Messages are not allowed.
 .It Li ">1"
 An error has occurred.
 .El
+.Sh EXAMPLES
+Disallow messages from other users to the current terminal:
+.Pp
+.Dl "mesg n"
+.Pp
+Allow messages from other users to
+.Pa ttyp1
+(assuming you are also logged in on that terminal):
+.Pp
+.Dl "mesg y </dev/ttyp1"
 .Sh COMPATIBILITY
 Previous versions of the
 .Nm
index 70233b4..db808bb 100644 (file)
@@ -34,9 +34,8 @@
 .\"
 .\"    @(#)nohup.1     8.1 (Berkeley) 6/6/93
 .\" $FreeBSD: src/usr.bin/nohup/nohup.1,v 1.6.2.4 2001/08/16 13:16:59 ru Exp $
-.\" $DragonFly: src/usr.bin/nohup/nohup.1,v 1.2 2003/06/17 04:29:30 dillon Exp $
 .\"
-.Dd July 19, 2001
+.Dd April 10, 2013
 .Dt NOHUP 1
 .Os
 .Sh NAME
@@ -83,7 +82,7 @@ utility uses the directory named by
 .Ev HOME
 to create the file.
 .El
-.Sh DIAGNOSTICS
+.Sh EXIT STATUS
 The
 .Nm
 utility exits with one of the following values:
index df28e75..af2d325 100644 (file)
@@ -1,5 +1,4 @@
 .\"    $OpenBSD: patch.1,v 1.22 2008/06/06 20:44:00 jmc Exp $
-.\"    $DragonFly: src/usr.bin/patch/patch.1,v 1.10 2008/08/18 19:15:55 joerg Exp $
 .\" Copyright 1986, Larry Wall
 .\"
 .\" Redistribution and use in source and binary forms, with or without
@@ -20,7 +19,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.Dd August 18, 2008
+.Dd April 10, 2013
 .Dt PATCH 1
 .Os
 .Sh NAME
@@ -604,18 +603,7 @@ used to read input when
 .Nm
 prompts the user
 .El
-.Sh DIAGNOSTICS
-Too many to list here, but generally indicative that
-.Nm
-couldn't parse your patch file.
-.Pp
-The message
-.Qq Hmm...
-indicates that there is unprocessed text in the patch file and that
-.Nm
-is attempting to intuit whether there is a patch in that text and, if so,
-what kind of patch it is.
-.Pp
+.Sh EXIT STATUS
 The
 .Nm
 utility exits with one of the following values:
@@ -631,6 +619,17 @@ An error occurred.
 .Pp
 When applying a set of patches in a loop it behooves you to check this
 exit status so you don't apply a later patch to a partially patched file.
+.Sh DIAGNOSTICS
+Too many to list here, but generally indicative that
+.Nm
+couldn't parse your patch file.
+.Pp
+The message
+.Qq Hmm...
+indicates that there is unprocessed text in the patch file and that
+.Nm
+is attempting to intuit whether there is a patch in that text and, if so,
+what kind of patch it is.
 .Sh SEE ALSO
 .Xr diff 1
 .Sh STANDARDS