New command -rr_reloc_dir

libisoburn/trunk/xorriso/xorriso.texi

@@ -50,7 +50,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 "Version 1.2.1, Feb 05, 2012"
+@c man .TH XORRISO 1 "Version 1.2.1, Mar 10, 2012"
 @c man .\" Please adjust this date whenever revising the manpage.
 @c man .\"
 @c man .\" Some roff macros, for reference:
@@ -2719,6 +2719,26 @@ Default setting is
 Note: The term "ISO file" means the plain ISO 9660 names and attributes
 which get visible if the reader ignores Rock Ridge.
 @c man .TP
+@item -rr_reloc_dir name
+@kindex -rr_reloc_dir   sets name of relocation directory
+@cindex Relocation directory, set name, -rr_reloc_dir
+Specify the name of the relocation directory in which deep directory subtrees
+shall be placed if -compliance is set to "deep_paths_off". A deep directory
+is one that has a chain of 8 parent directories (including root) above itself.
+@*
+The overall directory tree will appear originally deep when interpreted
+as Rock Ridge tree. It will appear as re-arranged if only ECMA-119
+information is considered.
+@*
+The default relocation directory is the root directory. By giving a non-empty
+name with -rr_reloc_dir, a directory in the root directory may get this role.
+If that directory does not already exist at -commit time, then it will get
+created and marked for Rock Ridge as relocation artefact. At least on
+GNU/Linux it will not be displayed in mounted Rock Ridge images.
+@*
+The name must not contain a '/' character and must not be longer than
+255 bytes.
+@c man .TP
 @item -volid text
 @kindex -volid   sets volume id
 @cindex Image, set volume id, -volid