NetBSD Problem Report #47790
From www@NetBSD.org Wed May 1 03:13:16 2013
Return-Path: <www@NetBSD.org>
Received: from mail.netbsd.org (mail.netbsd.org [149.20.53.66])
by www.NetBSD.org (Postfix) with ESMTP id 68F3D63E496
for <gnats-bugs@gnats.NetBSD.org>; Wed, 1 May 2013 03:13:16 +0000 (UTC)
Message-Id: <20130501031315.1371363E496@www.NetBSD.org>
Date: Wed, 1 May 2013 03:13:15 +0000 (UTC)
From: lists@eitanadler.com
Reply-To: lists@eitanadler.com
To: gnats-bugs@NetBSD.org
Subject: nl.1 nits
X-Send-Pr-Version: www-1.0
>Number: 47790
>Category: bin
>Synopsis: man page nits
>Confidential: no
>Severity: non-critical
>Priority: low
>Responsible: bin-bug-people
>State: closed
>Class: doc-bug
>Submitter-Id: net
>Arrival-Date: Wed May 01 03:15:00 +0000 2013
>Closed-Date: Sun Apr 13 01:52:05 +0000 2014
>Last-Modified: Sun Apr 13 01:52:05 +0000 2014
>Originator: Eitan Adler
>Release: HEAD
>Organization:
>Environment:
>Description:
the standard exit can be written nicely with ".Ex -std"
This patch changes many of them
>How-To-Repeat:
>Fix:
Index: ./tr/tr.1
===================================================================
RCS file: /cvsroot/src/usr.bin/tr/tr.1,v
retrieving revision 1.18
diff -u -r1.18 tr.1
--- ./tr/tr.1 12 Nov 2009 00:43:53 -0000 1.18
+++ ./tr/tr.1 1 May 2013 03:11:03 -0000
@@ -237,8 +237,7 @@
it's interpreted as a decimal value.
.El
.Sh EXIT STATUS
-.Nm
-exits 0 on success, and \*[Gt]0 if an error occurs.
+.Ex -std
.Sh EXAMPLES
The following examples are shown as given to the shell:
.Pp
Index: ./ctags/ctags.1
===================================================================
RCS file: /cvsroot/src/usr.bin/ctags/ctags.1,v
retrieving revision 1.16
diff -u -r1.16 ctags.1
--- ./ctags/ctags.1 14 May 2010 16:48:36 -0000 1.16
+++ ./ctags/ctags.1 1 May 2013 03:11:03 -0000
@@ -177,8 +177,7 @@
default output tags file
.El
.Sh EXIT STATUS
-.Nm
-exits with a value of 1 if an error occurred, 0 otherwise.
+.Ex -std
Duplicate objects are not considered errors.
.Sh SEE ALSO
.Xr ex 1 ,
Index: ./getconf/getconf.1
===================================================================
RCS file: /cvsroot/src/usr.bin/getconf/getconf.1,v
retrieving revision 1.12
diff -u -r1.12 getconf.1
--- ./getconf/getconf.1 9 Aug 2011 18:11:38 -0000 1.12
+++ ./getconf/getconf.1 1 May 2013 03:11:03 -0000
@@ -81,9 +81,7 @@
.Va value
.Dc .
.Sh EXIT STATUS
-The
-.Nm
-utility exits 0 on success, and \*[Gt]0 if an error occurs.
+.Ex -std
.Sh SEE ALSO
.Xr pathconf 2 ,
.Xr confstr 3 ,
Index: ./comm/comm.1
===================================================================
RCS file: /cvsroot/src/usr.bin/comm/comm.1,v
retrieving revision 1.11
diff -u -r1.11 comm.1
--- ./comm/comm.1 9 Mar 2009 19:24:32 -0000 1.11
+++ ./comm/comm.1 1 May 2013 03:11:03 -0000
@@ -89,8 +89,7 @@
.\" .It Ev LC_MESSAGES
.\" .El
.Sh EXIT STATUS
-.Nm
-exits 0 on success, \*[Gt]0 if an error occurred.
+.Ex -std
.Sh SEE ALSO
.Xr cmp 1 ,
.Xr diff 1 ,
Index: ./printf/printf.1
===================================================================
RCS file: /cvsroot/src/usr.bin/printf/printf.1,v
retrieving revision 1.24
diff -u -r1.24 printf.1
--- ./printf/printf.1 5 Apr 2010 21:24:14 -0000 1.24
+++ ./printf/printf.1 1 May 2013 03:11:03 -0000
@@ -359,8 +359,7 @@
a field; padding takes place only if the specified field width exceeds
the actual width.
.Sh EXIT STATUS
-.Nm
-exits 0 on success, 1 on failure.
+.Ex -std
.Sh SEE ALSO
.Xr echo 1 ,
.Xr printf 3 ,
Index: ./stat/stat.1
===================================================================
RCS file: /cvsroot/src/usr.bin/stat/stat.1,v
retrieving revision 1.36
diff -u -r1.36 stat.1
--- ./stat/stat.1 3 Dec 2012 07:49:21 -0000 1.36
+++ ./stat/stat.1 1 May 2013 03:11:03 -0000
@@ -477,8 +477,7 @@
which default to
.Cm S .
.Sh EXIT STATUS
-.Nm
-exits 0 on success, and \*[Gt]0 if an error occurred.
+.Ex -std
.Sh EXAMPLES
If no options are specified, the default format is
"%d %i %Sp %l %Su %Sg %r %z \e"%Sa\e" \e"%Sm\e" \e"%Sc\e" \e"%SB\e" %k %b %#Xf %N".
Index: ./cap_mkdb/cap_mkdb.1
===================================================================
RCS file: /cvsroot/src/usr.bin/cap_mkdb/cap_mkdb.1,v
retrieving revision 1.18
diff -u -r1.18 cap_mkdb.1
--- ./cap_mkdb/cap_mkdb.1 21 Apr 2012 12:27:29 -0000 1.18
+++ ./cap_mkdb/cap_mkdb.1 1 May 2013 03:11:03 -0000
@@ -104,9 +104,7 @@
pair of the first type which has the real data associated with the
name.
.Sh EXIT STATUS
-The
-.Nm
-utility exits 0 on success and \*[Gt]0 if an error occurs.
+.Ex -std
.Sh SEE ALSO
.Xr dbopen 3 ,
.Xr getcap 3 ,
Index: ./nl/nl.1
===================================================================
RCS file: /cvsroot/src/usr.bin/nl/nl.1,v
retrieving revision 1.12
diff -u -r1.12 nl.1
--- ./nl/nl.1 8 Apr 2012 22:00:39 -0000 1.12
+++ ./nl/nl.1 1 May 2013 03:11:03 -0000
@@ -70,7 +70,6 @@
.Pp
The starts of logical page sections are signaled by input lines containing
nothing but one of the following sequences of delimiter characters:
-.Pp
.Bd -unfilled -offset indent
.Bl -column "\e:\e:\e: " "header "
.It Em "Line" "Start of"
@@ -196,9 +195,7 @@
is 6.
.El
.Sh EXIT STATUS
-The
-.Nm
-utility exits 0 on success, and \*[Gt]0 if an error occurs.
+.Ex -std
.Sh SEE ALSO
.Xr pr 1
.Sh STANDARDS
Index: ./pmap/pmap.1
===================================================================
RCS file: /cvsroot/src/usr.bin/pmap/pmap.1,v
retrieving revision 1.17
diff -u -r1.17 pmap.1
--- ./pmap/pmap.1 14 May 2010 17:31:26 -0000 1.17
+++ ./pmap/pmap.1 1 May 2013 03:11:03 -0000
@@ -202,8 +202,7 @@
.Fl p
and place the extra PID at the end of the command line.
.Sh EXIT STATUS
-.Nm
-exits 0 on success, and \*[Gt]0 if an error occurred.
+.Ex -std
.Sh EXAMPLES
While the meaning of most of the output is self-evident, some pieces of
it may appear to be a little inscrutable.
Index: ./asa/asa.1
===================================================================
RCS file: /cvsroot/src/usr.bin/asa/asa.1,v
retrieving revision 1.11
diff -u -r1.11 asa.1
--- ./asa/asa.1 8 Feb 2002 01:36:18 -0000 1.11
+++ ./asa/asa.1 1 May 2013 03:11:03 -0000
@@ -62,9 +62,7 @@
Lines beginning with characters other than the above are treated as if they
begin with \*[Lt]space\*[Gt].
.Sh EXIT STATUS
-The
-.Nm
-utility exit 0 on success, and \*[Gt]0 if an error occurs.
+.Ex -std
.Sh EXAMPLES
To view a file containing the output of a
.Tn FORTRAN
Index: ./progress/progress.1
===================================================================
RCS file: /cvsroot/src/usr.bin/progress/progress.1,v
retrieving revision 1.14
diff -u -r1.14 progress.1
--- ./progress/progress.1 30 Apr 2008 13:11:01 -0000 1.14
+++ ./progress/progress.1 1 May 2013 03:11:03 -0000
@@ -94,8 +94,7 @@
.Ic gzip -l .
.El
.Sh EXIT STATUS
-.Nm
-exits 0 on success.
+.Ex -std
.Sh EXAMPLES
The command
.Dl progress -zf file.tar.gz tar xf -
>Release-Note:
>Audit-Trail:
From: "Soren Jacobsen" <snj@netbsd.org>
To: gnats-bugs@gnats.NetBSD.org
Cc:
Subject: PR/47790 CVS commit: src/usr.bin
Date: Sun, 13 Apr 2014 01:45:35 +0000
Module Name: src
Committed By: snj
Date: Sun Apr 13 01:45:34 UTC 2014
Modified Files:
src/usr.bin/asa: asa.1
src/usr.bin/cap_mkdb: cap_mkdb.1
src/usr.bin/comm: comm.1
src/usr.bin/ctags: ctags.1
src/usr.bin/getconf: getconf.1
src/usr.bin/pmap: pmap.1
src/usr.bin/printf: printf.1
src/usr.bin/progress: progress.1
src/usr.bin/stat: stat.1
Log Message:
Change some standard exit status text to ".Ex -std"
From Eitan Adler in PR bin/47790.
To generate a diff of this commit:
cvs rdiff -u -r1.11 -r1.12 src/usr.bin/asa/asa.1
cvs rdiff -u -r1.18 -r1.19 src/usr.bin/cap_mkdb/cap_mkdb.1
cvs rdiff -u -r1.11 -r1.12 src/usr.bin/comm/comm.1
cvs rdiff -u -r1.16 -r1.17 src/usr.bin/ctags/ctags.1
cvs rdiff -u -r1.12 -r1.13 src/usr.bin/getconf/getconf.1
cvs rdiff -u -r1.17 -r1.18 src/usr.bin/pmap/pmap.1
cvs rdiff -u -r1.24 -r1.25 src/usr.bin/printf/printf.1
cvs rdiff -u -r1.14 -r1.15 src/usr.bin/progress/progress.1
cvs rdiff -u -r1.36 -r1.37 src/usr.bin/stat/stat.1
Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.
State-Changed-From-To: open->closed
State-Changed-By: snj@NetBSD.org
State-Changed-When: Sun, 13 Apr 2014 01:52:05 +0000
State-Changed-Why:
Applied. Thanks!
>Unformatted:
(Contact us)
$NetBSD: query-full-pr,v 1.39 2013/11/01 18:47:49 spz Exp $
$NetBSD: gnats_config.sh,v 1.8 2006/05/07 09:23:38 tsutsui Exp $
Copyright © 1994-2007
The NetBSD Foundation, Inc. ALL RIGHTS RESERVED.