New option -hide

libisoburn/trunk/xorriso/xorriso.texi

@@ -44,7 +44,7 @@
 @c man .\" First parameter, NAME, should be all caps
 @c man .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
 @c man .\" other parameters are allowed: see man(7), man(1)
-@c man .TH XORRISO 1 "Jun 10, 2010"
+@c man .TH XORRISO 1 "Jun 20, 2010"
 @c man .\" Please adjust this date whenever revising the manpage.
 @c man .\"
 @c man .\" Some roff macros, for reference:
@@ -1755,6 +1755,22 @@ where "A0" is year 2000, "B0" is 2010, etc.
 @kindex -alter_date_r   sets timestamps in ISO image
 @cindex Timestamps, set in ISO image, -alter_date_r
 Like -alter_date but affecting all files below eventual directories.
+@c man .TP
+@item -hide hide_state iso_rr_path [***]
+@kindex -hide   excludes file names from directory trees
+@cindex hidden, set in ISO image, -hide
+Prevent the names of the given files from showing up in the directory trees
+of ISO 9660 and/or Joliet when the image gets written.
+The eventual data content of such hidden files will be included in the
+resulting image, even if they do not show up in any directory.
+But you will need own means to find nameless data in the image.
+@*
+Possible values of hide_state are: "iso_rr" for hiding from ISO 9660 tree,
+"joliet" for Joliet tree, "on" for both trees. "off" means visibility in
+both directory trees.
+@*
+This command does not apply to the boot catalog.
+Rather use: -boot_image "any" "cat_hidden=on"
 @end table
 @c man .TP
 @c man .B Tree traversal command -find:
@@ -3219,6 +3235,9 @@ This resembles shell command ls -d.
 @cindex Navigate, list ISO files, -lsl
 Like -ls but also list some of the file attributes. 
 The output format resembles shell command ls -ln.
+@*
+Particular types of regular files: "R" hidden in ISO/Rock Ridge, "J" hidden in
+Joliet, "H" hidden in both trees.
 @c man .TP
 @item -lsdl iso_rr_pattern [***]
 @kindex -lsdl   lists files in ISO image