[src/trunk]: src/usr.bin/find Clarify (hopefully) the description of -remove.

[dsl <dsl%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/f5c17eb15998
branches:  trunk
changeset: 748846:f5c17eb15998
user:      dsl <dsl%NetBSD.org@localhost>
date:      Fri Nov 06 21:03:12 2009 +0000

description:
Clarify (hopefully) the description of -remove.
Fixes PR/38987

diffstat:

 usr.bin/find/find.1 |  15 ++++++++-------
 1 files changed, 8 insertions(+), 7 deletions(-)

diffs (41 lines):

diff -r a5aaf7a0d01e -r f5c17eb15998 usr.bin/find/find.1
--- a/usr.bin/find/find.1       Fri Nov 06 20:51:43 2009 +0000
+++ b/usr.bin/find/find.1       Fri Nov 06 21:03:12 2009 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: find.1,v 1.68 2009/10/15 02:26:38 joerg Exp $
+.\"    $NetBSD: find.1,v 1.69 2009/11/06 21:03:12 dsl Exp $
 .\"
 .\" Copyright (c) 1990, 1993
 .\"    The Regents of the University of California.  All rights reserved.
@@ -32,7 +32,7 @@
 .\"
 .\"    from: @(#)find.1        8.7 (Berkeley) 5/9/95
 .\"
-.Dd July 19, 2007
+.Dd November 6, 2009
 .Dt FIND 1
 .Os
 .Sh NAME
@@ -219,16 +219,17 @@
 24-hour periods.
 .Pp
 .It Ic -delete
-Delete found files and/or directories.
+Delete found files, symbolic links and directories.
 Always returns True.
 This executes from the current working directory as
 .Nm
 recurses down the tree.
-It will not attempt to delete a filename with a
+To avoid deleting unexpected files, it will ignore any filenames that
+.Xr fts 3
+returns that contain a
 .Dq /
-character in its pathname relative to
-.Dq \&.
-for security reasons.
+.Xr ( fts 3
+should not return such pathnames).
 Depth-first traversal processing is implied by this option.
 This can also be invoked as
 .Ic -rm .