Documentation polishing

libisoburn/trunk/xorriso/xorriso.1

@@ -2206,7 +2206,7 @@ Manipulating an existing ISO image on the same media
 .br
 Copy modified ISO image from one media to another
 .br
-Write a ISO image into a pipe
+Operate on storage facilities other than optical drives
 .br
 Perform multi-session runs as of cdrtools traditions
 .br
@@ -2358,7 +2358,17 @@ first and only session to the output drive.
 .br
  -commit -eject all
 .SS
-.B Write a ISO image into a pipe
+.B Operate on storage facilities other than optical drives
+Full read-write operation is possible with regular files and block devices:
+.br
+\fB$\fR xorriso -dev stdio:/tmp/regular_file ...
+.br
+Other writeable file types are supported write-only:
+.br
+\fB$\fR xorriso -outdev stdio:/tmp/named_pipe ...
+.br
+Among the write-only drives is standard output:
+.br
 \fB$\fR xorriso -outdev - \\
 .br
  ...

libisoburn/trunk/xorriso/xorriso_eng.html

@@ -141,6 +141,11 @@ Adjustable thresholds for abort, exit value, and problem reporting.
 <DL>
 <DT>Get an overview of drives and their addresses</DT>
 <DD>#<KBD>&nbsp;xorriso -devices</KBD></DD>
+<DD><KBD>...</KBD></DD>
+<DD><KBD>0  -dev '/dev/sr0'  rwrw-- :  'TSSTcorp' 'CDDVDW SH-S203B'</KBD></DD>
+<DD><KBD>1  -dev '/dev/scd1' rwrw-- :  'PHILIPS ' 'SPD3300L'</KBD></DD>
+<DD><KBD>2  -dev '/dev/hda'  rwrw-- :  'HL-DT-ST' 'DVD-ROM GDR8162B'</KBD></DD>
+<DD><KBD>...</KBD></DD>
 <DT>Being superuser avoids permission problems with /dev/srN resp. /dev/hdX .
 </DT>
 <DT>Ordinary users should then get granted rw access to the /dev files
@@ -273,6 +278,15 @@ with ".o" or ".swp" which are excluded by options -not_leaf.
 <DT>
 <HR>
 </DT>
+<DT>ISO images may not only be stored on optical media but also in
+regular disk files or block devices for full multi-session operation.
+The prefix &quot;stdio:&quot; indicates that normal file operations are
+desired rather than MMC drive commands:
+</DT>
+<DD>$<KBD>&nbsp;xorriso -dev stdio:/tmp/regular_file ...other.options...</DD>
+
+<DT>Other file types are suitable only for writing but not for reading:</DT>
+<DD>$<KBD>&nbsp;xorriso -outdev stdio:/tmp/named_pipe ...other.options...</DD>
 
 <DT>In batch mode it is possible to operate xorriso in a pipeline
 with an external consumer of the generated ISO image. Any message