New -find tests -wholename, -prune

xorriso/xorriso.1

@@ -2,7 +2,7 @@
 .\" First parameter, NAME, should be all caps
 .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
 .\" other parameters are allowed: see man(7), man(1)
-.TH XORRISO 1 "Apr 21, 2009"
+.TH XORRISO 1 "Apr 23, 2009"
 .\" Please adjust this date whenever revising the manpage.
 .\"
 .\" Some roff macros, for reference:
@@ -1137,7 +1137,7 @@ External filters may also be banned totally at compile time of xorriso.
 By default they are banned if xorriso runs under setuid permission.
 .TP
 \fB\-set_filter\fR name iso_rr_path [***]
-Apply an -external_filter or a built--in filter to the given data files in the
+Apply an -external_filter or a built-in filter to the given data files in the
 ISO image.
 If the filter suffix is not empty , then it will be applied to the file name.
 Renaming only happens if the filter really gets attached and is not revoked by
@@ -1223,9 +1223,11 @@ if all its tests match.
 Available tests are:
 .br
 \fB\-name\fR pattern :
-Pattern is not expanded but used for comparison with
-the particular file names of the eventual directory tree underneath
-iso_rr_path.
+Matches if pattern matches the file leaf name.
+.br
+\fB\-wholename\fR pattern :
+Matches if pattern matches the file path as it would be printed by action
+"echo". Character '/' is not special but can be matched by wildcards.
 .br
 \fB\-type\fR type_letter :
 Matches files files of the given type:
@@ -1258,9 +1260,16 @@ Matches files which have ACL or any xattr.
 \fB\-has_filter\fR :
 Matches files which are filtered by -set_filter.
 .br
+\fB\-prune\fR :
+If this test is reached and the tested file is a directory then -find will not
+dive into that directory. This test itself does always match. 
+.br
 \fB\-decision\fR "yes"|"no" :
-If this test is reached then the evaluation ends immediatly and action
-is performed if the decision is not "no", "0", or "false". See operator -if.
+If this test is reached then the evaluation ends immediately and action
+is performed if the decision is "yes" or "true". See operator -if.
+.br
+\fB\-true\fR and \fB\-false\fR :
+Always match resp. match not. Evaluation goes on.
 .br
 Available operators are:
 .br
@@ -1277,10 +1286,9 @@ Matches if both neighboring tests or expressions match.
 \fB\-or\fR :
 Matches if at least one of both neighboring tests or expressions matches.
 .br
-\fB\-sub\fR ... \fB\-subend\fR :
+\fB\-sub\fR ... \fB\-subend\fR or \fB(\fR ... \fB)\fR :
 Enclose a sub expression which gets evaluated first before it
-is processed by neighboring operators. The same meaning have "(" and ")".
-.br
+is processed by neighboring operators.
 Normal precedence is: -not, -or , -and.
 .br
 \fB\-if\fR ... \fB\-then\fR\ ... \fB\-elseif\fR ... \fB\-then\fR ...
@@ -1293,7 +1301,7 @@ is evaluated.
 There may be more than one -elseif. Neither -else nor -elseif are mandatory.
 If -else is missing and would be hit, then the result is a non-match.
 .br
--if expressions are the main use case for the test -decision.
+-if-expressions are the main use case for above test -decision.
 
 Default action is \fBecho\fR,
 i.e. to print the address of the found file. Other actions are certain
@@ -1707,7 +1715,7 @@ can be revoked individually by appending "_off". Like "deep_paths_off".
 .br
 Rule keywords are:
 .br
-"omit_version" do not add versions (";1") to the file names.
+"omit_version" do not add versions (";1") to ISO file names.
 .br
 "deep_paths" allow ISO file paths deeper than 8 levels.
 .br
@@ -1715,7 +1723,7 @@ Rule keywords are:
 .br
 "long_names" allow up to 37 characters with ISO file names.
 .br
-"no_force_dots" do not add a dot to filenames which have none.
+"no_force_dots" do not add a dot to ISO file names which have none.
 .br
 "lowercase" allow lowercase characters in ISO file names.
 .br
@@ -1742,7 +1750,7 @@ Default setting is
 .br
  "clear:deep_paths:long_paths:always_gmt:old_rr".
 .br
-Note: The term "ISO file" means the plain ISO 9660 names wnd attributes
+Note: The term "ISO file" means the plain ISO 9660 names and attributes
 which get visible if the reader ignores Rock Ridge.
 .TP
 \fB\-volid\fR text