src/usr.bin/find/find.1 - diff

Return to find.1 CVS log

Up to [local] / src / usr.bin / find

Diff for /src/usr.bin/find/find.1 between version 1.82 and 1.83

-version 1.82, 2011/02/13 12:35:02
+version 1.83, 2012/01/02 23:19:45
 Line 189
 Line 189
 Line 189
  .Op argument ...
  .No ;
  .Xc
- True if the program named
+ .It Xo
- .Ar utility
+ .Ic -exec Ar utility
- returns a zero value as its exit status.
+ .Op argument ...
+ .No {}
+ +
+ .Xc
+ Execute the specified
+ .Ar utility .
  Optional arguments may be passed to the utility.
  The expression must be terminated by a semicolon
- .Pq Ql \&; .
+ .Pq Ql \&;
+ or a plus sign
+ .Pq Ql \&+ .
+ .Pp
+ If terminated by a semicolon, the
+ .Ar utility
+ is executed once per path.
  If the string
  .Qq {}
  appears anywhere in the utility name or the
  arguments it is replaced by the pathname of the current file.
- .Ar utility
- will be executed from the directory from which
- .Nm
- was executed.
  .Pp
- Since
+ If terminated by a plus sign
+ .Pq Dq \&+ ,
+ the pathnames for which the
+ primary is evaluated are aggregated into sets, and
  .Ar utility
- is executed every time a match is made,
+ will be invoked once per set, similar to
- it is often more efficient to pipe the output of
- .Nm
- to
  .Xr xargs 1 .
+ If any invocation exits with non-zero exit status, then
+ .Nm
+ will eventually do so as well, but this does not cause
+ .Nm
+ to exit early.
+ The string
+ .Dq {}
+ must appear, and must appear last.
+ Each set is limited to no more than 5,000 pathnames,
+ and is also limited such that the invocation of
+ .Ar utility
+ does not exceed
+ .Dv ARG_MAX .
  .It Xo
  .Ic -execdir Ar utility
  .Op argument ...