New command -rr_reloc_dir

libisoburn/trunk/xorriso/xorriso.1

@@ -9,7 +9,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 "Version 1.2.1, Feb 05, 2012"
+.TH XORRISO 1 "Version 1.2.1, Mar 10, 2012"
 .\" Please adjust this date whenever revising the manpage.
 .\"
 .\" Some roff macros, for reference:
@@ -2280,6 +2280,24 @@ 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.
 .TP
+\fB\-rr_reloc_dir\fR name
+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.
+.br
+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.
+.br
+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.
+.br
+The name must not contain a '/' character and must not be longer than
+255 bytes.
+.TP
 \fB\-volid\fR text
 Specify the volume ID. \fBxorriso\fR accepts any text up to 32 characters,
 but according to rarely obeyed specs stricter rules apply: