From garys@opusnet.com  Sat Aug  6 15:59:58 2005
Return-Path: <garys@opusnet.com>
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id 790DC16A41F
	for <FreeBSD-gnats-submit@freebsd.org>; Sat,  6 Aug 2005 15:59:58 +0000 (GMT)
	(envelope-from garys@opusnet.com)
Received: from opusnet.com (mail.opusnet.com [209.210.200.6])
	by mx1.FreeBSD.org (Postfix) with ESMTP id E78AC43D45
	for <FreeBSD-gnats-submit@freebsd.org>; Sat,  6 Aug 2005 15:59:57 +0000 (GMT)
	(envelope-from garys@opusnet.com)
Received: from localhost.localhost [70.98.246.232] by opusnet.com with ESMTP
  (SMTPD32-8.05) id AE7CAE35014C; Sat, 06 Aug 2005 08:59:56 -0700
Received: from localhost.localhost (localhost.localhost [127.0.0.1])
	by localhost.localhost (8.13.3/8.13.3) with ESMTP id j76G1rLF086648
	for <FreeBSD-gnats-submit@freebsd.org>; Sat, 6 Aug 2005 09:01:53 -0700 (PDT)
	(envelope-from garys@opusnet.com)
Received: (from jojo@localhost)
	by localhost.localhost (8.13.3/8.13.3/Submit) id j76G1mf6086647;
	Sat, 6 Aug 2005 09:01:48 -0700 (PDT)
	(envelope-from garys@opusnet.com)
Message-Id: <4bbr4b12c3.r4b@mail.opusnet.com>
Date: Sat, 06 Aug 2005 09:01:48 -0700
From: "Gary W. Swearingen" <garys@opusnet.com>
Reply-To: garys@opusnet.com
To: FreeBSD-gnats-submit@freebsd.org
Subject: [patch] xargs(1) manpage has "utility" and "command" inconsistency
X-GNATS-Notify:

>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:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Sat Aug 06 16:00:35 GMT 2005
>Closed-Date:    Wed Dec 07 12:32:22 GMT 2005
>Last-Modified:  Wed Dec 07 12:32:22 GMT 2005
>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:
State-Changed-From-To: open->closed 
State-Changed-By: des 
State-Changed-When: Wed Dec 7 12:32:21 GMT 2005 
State-Changed-Why:  
The current wording is consistent with that of the standard. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=84620 
>Unformatted:
