Mentioned missing mkisofs -old-root functionality in man page

11 years ago · be691d4f81
3 changed files with 54 additions and 37 deletions
--- a/xorriso/xorriso.1
+++ b/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 "Jan 06, 2011"
+.TH XORRISO 1 "Jan 19, 2011"
 .\" Please adjust this date whenever revising the manpage.
 .\"
 .\" Some roff macros, for reference:
@ -3521,6 +3521,9 @@ directory is added to the image. At the same occasion directory names get
 allowed to violate the standard by -compliance option allow_dir_id_ext.
 This may be avoided by option -disallow_dir_id_ext.
 .br
+Currently there is no emulation for -root and -old-root. Incremental backups
+can be done by native xorriso command -update_r. See also EXAMPLES section.
+.br
 Not original mkisofs options are --quoted_path_list ,
 --hardlinks , --acl ,
 --xattr , --md5 , --stdio_sync .
@ -4293,6 +4296,8 @@ get endangered by the new write operation, while the newest backup is
 stored safely on a different media.
 Always have a blank media ready to perform a full backup in case the update
 attempt fails due to insufficient remaining capacity.
+.br
+This example produces a result similar to  -root / -old-root / with mkisofs.
 .SS
 .B Restore directory trees from a particular ISO session to disk
 This is an alternative to mounting the media and using normal file operations.
@ -4410,7 +4415,7 @@ Thomas Schmitt <scdbackup@gmx.net>
 .br
 for libburnia-project.org
 .SH COPYRIGHT
-Copyright (c) 2007 - 2010 Thomas Schmitt
+Copyright (c) 2007 - 2011 Thomas Schmitt
 .br
 Permission is granted to distribute this text freely. It shall only be
 modified in sync with the technical properties of xorriso. If you make use
--- a/xorriso/xorriso.info
+++ b/xorriso/xorriso.info
@ -3141,6 +3141,9 @@ programs trigger comparable actions.
     directory names get allowed to violate the standard by -compliance
     option allow_dir_id_ext.  This may be avoided by option
     -disallow_dir_id_ext.
+     Currently there is no emulation for -root and -old-root.
+     Incremental backups can be done by native xorriso command
+     -update_r. See also EXAMPLES section.
     Not original mkisofs options are --quoted_path_list , --hardlinks
     , --acl , --xattr , --md5 , --stdio_sync .  They work like the
     xorriso options with the same name and hardcoded argument "on",
@ -3825,6 +3828,9 @@ stored safely on a different media.  Always have a blank media ready to
 perform a full backup in case the update attempt fails due to
 insufficient remaining capacity.

+This example produces a result similar to  -root / -old-root / with
+mkisofs.
+

 File: xorriso.info,  Node: ExRestore,  Next: ExRecovery,  Prev: ExIncBackup,  Up: Examples

@ -3950,7 +3956,7 @@ for libburnia-project.org
 13.2 Copyright
 ==============

-Copyright (c) 2007 - 2010 Thomas Schmitt
+Copyright (c) 2007 - 2011 Thomas Schmitt
 Permission is granted to distribute this text freely. It shall only be
 modified in sync with the technical properties of xorriso. If you make
 use of the license to derive modified versions of xorriso then you are
@ -4103,7 +4109,7 @@ File: xorriso.info,  Node: CommandIdx,  Next: ConceptIdx,  Prev: Legal,  Up: Top
 * -out_charset   sets output character set: SetWrite.         (line 180)
 * -outdev   aquires a drive for output:  AqDrive.             (line  29)
 * -overwrite   enables overwriting in ISO: SetInsert.         (line 127)
-* -pacifier   controls pacifier text form: Emulation.         (line 142)
+* -pacifier   controls pacifier text form: Emulation.         (line 145)
 * -padding   sets amount of image padding: SetWrite.          (line 263)
 * -page   set terminal geometry:         DialogCtl.           (line  19)
 * -paste_in   copies file into disk file: Restore.            (line 117)
@ -4123,7 +4129,7 @@ File: xorriso.info,  Node: CommandIdx,  Next: ConceptIdx,  Prev: Legal,  Up: Top
 * -quoted_not_list   sets exclusions:    SetInsert.           (line  72)
 * -quoted_path_list   inserts paths from disk file: Insert.   (line  80)
 * -read_mkisofsrc   searches and reads .mkisofsrc file: Emulation.
-                                                              (line 130)
+                                                              (line 133)
 * -reassure   enables confirmation question: DialogCtl.       (line  32)
 * -report_about   controls verbosity:    Exception.           (line  55)
 * -return_with   controls exit value:    Exception.           (line  39)
@ -4133,7 +4139,7 @@ File: xorriso.info,  Node: CommandIdx,  Next: ConceptIdx,  Prev: Legal,  Up: Top
 * -rollback   discards pending changes:  Writing.             (line   9)
 * -rollback_end   ends program without writing: Scripting.    (line 125)
 * -rom_toc_scan   searches for sessions: Loading.             (line 203)
-* -scdbackup_tag   enables scdbackup checksum tag: Emulation. (line 152)
+* -scdbackup_tag   enables scdbackup checksum tag: Emulation. (line 155)
 * -scsi_log   reports SCSI commands:     Scripting.           (line 113)
 * -session_log   logs written sessions:  Scripting.           (line 104)
 * -session_string   composes session info line: Inquiry.      (line  56)
@ -4190,11 +4196,11 @@ File: xorriso.info,  Node: ConceptIdx,  Prev: CommandIdx,  Up: Top
 * Backslash Interpretation, _definition: Processing.          (line  49)
 * Backup, enable fast incremental, -disk_dev_ino: Loading.    (line 182)
 * Backup, enable features, -for_backup:  Loading.             (line 177)
