New options -not_paths, -not_leaf, -not_list, -not_mgt, -as mkisofs -m,

libisoburn/trunk/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 "May, 1, 2008"
+.TH XORRISO 1 "May, 4, 2008"
 .\" Please adjust this date whenever revising the manpage.
 .\"
 .\" Some roff macros, for reference:
@@ -584,7 +584,7 @@ should always be the same as with the first adding of disk_path as iso_rr_path.
 If iso_rr_path does not exist yet, then it gets added. If disk_path does not
 exist, then iso_rr_path gets deleted.
 .br
--update_r is also a convenient compromise between -add addressing and -cp_r
+-update_r is also a convenient compromise between -add addressing and -cpr
 addressing: Its semantics is similar to -add and thus avoids the pitfalls
 inherited from cp -r behavior. Its syntax resembles cp, though.
 .TP
@@ -914,6 +914,60 @@ or worse occured.
 .TP
 .B Settings for data insertion:
 .TP
+\fB\-not_mgt\fR code[:code[...]]
+Control the behavior of the exclusion lists.
+.br
+Exclusion processing happens before disk_paths get mapped to the ISO image
+and before disk files get compared with image files.
+The absolute disk path of the source is matched against the -not_paths list.
+The leafname of the disk path is matched against the patterns in the -not_leaf
+list. If a match is detected then the disk path will not be regarded as an
+existing file and not be added to the ISO image.
+.br
+Several codes are defined.
+The _on/_off settings persist until they are revoked by their_off/_on
+counterparts.
+.br
+"erase" empties the lists which were accumulated by -not_paths and -not_leaf.
+.br
+"reset" is like "erase" but also re-installs default behavior.
+.br
+"off" disables exclusion processing temporarily without invalidating
+the lists and settings.
+.br
+"on" re-enables exclusion processing.
+.br
+"param_off" applies exclusion processing only to paths below disk_path
+parameter of commands. I.e. explicitely given disk_paths are exempted
+from exclusion processing.
+.br
+"param_on" applies exclusion processing to command parameters as well as
+to files below such parameters.
+.br
+"subtree_off" with "param_on" excludes parameter paths only if they
+match a -not_paths item exactly.
+.br
+"subtree_on" additionally excludes parameter paths which lead to a file
+address below any -not_paths item.
+.br
+"ignore_off" treats excluded disk files as if they were missing. I.e. they
+get reported with -compare and deleted from the image with -update.
+.br
+"ignore_on" keeps excluded files out of -compare or -update activities.
+.TP
+\fB\-not_paths\fR disk_path [***]
+Add the given paths to the list of excluded absolute disk paths. If a given
+path is relative, then the current -cdx is prepended to form an absolute path.
+Eventual pattern matching happens at definition time and not when exclusion
+checks are made.
+.br
+(Do not forget to end the list of disk_paths by "--")
+.TP
+\fB\-not_leaf\fR pattern
+Add a single shell parser style pattern to the list of exclusions for
+disk leafnames. These patterns are evaluated when the exclusion checks are
+made.
+.TP
 \fB\-follow\fR occasion[:occasion[...]]
 Enable or disable resolution of symbolic links and mountpoints under
 disk_paths. This applies to actions -add, -du*x, -ls*x, -findx,
@@ -1454,8 +1508,8 @@ Personality "\fBmkisofs\fR" accepts the options listed with:
 .br
   -as mkisofs -help --
 .br
-Among them: -R (always on), -J, -graft-points, -o, -path-list, -print-size, -V,
--v, -version, pathspecs as with xorriso -add. A lot of options are not
+Among them: -R (always on), -J, -graft-points, -o, -path-list, -m, -print-size,
+-V, -v, -version, pathspecs as with xorriso -add. A lot of options are not
 supported and lead to failure of the mkisofs emulation. Some are ignored,
 but better do not rely on this tolerance.
 .br