Some documentation updates

xorriso/convert_man_to_html.sh

@@ -47,7 +47,7 @@ then
   -e 's/have a look at section EXAMPLES/have a look at section <A HREF="#EXAMPLES">EXAMPLES<\/A>/' \
   -e 's/<b>Session model:<\/b>/\&nbsp;<BR><b>Session model:<\/b>/' \
   -e 's/<b>Media types and states:<\/b>/\&nbsp;<BR><b>Media types and states:<\/b>/' \
-  -e 's/<b>Creating, Growing, Modifying:<\/b>/\&nbsp;<BR><b>Creating, Growing, Modifying:<\/b>/' \
+  -e 's/<b>Creating, Growing, Modifying, Blind Growing:<\/b>/\&nbsp;<BR><b>Creating, Growing, Modifying, Blind Growing:<\/b>/' \
   -e 's/<b>Libburn drives:<\/b>/\&nbsp;<BR><b>Libburn drives:<\/b>/' \
   -e 's/^-dev /\&nbsp;\&nbsp;-dev /' \
   -e 's/^-devices /\&nbsp;\&nbsp;-devices /' \

xorriso/xorriso.1

@@ -50,11 +50,10 @@ Changes file properties in the ISO image.
 .br
 Updates ISO subtrees incrementally to match given disk subtrees.
 .br
-Can write result as completely new image to optical media or
+Writes result either as completely new image or as add-on session
-filesystem objects.
+to optical media or filesystem objects.
 .br
-Can write result as add-on session to appendable multi-session media, 
+Can perform multi-session tasks as emulation of mkisofs and cdrecord.
-to overwriteable media, to regular files, and to block devices.
 .br
 Can restore files from ISO image to disk filesystem (see osirrox).
 .br
@@ -305,7 +304,7 @@ To prevent a fatal intermingling of ISO image and text messages, all result
 texts get redirected to stderr if -*dev "-" or "stdio:/dev/fd/1" is among
 the start arguments of the program.
 .br
-Standard output is currently suitable for creating a single new session
+Standard output is currently suitable for creating one session
 per program run without dialog. Use in other situations is discouraged
 and several restrictions apply: 
 .br
@@ -1974,7 +1973,7 @@ Copy modified ISO image from one media to another
 .br
 Write a ISO image into a pipe (single-session only)
 .br
-Perform a single session run as of cdrtools traditions
+Perform multi-session runs as of cdrtools traditions
 .br
 Adjust thresholds for verbosity, exit value and program abort
 .br
@@ -2129,14 +2128,24 @@ first and only session to the output drive.
 .br
  | gzip >image.iso.gz
 .SS
-.B Perform a single session run as of cdrtools traditions
+.B Perform multi-session runs as of cdrtools traditions
 This shall illustrate how xorriso can act in either role.
 Between both processes there can be performed arbitrary transportation
 or filtering.
 .br
-\fB$\fR xorriso -as mkisofs -J -R /home/prepared_for_iso/tree | \\
+The first session is written like this:
 .br
- xorriso -as cdrecord -v dev=/dev/sr0 blank=fast -eject - 
+\fB$\fR xorriso -as mkisofs prepared_for_iso/tree1 | \\
+.br
+ xorriso -as cdrecord -v dev=/dev/sr0 blank=fast -multi -eject - 
+.br
+Follow-up sessions are written like this:
+.br
+\fB$\fR m=$(xorriso -as cdrecord dev=/dev/sr0 -msinfo)
+.br
+\fB$\fR xorriso -as mkisofs -M /dev/sr0 -C $m prepared_for_iso/tree2 | \\
+.br
+ xorriso -as cdrecord -v dev=/dev/sr0 -multi -eject -
 .SS
 .B Let xorriso work underneath growisofs
 growisofs expects an ISO formatter program which understands options -o, -C,

xorriso/xorriso_eng.html

@@ -106,6 +106,7 @@ Changes file properties in the ISO image.
 <LI>
 Updates ISO subtrees incrementally to match given disk subtrees.
 </LI>
+
 <LI>
 Can write result as completely new image to optical media or
 filesystem objects.
@@ -114,6 +115,16 @@ filesystem objects.
 Can write result as add-on session to appendable multi-session media,
 to overwriteable media, to regular files, and to block devices.
 </LI>
+<!--
+<LI>
+Writes result as completely new image or as add-on session
+to optical media or filesystem objects.
+</LI>
+<LI>
+Can perform multi-session tasks as emulation of mkisofs and cdrecord.
+</LI>
+-->
+
 <LI>
 Can restore single files and whole trees from ISO image to disk filesystem.
 </LI>
@@ -379,8 +390,11 @@ New options -cpax, -cp_rx, -cp_rax to restore files and trees from ISO to disk
 <LI>New options -C and -M for -as mkisofs emulation</LI>
 <LI>Can serve growisofs if started as xorrisofs, genisofs, mkisofs, genisoimage
 </LI>
-<LI>make install creates xorriso aliases as symbolic links: osirrox, xorrisofs
+<LI>New options -multi and -msinfo for -as cdrecord emulation</LI>
+<LI>make install creates xorriso aliases as symbolic links:
+osirrox, xorrisofs, xorrecord
 </LI>
+<LI></LI>
 <!-- 
 <LI>- none yet -</LI>
  -->