New option -as mkisofs emulates a narrow set of mkisofs gestures

libisoburn/trunk/xorriso/xorriso.1

@@ -2,7 +2,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 "February 19, 2008"
+.TH XORRISO 1 "February 20, 2008"
 .\" Please adjust this date whenever revising the manpage.
 .\"
 .\" Some roff macros, for reference:
@@ -1251,17 +1251,55 @@ always perform action "echo".
 .TP
 .B Command compatibility emulations:
 .PP
-ISO 9660 multi-session on CD is traditionally done by program mkisofs
+Writing of ISO 9660 on CD is traditionally done by program mkisofs
 as ISO 9660 image producer and cdrecord as burn program.
-xorriso does not strive to emulate any of them. Nevertheless it is ready to
-perform some of its core tasks under control of commands which trigger
-comparable actions in said programs.
+xorriso does not strive for their comprehensive emulation.
+Nevertheless it is ready to perform some of its core tasks under control
+of commands which in said programs trigger comparable actions.
+The scope is for now only a single first data track to be written to blank or
+overwriteable media. If possible the media will get closed afterwards.
+Multi-session is yet only possible via xorriso's own commands.
 .TP
 \fB\-as\fR personality option [options] --
 .br
 Performs its variable length option list as sparse emulation of the program
-depicted by the personality word.
+depicted by the personality word. This is only allowed if no image changes
+are pending. The input drive is given up.
 .br
+
+Personality "\fBmkisofs\fR" accepts the options listed with:
+.br
+  -as mkisofs -help --
+.br
+Among them: -R (always on), -J, -graft-points, -o, -path-list, -print-size, -V,
+-v, -version, pathspecs as with xorriso -add. A lot of options are not
+supported and lead to failure of the mkisofs emulation. Some are ignored,
+but better do not rely on this tolerance.
+.br
+-graft-points is equivalent to -pathspecs on. Note that pathspecs without "="
+are interpreted differently than with xorriso option -add. Directories get
+merged with the root directory of the ISO image, other filetypes get mapped
+into that root directory.
+.br
+Other than with the "cdrecord" personality there is no automatic -commit at
+the end of a "mkisofs" option list. Verbosity settings -v (= "UPDATE") and
+-quiet (= "SORRY") persist. The output file, eventually chosen with -o,
+persists until things happen like -commit, -rollback, -dev, or end of xorriso.
+.br
+If no output file was chosen before or during a "mkisofs" option list, then
+standard output (-outdev "-") will get into effect before pathspecs get
+added. If -o points to a regular file, then it will be truncated to 0 bytes
+before "mkisofs" options are processed. Directories and symbolic links
+are no valid -o targets.
+.br
+Writing to stdout is possible only if -as "mkisofs" was among the start
+arguments or if other start arguments pointed the output drive to
+standard output.
+.br
+Personalites "\fBgenisoimage\fR" and "\fBgenisofs\fR"
+are aliases for "mkisofs".
+.br
+
 Personality "\fBcdrecord\fR" accepts the options listed with:
 .br
   -as cdrecord -help --
@@ -1273,11 +1311,12 @@ It ignores most other options of cdrecord and cdrskin but refuses on
 -audio, -scanbus, -multi, -msinfo, --grow_overwriteable_iso,
 and on blanking modes unknown to xorriso.
 .br
-The scope is for now a single data track to be written to blank or
-overwriteable media. If possible the media will get closed afterwards.
 dev= must be given as xorriso device address. Adresses like 0,0,0 or ATA:1,1,0
 are not supported.
 .br
+If a track source is given, then an automatic -commit happens at the end of
+the "cdrecord" option list.
+.br
 A much more elaborate libburn based cdrecord emulator is the program cdrskin.
 .br
 Personalites "\fBwodim\fR" and "\fBcdrskin\fR" are aliases for "cdrecord".
@@ -1542,6 +1581,15 @@ do not abort prematurely but forcibly go on until the end of commands.
 .br
  ...
 .SS
+.B Perform a single session run 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 | \\
+.br
+ xorriso -as cdrecord -v dev=/dev/sr0 blank=fast -eject - 
+.SS
 .B Examples of input timestrings
 .br
 As printed by program date: