From 63aca8c11e1cf7655cf71f7be13ad44ed78624e1 Mon Sep 17 00:00:00 2001 From: Thomas Schmitt Date: Sun, 23 May 2010 15:16:25 +0000 Subject: [PATCH] Documentation for recent enhancements --- libisoburn/trunk/xorriso/xorriso.1 | 6 +- libisoburn/trunk/xorriso/xorriso.info | 143 +++++++++++++------------- libisoburn/trunk/xorriso/xorriso.texi | 6 +- 3 files changed, 83 insertions(+), 72 deletions(-) diff --git a/libisoburn/trunk/xorriso/xorriso.1 b/libisoburn/trunk/xorriso/xorriso.1 index b3893227..83382319 100644 --- a/libisoburn/trunk/xorriso/xorriso.1 +++ b/libisoburn/trunk/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 "Apr 28, 2010" +.TH XORRISO 1 "May 22, 2010" .\" Please adjust this date whenever revising the manpage. .\" .\" Some roff macros, for reference: @@ -1961,6 +1961,9 @@ Default is "old_rr" which uses Rock Ridge version 1.10. This implies also "aaip_susp_1_10" allows AAIP to be written as unofficial extension of RRIP rather than as official extension under SUSP-1.12. .br +"no_emul_toc" saves 64 kB with the first session on overwriteable media +but makes the image incapable of displaying its session history. +.br Default setting is .br "clear:only_iso_version:deep_paths:long_paths:no_j_force_dots: @@ -3175,6 +3178,7 @@ They work like the xorriso options with the same name and hardcoded argument "on", e.g. -acl "on". Explicit arguments are expected by --stdio_sync and --scdbackup_tag. +--no-emul-toc is -compliance no_emul_toc. .br --sort-weight gets as arguments a number and an iso_rr_path. The number becomes the LBA sorting weight of regular file iso_rr_path or diff --git a/libisoburn/trunk/xorriso/xorriso.info b/libisoburn/trunk/xorriso/xorriso.info index 83a5410e..1e9914b2 100644 --- a/libisoburn/trunk/xorriso/xorriso.info +++ b/libisoburn/trunk/xorriso/xorriso.info @@ -1760,6 +1760,9 @@ will be written according to the setting of option -acl. "aaip_susp_1_10_off". "aaip_susp_1_10" allows AAIP to be written as unofficial extension of RRIP rather than as official extension under SUSP-1.12. + "no_emul_toc" saves 64 kB with the first session on overwriteable + media but makes the image incapable of displaying its session + history. Default setting is "clear:only_iso_version:deep_paths:long_paths:no_j_force_dots: always_gmt:old_rr". @@ -2841,7 +2844,7 @@ programs trigger comparable actions. , --acl , --xattr , --md5 , --stdio_sync . They work like the xorriso options with the same name and hardcoded argument "on", e.g. -acl "on". Explicit arguments are expected by --stdio_sync - and --scdbackup_tag. + and --scdbackup_tag. --no-emul-toc is -compliance no_emul_toc. --sort-weight gets as arguments a number and an iso_rr_path. The number becomes the LBA sorting weight of regular file iso_rr_path or of all regular files underneath directory iso_rr_path. (See @@ -3642,7 +3645,7 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top * -add_plainly inserts one or more paths: Insert. (line 61) * -alter_date sets timestamps in ISO image: Manip. (line 146) * -alter_date_r sets timestamps in ISO image: Manip. (line 166) -* -application_id sets application id: SetWrite. (line 87) +* -application_id sets application id: SetWrite. (line 90) * -as emulates mkisofs or cdrecord: Emulation. (line 13) * -assert_volid rejects undesired images: Loading. (line 65) * -auto_charset learns character set from image: Loading. (line 80) @@ -3664,7 +3667,7 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top * -chmod_r sets permissions in ISO image: Manip. (line 70) * -chown sets ownership in ISO image: Manip. (line 42) * -chown_r sets ownership in ISO image: Manip. (line 47) -* -close controls media closing: SetWrite. (line 196) +* -close controls media closing: SetWrite. (line 199) * -close_filter_list bans filter registration: Filter. (line 52) * -commit writes pending ISO image: Writing. (line 13) * -commit_eject writes and ejects: Writing. (line 40) @@ -3684,11 +3687,11 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top * -disk_pattern controls pattern expansion: Insert. (line 31) * -drive_class controls drive accessability: Loading. (line 35) * -du show directory size in ISO image: Navigate. (line 84) -* -dummy controls write simulation: SetWrite. (line 185) +* -dummy controls write simulation: SetWrite. (line 188) * -dus show directory size in ISO image: Navigate. (line 88) * -dusx show directory size on disk: Navigate. (line 97) * -dux show directory size on disk: Navigate. (line 92) -* -dvd_obs set write block size: SetWrite. (line 172) +* -dvd_obs set write block size: SetWrite. (line 175) * -eject ejects drive tray: Writing. (line 36) * -end writes pending session and ends program: Scripting. (line 122) * -errfile_log logs problematic disk files: Scripting. (line 84) @@ -3705,12 +3708,12 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top * -follow softlinks and mount points: SetInsert. (line 76) * -for_backup -acl,-xattr,-hardlinks,-md5: Loading. (line 163) * -format formats media: Writing. (line 69) -* -fs sets size of fifo: SetWrite. (line 189) +* -fs sets size of fifo: SetWrite. (line 192) * -getfacl shows ACL in ISO image: Navigate. (line 65) * -getfacl_r shows ACL in ISO image: Navigate. (line 72) * -getfattr shows xattr in ISO image: Navigate. (line 76) * -getfattr_r shows xattr in ISO image: Navigate. (line 80) -* -gid sets global ownership: SetWrite. (line 129) +* -gid sets global ownership: SetWrite. (line 132) * -grow_blindly overides next writeable address: AqDrive. (line 44) * -hardlinks controls handling of hard links: Loading. (line 91) * -help prints help text: Scripting. (line 16) @@ -3750,11 +3753,11 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top * -not_paths sets absolute exclusion paths: SetInsert. (line 55) * -options_from_file reads commands from file: Scripting. (line 12) * -osirrox enables ISO-to-disk copying: Restore. (line 18) -* -out_charset sets output character set: SetWrite. (line 119) +* -out_charset sets output character set: SetWrite. (line 122) * -outdev aquires a drive for output: AqDrive. (line 29) * -overwrite enables overwriting in ISO: SetInsert. (line 127) * -pacifier controls pacifier text form: Emulation. (line 105) -* -padding sets amount of image padding: SetWrite. (line 202) +* -padding sets amount of image padding: SetWrite. (line 205) * -page set terminal geometry: DialogCtl. (line 15) * -paste_in copies file into disk file: Restore. (line 117) * -path_list inserts paths from disk file: Insert. (line 75) @@ -3765,7 +3768,7 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top * -prog sets program name: Frontend. (line 29) * -prog_help prints help text: Frontend. (line 32) * -prompt prompts for enter key: Scripting. (line 80) -* -publisher sets publisher id: SetWrite. (line 81) +* -publisher sets publisher id: SetWrite. (line 84) * -pvd_info shows image id strings: Inquiry. (line 78) * -pwd tells working directory in ISO: Navigate. (line 20) * -pwdx tells working directory on disk: Navigate. (line 23) @@ -3794,27 +3797,27 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top * -setfattr_r sets xattr in ISO image: Manip. (line 123) * -show_stream shows data source and filters: Navigate. (line 153) * -show_stream_r shows data source and filters: Navigate. (line 168) -* -speed set write speed: SetWrite. (line 145) +* -speed set write speed: SetWrite. (line 148) * -split_size enables large file splitting: SetInsert. (line 140) * -status shows current settings: Scripting. (line 25) * -status_history_max curbs -status history: Scripting. (line 34) -* -stdio_sync controls stdio buffer: SetWrite. (line 179) -* -stream_recording controls defect management: SetWrite. (line 160) -* -system_id sets system id: SetWrite. (line 93) +* -stdio_sync controls stdio buffer: SetWrite. (line 182) +* -stream_recording controls defect management: SetWrite. (line 163) +* -system_id sets system id: SetWrite. (line 96) * -tell_media_space reports free space: Inquiry. (line 74) * -temp_mem_limit curbs memory consumption: Scripting. (line 70) * -toc shows list of sessions: Inquiry. (line 18) -* -uid sets global ownership: SetWrite. (line 125) +* -uid sets global ownership: SetWrite. (line 128) * -update inserts path if different: Insert. (line 99) * -update_l inserts paths if different: Insert. (line 121) * -update_r inserts paths if different: Insert. (line 110) * -use_readline enables readline for dialog: DialogCtl. (line 24) * -version prints help text: Scripting. (line 19) -* -volid sets volume id: SetWrite. (line 57) -* -volset_id sets volume set id: SetWrite. (line 76) -* -volume_date sets volume timestamp: SetWrite. (line 100) +* -volid sets volume id: SetWrite. (line 60) +* -volset_id sets volume set id: SetWrite. (line 79) +* -volume_date sets volume timestamp: SetWrite. (line 103) * -xattr controls handling of xattr (EA): Loading. (line 136) -* -zisofs controls zisofs production: SetWrite. (line 133) +* -zisofs controls zisofs production: SetWrite. (line 136)  File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top @@ -3844,7 +3847,7 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top * Character Set, _definition: Charset. (line 6) * Character Set, for input, -in_charset: Loading. (line 73) * Character Set, for input/output, -charset: Charset. (line 43) -* Character Set, for output, -out_charset: SetWrite. (line 119) +* Character Set, for output, -out_charset: SetWrite. (line 122) * Character set, learn from image, -auto_charset: Loading. (line 80) * Character Set, of terminal, -local_charset: Charset. (line 47) * Closed media, _definition: Media. (line 39) @@ -3887,8 +3890,8 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top * Filter, show chain, -show_stream: Navigate. (line 153) * Filter, show chains of tree, -show_stream_r: Navigate. (line 168) * Filter, unregister, -unregister_filter: Filter. (line 48) -* Filter, zisofs parameters, -zisofs: SetWrite. (line 133) -* Group, global in ISO image, -gid: SetWrite. (line 129) +* Filter, zisofs parameters, -zisofs: SetWrite. (line 136) +* Group, global in ISO image, -gid: SetWrite. (line 132) * Group, in ISO image, -chgrp: Manip. (line 50) * Group, in ISO image, -chgrp_r: Manip. (line 55) * Growing, _definition: Methods. (line 19) @@ -3896,12 +3899,12 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top * Image, _definition: Model. (line 9) * Image, demand volume id, -assert_volid: Loading. (line 65) * Image, discard pending changes, -rollback: Writing. (line 9) -* Image, set application id, -application_id: SetWrite. (line 87) -* Image, set publisher id, -publisher: SetWrite. (line 81) -* Image, set system id, -system_id: SetWrite. (line 93) -* Image, set volume id, -volid: SetWrite. (line 57) -* Image, set volume set id, -volset_id: SetWrite. (line 76) -* Image, set volume timestamp, -volume_date: SetWrite. (line 100) +* Image, set application id, -application_id: SetWrite. (line 90) +* Image, set publisher id, -publisher: SetWrite. (line 84) +* Image, set system id, -system_id: SetWrite. (line 96) +* Image, set volume id, -volid: SetWrite. (line 60) +* Image, set volume set id, -volset_id: SetWrite. (line 79) +* Image, set volume timestamp, -volume_date: SetWrite. (line 103) * Image, show id strings, -pvd_info: Inquiry. (line 78) * Insert, enable overwriting, -overwrite: SetInsert. (line 127) * Insert, file exclusion absolute, -not_paths: SetInsert. (line 55) @@ -3955,7 +3958,7 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top * Navigate, tell ISO working directory, -pwd: Navigate. (line 20) * Next writeable address, -grow_blindly: AqDrive. (line 44) * Overwriteable media, _definition: Media. (line 10) -* Ownership, global in ISO image, -uid: SetWrite. (line 125) +* Ownership, global in ISO image, -uid: SetWrite. (line 128) * Ownership, in ISO image, -chown: Manip. (line 42) * Ownership, in ISO image, -chown_r: Manip. (line 47) * Partition table, _definiton: Bootable. (line 116) @@ -4023,22 +4026,22 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top * Verify, file checksum, -check_md5: Verify. (line 144) * Verify, file tree checksums, -check_md5_r: Verify. (line 160) * Verify, preset -check_media, -check_media_defaults: Verify. (line 40) -* Write, block size, -dvd_obs: SetWrite. (line 172) +* Write, block size, -dvd_obs: SetWrite. (line 175) * Write, bootability, -boot_image: Bootable. (line 20) -* Write, buffer syncing, -stdio_sync: SetWrite. (line 179) -* Write, close media, -close: SetWrite. (line 196) +* Write, buffer syncing, -stdio_sync: SetWrite. (line 182) +* Write, close media, -close: SetWrite. (line 199) * Write, compliance to specs, -compliance: SetWrite. (line 14) -* Write, defect management, -stream_recording: SetWrite. (line 160) +* Write, defect management, -stream_recording: SetWrite. (line 163) * Write, enable Joliet, -joliet: SetWrite. (line 10) -* Write, fifo size, -fs: SetWrite. (line 189) +* Write, fifo size, -fs: SetWrite. (line 192) * Write, free space, -tell_media_space: Inquiry. (line 74) * Write, log problematic disk files, -errfile_log: Scripting. (line 84) * Write, log written sessions, -session_log: Scripting. (line 104) -* Write, padding image, -padding: SetWrite. (line 202) +* Write, padding image, -padding: SetWrite. (line 205) * Write, pending ISO image, -commit: Writing. (line 13) * Write, predict image size, -print_size: Inquiry. (line 69) -* Write, set speed, -speed: SetWrite. (line 145) -* Write, simulation, -dummy: SetWrite. (line 185) +* Write, set speed, -speed: SetWrite. (line 148) +* Write, simulation, -dummy: SetWrite. (line 188) * xattr, _definiton: Extras. (line 50) * xattr, control handling, -xattr: Loading. (line 136) * xattr, set in ISO image, -setfattr: Manip. (line 110) @@ -4069,38 +4072,38 @@ Node: CmdFind64592 Node: Filter73937 Node: Writing78286 Node: SetWrite84575 -Node: Bootable94707 -Node: Charset102455 -Node: Exception105209 -Node: DialogCtl109724 -Node: Inquiry112069 -Node: Navigate116209 -Node: Verify123563 -Node: Restore131983 -Node: Emulation138639 -Node: Scripting145465 -Node: Frontend151027 -Node: Examples152228 -Node: ExDevices153397 -Node: ExCreate153879 -Node: ExDialog155153 -Node: ExGrowing156415 -Node: ExModifying157217 -Node: ExBootable157718 -Node: ExCharset158265 -Node: ExPseudo159093 -Node: ExCdrecord159987 -Node: ExMkisofs160302 -Node: ExGrowisofs161305 -Node: ExException162429 -Node: ExTime162883 -Node: ExIncBackup163342 -Node: ExRestore166814 -Node: ExRecovery167783 -Node: Files168349 -Node: Seealso169387 -Node: Legal169911 -Node: CommandIdx170833 -Node: ConceptIdx184134 +Node: Bootable94859 +Node: Charset102607 +Node: Exception105361 +Node: DialogCtl109876 +Node: Inquiry112221 +Node: Navigate116361 +Node: Verify123715 +Node: Restore132135 +Node: Emulation138791 +Node: Scripting145660 +Node: Frontend151222 +Node: Examples152423 +Node: ExDevices153592 +Node: ExCreate154074 +Node: ExDialog155348 +Node: ExGrowing156610 +Node: ExModifying157412 +Node: ExBootable157913 +Node: ExCharset158460 +Node: ExPseudo159288 +Node: ExCdrecord160182 +Node: ExMkisofs160497 +Node: ExGrowisofs161500 +Node: ExException162624 +Node: ExTime163078 +Node: ExIncBackup163537 +Node: ExRestore167009 +Node: ExRecovery167978 +Node: Files168544 +Node: Seealso169582 +Node: Legal170106 +Node: CommandIdx171028 +Node: ConceptIdx184329  End Tag Table diff --git a/libisoburn/trunk/xorriso/xorriso.texi b/libisoburn/trunk/xorriso/xorriso.texi index 5b42fdcc..90937f0c 100644 --- a/libisoburn/trunk/xorriso/xorriso.texi +++ b/libisoburn/trunk/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 "Apr 28, 2010" +@c man .TH XORRISO 1 "May 22, 2010" @c man .\" Please adjust this date whenever revising the manpage. @c man .\" @c man .\" Some roff macros, for reference: @@ -2364,6 +2364,9 @@ Default is "old_rr" which uses Rock Ridge version 1.10. This implies also "aaip_susp_1_10" allows AAIP to be written as unofficial extension of RRIP rather than as official extension under SUSP-1.12. @* +"no_emul_toc" saves 64 kB with the first session on overwriteable media +but makes the image incapable of displaying its session history. +@* Default setting is @* "clear:only_iso_version:deep_paths:long_paths:no_j_force_dots: @@ -3796,6 +3799,7 @@ They work like the xorriso options with the same name and hardcoded argument "on", e.g. -acl "on". Explicit arguments are expected by @minus{}@minus{}stdio_sync and @minus{}@minus{}scdbackup_tag. +@minus{}@minus{}no-emul-toc is -compliance no_emul_toc. @* @minus{}@minus{}sort-weight gets as arguments a number and an iso_rr_path. The number becomes the LBA sorting weight of regular file iso_rr_path or