find(1): Move description of -d option to -depth primary.
The nullary -depth primary is standard and the -d option provides little advantage. PR: docs/168885 MFC after: 1 week
This commit is contained in:
parent
7080f124d2
commit
eb55578582
Notes:
svn2git
2020-12-20 02:59:44 +00:00
svn path=/head/; revision=237035
@ -31,7 +31,7 @@
|
|||||||
.\" @(#)find.1 8.7 (Berkeley) 5/9/95
|
.\" @(#)find.1 8.7 (Berkeley) 5/9/95
|
||||||
.\" $FreeBSD$
|
.\" $FreeBSD$
|
||||||
.\"
|
.\"
|
||||||
.Dd May 6, 2012
|
.Dd June 13, 2012
|
||||||
.Dt FIND 1
|
.Dt FIND 1
|
||||||
.Os
|
.Os
|
||||||
.Sh NAME
|
.Sh NAME
|
||||||
@ -126,36 +126,15 @@ as an effective alternative.
|
|||||||
.It Fl d
|
.It Fl d
|
||||||
Cause
|
Cause
|
||||||
.Nm
|
.Nm
|
||||||
to perform a depth-first traversal, i.e., directories
|
to perform a depth-first traversal.
|
||||||
are visited in post-order and all entries in a directory will be acted
|
|
||||||
on before the directory itself.
|
|
||||||
By default,
|
|
||||||
.Nm
|
|
||||||
visits directories in pre-order, i.e., before their contents.
|
|
||||||
Note, the default is
|
|
||||||
.Em not
|
|
||||||
a breadth-first traversal.
|
|
||||||
.Pp
|
.Pp
|
||||||
This option is the BSD-specific equivalent of the
|
This option is a BSD-specific equivalent of the
|
||||||
.Ic -depth
|
.Ic -depth
|
||||||
primary of
|
primary specified by
|
||||||
.St -p1003.1-2001 .
|
.St -p1003.1-2001 .
|
||||||
The
|
Refer to its description under
|
||||||
.Fl d
|
.Sx PRIMARIES
|
||||||
option
|
for more information.
|
||||||
can be useful when
|
|
||||||
.Nm
|
|
||||||
is used with
|
|
||||||
.Xr cpio 1
|
|
||||||
to process files that are contained in directories with unusual permissions.
|
|
||||||
It ensures that you have write permission while you are placing files in a
|
|
||||||
directory, then sets the directory's permissions as the last thing.
|
|
||||||
.It Fl f
|
|
||||||
Specify a file hierarchy for
|
|
||||||
.Nm
|
|
||||||
to traverse.
|
|
||||||
File hierarchies may also be specified as the operands immediately
|
|
||||||
following the options.
|
|
||||||
.It Fl s
|
.It Fl s
|
||||||
Cause
|
Cause
|
||||||
.Nm
|
.Nm
|
||||||
@ -327,8 +306,29 @@ Following symlinks is incompatible with this option.
|
|||||||
Always true;
|
Always true;
|
||||||
same as the non-portable
|
same as the non-portable
|
||||||
.Fl d
|
.Fl d
|
||||||
option. Refer to the primary description of
|
option.
|
||||||
.Ic -depth for full information.
|
Cause
|
||||||
|
.Nm
|
||||||
|
to perform a depth-first traversal, i.e., directories
|
||||||
|
are visited in post-order and all entries in a directory will be acted
|
||||||
|
on before the directory itself.
|
||||||
|
By default,
|
||||||
|
.Nm
|
||||||
|
visits directories in pre-order, i.e., before their contents.
|
||||||
|
Note, the default is
|
||||||
|
.Em not
|
||||||
|
a breadth-first traversal.
|
||||||
|
.Pp
|
||||||
|
The
|
||||||
|
.Ic -depth
|
||||||
|
primary
|
||||||
|
can be useful when
|
||||||
|
.Nm
|
||||||
|
is used with
|
||||||
|
.Xr cpio 1
|
||||||
|
to process files that are contained in directories with unusual permissions.
|
||||||
|
It ensures that you have write permission while you are placing files in a
|
||||||
|
directory, then sets the directory's permissions as the last thing.
|
||||||
.It Ic -depth Ar n
|
.It Ic -depth Ar n
|
||||||
True if the depth of the file relative to the starting point of the traversal
|
True if the depth of the file relative to the starting point of the traversal
|
||||||
is
|
is
|
||||||
|
Loading…
Reference in New Issue
Block a user