New command -toc_of

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.5, Dec 08, 2012"
+.TH XORRISO 1 "Version 1.2.5, Dec 13, 2012"
 .\" Please adjust this date whenever revising the manpage.
 .\"
 .\" Some roff macros, for reference:
@@ -3407,7 +3407,7 @@ Precedence is: "dvdrw", "cdrw", "dvd", "cdrom", "cd".
 .TP
 \fB\-toc\fR
 .br
-Show media specific table of content. This is the session history
+Show media specific tables of content. This is the session history
 of the medium, not the ISO image directory tree.
 .br
 In case of overwriteable media holding a valid ISO image, it may happen that
@@ -3421,6 +3421,17 @@ to be the most recent real session then.
 .br
 Some read\-only drives and media show no usable session history at all.
 Command \-rom_toc_scan might help.
+.br
+If input device and output device are both aquired and not the same,
+then both tables\-of\-content get shown.
+.TP
+\fB\-toc_of\fR "in"|"out"|"all"
+Like command \-toc but explicitely choosing which drive's table\-of\-content
+to show. "in" shows \-indev or \-dev, "out" shows \-outdev or \-dev,
+"all" shows the same as \-toc.
+.br
+As further difference to \-toc, this command does not emit FAILURE events
+when the desired drive is not aquired.
 .TP
 \fB\-mount_cmd\fR drive entity id path
 Emit an appropriate command line for mounting the ISO session