-* Backup, scdbackup checksum tag, -scdbackup: Emulation.      (line 152)
+* Backup, scdbackup checksum tag, -scdbackup: Emulation.      (line 155)
 * Blank media, _definition:              Media.               (line  29)
 * Blind growing, _definition:            Methods.             (line  40)
 * Bootability, control, -boot_image:     Bootable.            (line  26)
-* cdrecord, Emulation:                   Emulation.           (line  97)
+* cdrecord, Emulation:                   Emulation.           (line 100)
 * Character Set, _definition:            Charset.             (line   6)
 * Character Set, for input, -in_charset: Loading.             (line  92)
 * Character Set, for input/output, -charset: Charset.         (line  43)
@ -4229,10 +4235,10 @@ File: xorriso.info,  Node: ConceptIdx,  Prev: CommandIdx,  Up: Top
 * Drive, write and eject, -commit_eject: Writing.             (line  40)
 * El Torito, _definiton:                 Extras.              (line  19)
 * Emulation, -as:                        Emulation.           (line  13)
-* Emulation, .mkisofsrc, -read_mkisofsrc: Emulation.          (line 130)
-* Emulation, cdrecord, -as:              Emulation.           (line  97)
+* Emulation, .mkisofsrc, -read_mkisofsrc: Emulation.          (line 133)
+* Emulation, cdrecord, -as:              Emulation.           (line 100)
 * Emulation, mkisofs, -as:               Emulation.           (line  16)
-* Emulation, pacifier form, -pacifier:   Emulation.           (line 142)
+* Emulation, pacifier form, -pacifier:   Emulation.           (line 145)
 * Examples:                              Examples.            (line   6)
 * Filter, _definition:                   Filter.              (line   6)
 * Filter, apply to file tree, -set_filter_r: Filter.          (line  84)
@ -4446,29 +4452,29 @@ Node: Navigate131705
 Node: Verify139600
 Node: Restore148189
 Node: Emulation154845
-Node: Scripting163677
-Node: Frontend169239
-Node: Examples170534
-Node: ExDevices171703
-Node: ExCreate172337
-Node: ExDialog173611
-Node: ExGrowing174873
-Node: ExModifying175675
-Node: ExBootable176176
-Node: ExCharset176723
-Node: ExPseudo177551
-Node: ExCdrecord178445
-Node: ExMkisofs178760
-Node: ExGrowisofs179763
-Node: ExException180887
-Node: ExTime181341
-Node: ExIncBackup181800
-Node: ExRestore185290
-Node: ExRecovery186259
-Node: Files186825
-Node: Seealso188053
-Node: Legal188577
-Node: CommandIdx189499
-Node: ConceptIdx203725
+Node: Scripting163845
+Node: Frontend169407
+Node: Examples170702
+Node: ExDevices171871
+Node: ExCreate172505
+Node: ExDialog173779
+Node: ExGrowing175041
+Node: ExModifying175843
+Node: ExBootable176344
+Node: ExCharset176891
+Node: ExPseudo177719
+Node: ExCdrecord178613
+Node: ExMkisofs178928
+Node: ExGrowisofs179931
+Node: ExException181055
+Node: ExTime181509
+Node: ExIncBackup181968
+Node: ExRestore185536
+Node: ExRecovery186505
+Node: Files187071
+Node: Seealso188299
+Node: Legal188823
+Node: CommandIdx189745
+Node: ConceptIdx203971

 End Tag Table
--- a/xorriso/xorriso.texi
+++ b/xorriso/xorriso.texi
@ -44,7 +44,7 @@
@c man .\" First parameter, NAME, should be all caps
@c man .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
@c man .\" other parameters are allowed: see man(7), man(1)
-@c man .TH XORRISO 1 "Jan 06, 2011"
+@c man .TH XORRISO 1 "Jan 19, 2011"
@c man .\" Please adjust this date whenever revising the manpage.
@c man .\"
@c man .\" Some roff macros, for reference:
@ -4172,6 +4172,9 @@ directory is added to the image. At the same occasion directory names get
 allowed to violate the standard by -compliance option allow_dir_id_ext.
 This may be avoided by option -disallow_dir_id_ext.
@*
+Currently there is no emulation for -root and -old-root. Incremental backups
+can be done by native xorriso command -update_r. See also EXAMPLES section.
+@*
 Not original mkisofs options are @minus{}@minus{}quoted_path_list ,
@minus{}@minus{}hardlinks , @minus{}@minus{}acl ,
@minus{}@minus{}xattr , @minus{}@minus{}md5 , @minus{}@minus{}stdio_sync .
@ -5151,6 +5154,9 @@ get endangered by the new write operation, while the newest backup is
 stored safely on a different media.
 Always have a blank media ready to perform a full backup in case the update
 attempt fails due to insufficient remaining capacity.
+@*
+@sp 1
+This example produces a result similar to  -root / -old-root / with mkisofs.
@c man .SS
@c man .B Restore directory trees from a particular ISO session to disk
@node ExRestore, ExRecovery, ExIncBackup, Examples
@ -5316,7 +5322,7 @@ Thomas Schmitt <scdbackup@@gmx.net>
 for libburnia-project.org
@c man .SH COPYRIGHT
@section Copyright
-Copyright (c) 2007 - 2010 Thomas Schmitt
+Copyright (c) 2007 - 2011 Thomas Schmitt
@*
 Permission is granted to distribute this text freely. It shall only be
 modified in sync with the technical properties of xorriso. If you make use