docs/84620: [patch] xargs(1) manpage has "utility" and "command" inconsistency

Gary W. Swearingen garys at opusnet.com
Sat Aug 6 16:00:38 UTC 2005


>Number:         84620
>Category:       docs
>Synopsis:       [patch] xargs(1) manpage has "utility" and "command" inconsistency
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Sat Aug 06 16:00:35 GMT 2005
>Closed-Date:
>Last-Modified:
>Originator:     Gary W. Swearingen
>Release:        FreeBSD 5.4-RELEASE i386
>Organization:
none
>Environment:
n/a
>Description:

If the "xargs" program must be called a "utility" (see PR 47170),
then the manpage should be careful to always distinguish its
references to the "xargs" argument "utility".  It has two wrong.

The manpage also refers to the "xargs" program as a "command".

>How-To-Repeat:
n/a

>Fix:

--- xargs..orig.1	Thu Aug  4 14:08:01 2005
+++ xargs.1	Thu Aug  4 14:10:40 2005
@@ -74,7 +74,8 @@
 upon each invocation, followed by some number of the arguments read
 from the standard input of
 .Nm .
-The utility
+The
+.Ar utility
 is repeatedly executed until standard input is exhausted.
 .Pp
 Spaces, tabs and newlines may be embedded in arguments using single
@@ -224,7 +225,9 @@
 .It Fl s Ar size
 Set the maximum number of bytes for the command line length provided to
 .Ar utility .
-The sum of the length of the utility name, the arguments passed to
+The sum of the length of the
+.Ar utility
+name, the arguments passed to
 .Ar utility
 (including
 .Dv NULL
@@ -303,7 +306,7 @@
 .Sh HISTORY
 The
 .Nm
-command appeared in PWB UNIX.
+utility appeared in PWB UNIX.
 .Sh BUGS
 If
 .Ar utility
>Release-Note:
>Audit-Trail:
>Unformatted:



More information about the freebsd-doc mailing list