From owner-freebsd-doc  Sun Mar 31 20: 0:22 2002
Delivered-To: freebsd-doc@hub.freebsd.org
Received: from freefall.freebsd.org (freefall.FreeBSD.org [216.136.204.21])
	by hub.freebsd.org (Postfix) with ESMTP id 0E10737B42F
	for <freebsd-doc@hub.freebsd.org>; Sun, 31 Mar 2002 20:00:04 -0800 (PST)
Received: (from gnats@localhost)
	by freefall.freebsd.org (8.11.6/8.11.6) id g31404f02362;
	Sun, 31 Mar 2002 20:00:04 -0800 (PST)
	(envelope-from gnats)
Received: from green.shallow.net (c16486.smelb1.vic.optusnet.com.au [210.49.224.105])
	by hub.freebsd.org (Postfix) with ESMTP id 978E637B416
	for <FreeBSD-gnats-submit@freebsd.org>; Sun, 31 Mar 2002 19:50:26 -0800 (PST)
Received: by green.shallow.net (Postfix, from userid 1001)
	id 138C83E2C; Mon,  1 Apr 2002 13:50:25 +1000 (EST)
Message-Id: <20020401035025.138C83E2C@green.shallow.net>
Date: Mon,  1 Apr 2002 13:50:25 +1000 (EST)
From: Joshua Goodall <joshua@roughtrade.net>
Reply-To: Joshua Goodall <joshua@roughtrade.net>
To: FreeBSD-gnats-submit@FreeBSD.org
X-Send-Pr-Version: 3.113
Subject: docs/36602: find.1 should encourage users to DTRT when piping to xargs
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
List-ID: <freebsd-doc.FreeBSD.ORG>
List-Archive: <http://docs.freebsd.org/mail/> (Web Archive)
List-Help: <mailto:majordomo@FreeBSD.ORG?subject=help> (List Instructions)
List-Subscribe: <mailto:majordomo@FreeBSD.ORG?subject=subscribe%20freebsd-doc>
List-Unsubscribe: <mailto:majordomo@FreeBSD.ORG?subject=unsubscribe%20freebsd-doc>
X-Loop: FreeBSD.org


>Number:         36602
>Category:       docs
>Synopsis:       find.1 should encourage users to DTRT when piping to xargs
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Sun Mar 31 20:00:04 PST 2002
>Closed-Date:
>Last-Modified:
>Originator:     Joshua Goodall
>Release:        FreeBSD 4.5-STABLE i386
>Organization:
>Environment:
System: FreeBSD green.shallow.net 4.5-STABLE FreeBSD 4.5-STABLE #2: Sat Mar 30 12:55:07 EST 2002 joshua@green.shallow.net:/usr/obj/usr/src/sys/GREEN i386


>Description:

find.1 describes the -X option, great, but doesn't give the
DTRT solution, that is, using -print0 and then xargs -0 on the
other side of the pipe.

>How-To-Repeat:

>Fix:

Index: find.1
===================================================================
RCS file: /cvs/src/usr.bin/find/find.1,v
retrieving revision 1.41
diff -u -r1.41 find.1
--- find.1	20 Nov 2001 15:45:29 -0000	1.41
+++ find.1	1 Apr 2002 03:29:30 -0000
@@ -117,6 +117,12 @@
 quotes, backslash
 .Pq Dq Li \e ,
 space, tab and newline characters.
+.Pp
+However, you may wish to consider the
+.Fl print0
+primary in conjunction with
+.Ql xargs -0
+as an effective alternative.
 .It Fl d
 The
 .Fl d
>Release-Note:
>Audit-Trail:
>Unformatted:

To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message