From 0fe94fbf69a9b8f433df1d167b72a6847c0caac4 Mon Sep 17 00:00:00 2001 From: Thomas Schmitt Date: Mon, 5 Nov 2012 10:11:02 +0000 Subject: [PATCH] Corrections in xorriso manual. Proposed by Paul Menzel. --- libisoburn/trunk/xorriso/xorriso.1 | 6 +- libisoburn/trunk/xorriso/xorriso.info | 165 +++++++++++++------------- libisoburn/trunk/xorriso/xorriso.texi | 6 +- 3 files changed, 91 insertions(+), 86 deletions(-) diff --git a/libisoburn/trunk/xorriso/xorriso.1 b/libisoburn/trunk/xorriso/xorriso.1 index b215ed68..557d31d8 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 "Version 1.2.5, Oct 23, 2012" +.TH XORRISO 1 "Version 1.2.5, Nov 05, 2012" .\" Please adjust this date whenever revising the manpage. .\" .\" Some roff macros, for reference: @@ -2467,7 +2467,9 @@ The name must not contain a '/' character and must not be longer than 255 bytes. .TP \fB\-volid\fR text -Specify the volume ID, which can be considered to be the name of the image. +Specify the volume ID, which most operating systems will consider to be +the volume name of the image or medium. +.br \fBxorriso\fR accepts any text up to 32 characters, but according to rarely obeyed specs stricter rules apply: .br diff --git a/libisoburn/trunk/xorriso/xorriso.info b/libisoburn/trunk/xorriso/xorriso.info index accfafe8..729b394a 100644 --- a/libisoburn/trunk/xorriso/xorriso.info +++ b/libisoburn/trunk/xorriso/xorriso.info @@ -2193,9 +2193,10 @@ according to the setting of command -acl. than 255 bytes. -volid text - Specify the volume ID, which can be considered to be the name of - the image. `xorriso' accepts any text up to 32 characters, but - according to rarely obeyed specs stricter rules apply: + Specify the volume ID, which most operating systems will consider + to be the volume name of the image or medium. + `xorriso' accepts any text up to 32 characters, but according to + rarely obeyed specs stricter rules apply: ECMA-119 demands ASCII characters out of [A-Z0-9_]. Like: "IMAGE_23" Joliet allows 16 UCS-2 characters. Like: @@ -4530,7 +4531,7 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top * # starts a comment line: Scripting. (line 162) * -abort_on controls abort on error: Exception. (line 27) -* -abstract_file sets abstract file name: SetWrite. (line 232) +* -abstract_file sets abstract file name: SetWrite. (line 233) * -acl controls handling of ACLs: Loading. (line 143) * -add inserts one or more paths: Insert. (line 45) * -add_plainly inserts one or more paths: Insert. (line 64) @@ -4538,13 +4539,13 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top * -alter_date_r sets timestamps in ISO image: Manip. (line 167) * -append_partition adds arbitrary file after image end: Bootable. (line 234) -* -application_id sets application id: SetWrite. (line 191) +* -application_id sets application id: SetWrite. (line 192) * -as emulates mkisofs or cdrecord: Emulation. (line 13) * -assert_volid rejects undesired images: Loading. (line 84) * -auto_charset learns character set from image: Loading. (line 98) * -backslash_codes enables backslash conversion: Scripting. (line 67) * -ban_stdio_write demands real drive: Loading. (line 251) -* -biblio_file sets biblio file name: SetWrite. (line 239) +* -biblio_file sets biblio file name: SetWrite. (line 240) * -blank erases media: Writing. (line 61) * -boot_image controls bootability: Bootable. (line 26) * -calm_drive reduces drive activity: Loading. (line 240) @@ -4563,7 +4564,7 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top * -chown sets ownership in ISO image: Manip. (line 42) * -chown_r sets ownership in ISO image: Manip. (line 47) * -clone copies ISO directory tree: Insert. (line 179) -* -close controls media closing: SetWrite. (line 334) +* -close controls media closing: SetWrite. (line 335) * -close_damaged closes damaged track and session: Writing. (line 155) * -close_filter_list bans filter registration: Filter. (line 52) * -commit writes pending ISO image: Writing. (line 29) @@ -4572,7 +4573,7 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top * -compare_l reports ISO/disk differences: Navigate. (line 164) * -compare_r reports ISO/disk differences: Navigate. (line 159) * -compliance controls standard compliance: SetWrite. (line 58) -* -copyright_file sets copyright file name: SetWrite. (line 226) +* -copyright_file sets copyright file name: SetWrite. (line 227) * -cp_clone copies ISO directory tree: Insert. (line 191) * -cp_rx copies file trees to disk: Restore. (line 108) * -cpax copies files to disk: Restore. (line 104) @@ -4590,11 +4591,11 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top (line 36) * -drive_class controls drive accessability: Loading. (line 54) * -du show directory size in ISO image: Navigate. (line 89) -* -dummy controls write simulation: SetWrite. (line 323) +* -dummy controls write simulation: SetWrite. (line 324) * -dus show directory size in ISO image: Navigate. (line 93) * -dusx show directory size on disk: Navigate. (line 102) * -dux show directory size on disk: Navigate. (line 97) -* -dvd_obs set write block size: SetWrite. (line 310) +* -dvd_obs set write block size: SetWrite. (line 311) * -early_stdio_test classifies stdio drives: Loading. (line 256) * -eject ejects drive tray: Writing. (line 52) * -end writes pending session and ends program: Scripting. (line 156) @@ -4612,12 +4613,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 185) * -format formats media: Writing. (line 91) -* -fs sets size of fifo: SetWrite. (line 327) +* -fs sets size of fifo: SetWrite. (line 328) * -getfacl shows ACL in ISO image: Navigate. (line 70) * -getfacl_r shows ACL in ISO image: Navigate. (line 77) * -getfattr shows xattr in ISO image: Navigate. (line 81) * -getfattr_r shows xattr in ISO image: Navigate. (line 85) -* -gid sets global ownership: SetWrite. (line 267) +* -gid sets global ownership: SetWrite. (line 268) * -grow_blindly overides next writeable address: AqDrive. (line 46) * -hardlinks controls handling of hard links: Loading. (line 110) * -help prints help text: Scripting. (line 20) @@ -4665,17 +4666,17 @@ 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 257) +* -out_charset sets output character set: SetWrite. (line 258) * -outdev acquires a drive for output: AqDrive. (line 31) * -overwrite enables overwriting in ISO: SetInsert. (line 127) * -pacifier controls pacifier text form: Emulation. (line 158) -* -padding sets amount or mode of image padding: SetWrite. (line 348) +* -padding sets amount or mode of image padding: SetWrite. (line 349) * -page set terminal geometry: DialogCtl. (line 19) * -paste_in copies file into disk file: Restore. (line 121) * -path_list inserts paths from disk file: Insert. (line 78) * -pathspecs sets meaning of = with -add: SetInsert. (line 118) * -pkt_output consolidates text output: Frontend. (line 7) -* -preparer_id sets preparer id: SetWrite. (line 245) +* -preparer_id sets preparer id: SetWrite. (line 246) * -print prints result text line: Scripting. (line 99) * -print_info prints message text line: Scripting. (line 102) * -print_mark prints synchronizing text line: Scripting. (line 105) @@ -4683,7 +4684,7 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top * -prog sets program name: Frontend. (line 30) * -prog_help prints help text: Frontend. (line 33) * -prompt prompts for enter key: Scripting. (line 110) -* -publisher sets publisher id: SetWrite. (line 185) +* -publisher sets publisher id: SetWrite. (line 186) * -pvd_info shows image id strings: Inquiry. (line 93) * -pwd tells working directory in ISO: Navigate. (line 20) * -pwdx tells working directory on disk: Navigate. (line 23) @@ -4721,30 +4722,30 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top * -signal_handling controls handling of system signals: Exception. (line 69) * -sleep waits for a given time span: Scripting. (line 114) -* -speed set write speed: SetWrite. (line 283) +* -speed set write speed: SetWrite. (line 284) * -split_size enables large file splitting: SetInsert. (line 140) * -status shows current settings: Scripting. (line 47) * -status_history_max curbs -status history: Scripting. (line 56) -* -stdio_sync controls stdio buffer: SetWrite. (line 317) -* -stream_recording controls defect management: SetWrite. (line 298) -* -system_id sets system id: SetWrite. (line 200) +* -stdio_sync controls stdio buffer: SetWrite. (line 318) +* -stream_recording controls defect management: SetWrite. (line 299) +* -system_id sets system id: SetWrite. (line 201) * -tell_media_space reports free space: Inquiry. (line 89) * -temp_mem_limit curbs memory consumption: Scripting. (line 92) * -toc shows list of sessions: Inquiry. (line 28) -* -uid sets global ownership: SetWrite. (line 263) +* -uid sets global ownership: SetWrite. (line 264) * -update inserts path if different: Insert. (line 102) * -update_l inserts paths if different: Insert. (line 124) * -update_r inserts paths if different: Insert. (line 113) * -use_readline enables readline for dialog: DialogCtl. (line 28) * -version prints help text: Scripting. (line 23) * -volid sets volume id: SetWrite. (line 160) -* -volset_id sets volume set id: SetWrite. (line 180) -* -volume_date sets volume timestamp: SetWrite. (line 207) -* -write_type chooses TAO or SAO/DAO: SetWrite. (line 340) +* -volset_id sets volume set id: SetWrite. (line 181) +* -volume_date sets volume timestamp: SetWrite. (line 208) +* -write_type chooses TAO or SAO/DAO: SetWrite. (line 341) * -x enables automatic execution order of arguments: ArgSort. (line 16) * -xattr controls handling of xattr (EA): Loading. (line 151) -* -zisofs controls zisofs production: SetWrite. (line 271) +* -zisofs controls zisofs production: SetWrite. (line 272)  File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top @@ -4779,7 +4780,7 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top * Character Set, _definition: Charset. (line 6) * Character Set, for input, -in_charset: Loading. (line 92) * Character Set, for input/output, -charset: Charset. (line 43) -* Character Set, for output, -out_charset: SetWrite. (line 257) +* Character Set, for output, -out_charset: SetWrite. (line 258) * Character set, learn from image, -auto_charset: Loading. (line 98) * Character Set, of terminal, -local_charset: Charset. (line 47) * CHRP partition, _definition: Bootable. (line 148) @@ -4836,9 +4837,9 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top * Filter, show chain, -show_stream: Navigate. (line 169) * Filter, show chains of tree, -show_stream_r: Navigate. (line 183) * Filter, unregister, -unregister_filter: Filter. (line 48) -* Filter, zisofs parameters, -zisofs: SetWrite. (line 271) +* Filter, zisofs parameters, -zisofs: SetWrite. (line 272) * GPT, _definition: Extras. (line 38) -* Group, global in ISO image, -gid: SetWrite. (line 267) +* Group, global in ISO image, -gid: SetWrite. (line 268) * Group, in ISO image, -chgrp: Manip. (line 50) * Group, in ISO image, -chgrp_r: Manip. (line 55) * Growing, _definition: Methods. (line 19) @@ -4851,16 +4852,16 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top * Image, demand volume ID, -assert_volid: Loading. (line 84) * Image, discard pending changes, -rollback: Writing. (line 9) * Image, override change status, -changes_pending: Writing. (line 13) -* Image, set abstract file name, -abstract_file: SetWrite. (line 232) -* Image, set application id, -application_id: SetWrite. (line 191) -* Image, set biblio file name, -biblio_file: SetWrite. (line 239) -* Image, set copyright file name, -copyright_file: SetWrite. (line 226) -* Image, set preparer id, -preparer_id: SetWrite. (line 245) -* Image, set publisher id, -publisher: SetWrite. (line 185) -* Image, set system id, -system_id: SetWrite. (line 200) +* Image, set abstract file name, -abstract_file: SetWrite. (line 233) +* Image, set application id, -application_id: SetWrite. (line 192) +* Image, set biblio file name, -biblio_file: SetWrite. (line 240) +* Image, set copyright file name, -copyright_file: SetWrite. (line 227) +* Image, set preparer id, -preparer_id: SetWrite. (line 246) +* Image, set publisher id, -publisher: SetWrite. (line 186) +* Image, set system id, -system_id: SetWrite. (line 201) * Image, set volume id, -volid: SetWrite. (line 160) -* Image, set volume set id, -volset_id: SetWrite. (line 180) -* Image, set volume timestamp, -volume_date: SetWrite. (line 207) +* Image, set volume set id, -volset_id: SetWrite. (line 181) +* Image, set volume timestamp, -volume_date: SetWrite. (line 208) * Image, show id strings, -pvd_info: Inquiry. (line 93) * Insert, enable overwriting, -overwrite: SetInsert. (line 127) * Insert, file exclusion absolute, -not_paths: SetInsert. (line 55) @@ -4919,7 +4920,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 46) * Overwriteable media, _definition: Media. (line 14) -* Ownership, global in ISO image, -uid: SetWrite. (line 263) +* Ownership, global in ISO image, -uid: SetWrite. (line 264) * Ownership, in ISO image, -chown: Manip. (line 42) * Ownership, in ISO image, -chown_r: Manip. (line 47) * Partition offset, _definition: Bootable. (line 167) @@ -5001,25 +5002,25 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top * Verify, file checksum, -check_md5: Verify. (line 154) * Verify, file tree checksums, -check_md5_r: Verify. (line 170) * Verify, preset -check_media, -check_media_defaults: Verify. (line 41) -* Write, block size, -dvd_obs: SetWrite. (line 310) +* Write, block size, -dvd_obs: SetWrite. (line 311) * Write, bootability, -boot_image: Bootable. (line 26) -* Write, buffer syncing, -stdio_sync: SetWrite. (line 317) -* Write, close media, -close: SetWrite. (line 334) +* Write, buffer syncing, -stdio_sync: SetWrite. (line 318) +* Write, close media, -close: SetWrite. (line 335) * Write, compliance to specs, -compliance: SetWrite. (line 58) -* Write, defect management, -stream_recording: SetWrite. (line 298) +* Write, defect management, -stream_recording: SetWrite. (line 299) * Write, disable Rock Ridge, -rockridge: SetWrite. (line 52) * Write, enable HFS+, -hfsplus: SetWrite. (line 14) * Write, enable Joliet, -joliet: SetWrite. (line 10) -* Write, fifo size, -fs: SetWrite. (line 327) +* Write, fifo size, -fs: SetWrite. (line 328) * Write, free space, -tell_media_space: Inquiry. (line 89) * Write, log problematic disk files, -errfile_log: Scripting. (line 118) * Write, log written sessions, -session_log: Scripting. (line 138) -* Write, padding image, -padding: SetWrite. (line 348) +* Write, padding image, -padding: SetWrite. (line 349) * Write, pending ISO image, -commit: Writing. (line 29) * Write, predict image size, -print_size: Inquiry. (line 80) -* Write, set speed, -speed: SetWrite. (line 283) -* Write, simulation, -dummy: SetWrite. (line 323) -* Write, TAO or SAO/DAO, -write_type: SetWrite. (line 340) +* Write, set speed, -speed: SetWrite. (line 284) +* Write, simulation, -dummy: SetWrite. (line 324) +* Write, TAO or SAO/DAO, -write_type: SetWrite. (line 341) * xattr, _definition: Extras. (line 65) * xattr, control handling, -xattr: Loading. (line 151) * xattr, set in ISO image, -setfattr: Manip. (line 111) @@ -5051,40 +5052,40 @@ Node: CmdFind73688 Node: Filter88393 Node: Writing92949 Node: SetWrite102128 -Node: Bootable120831 -Node: Jigdo136225 -Node: Charset140472 -Node: Exception143234 -Node: DialogCtl149354 -Node: Inquiry151952 -Node: Navigate156819 -Node: Verify165117 -Node: Restore174149 -Node: Emulation181059 -Node: Scripting190871 -Node: Frontend198032 -Node: Examples199333 -Node: ExDevices200511 -Node: ExCreate201170 -Node: ExDialog202455 -Node: ExGrowing203720 -Node: ExModifying204525 -Node: ExBootable205029 -Node: ExCharset205581 -Node: ExPseudo206402 -Node: ExCdrecord207300 -Node: ExMkisofs207617 -Node: ExGrowisofs208957 -Node: ExException210092 -Node: ExTime210546 -Node: ExIncBackup211005 -Node: ExRestore214997 -Node: ExRecovery215957 -Node: Files216527 -Node: Seealso217826 -Node: Bugreport218549 -Node: Legal219130 -Node: CommandIdx220141 -Node: ConceptIdx236086 +Node: Bootable120871 +Node: Jigdo136265 +Node: Charset140512 +Node: Exception143274 +Node: DialogCtl149394 +Node: Inquiry151992 +Node: Navigate156859 +Node: Verify165157 +Node: Restore174189 +Node: Emulation181099 +Node: Scripting190911 +Node: Frontend198072 +Node: Examples199373 +Node: ExDevices200551 +Node: ExCreate201210 +Node: ExDialog202495 +Node: ExGrowing203760 +Node: ExModifying204565 +Node: ExBootable205069 +Node: ExCharset205621 +Node: ExPseudo206442 +Node: ExCdrecord207340 +Node: ExMkisofs207657 +Node: ExGrowisofs208997 +Node: ExException210132 +Node: ExTime210586 +Node: ExIncBackup211045 +Node: ExRestore215037 +Node: ExRecovery215997 +Node: Files216567 +Node: Seealso217866 +Node: Bugreport218589 +Node: Legal219170 +Node: CommandIdx220181 +Node: ConceptIdx236126  End Tag Table diff --git a/libisoburn/trunk/xorriso/xorriso.texi b/libisoburn/trunk/xorriso/xorriso.texi index a00fbc2d..2282f672 100644 --- a/libisoburn/trunk/xorriso/xorriso.texi +++ b/libisoburn/trunk/xorriso/xorriso.texi @@ -50,7 +50,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 "Version 1.2.5, Oct 23, 2012" +@c man .TH XORRISO 1 "Version 1.2.5, Nov 05, 2012" @c man .\" Please adjust this date whenever revising the manpage. @c man .\" @c man .\" Some roff macros, for reference: @@ -2924,7 +2924,9 @@ The name must not contain a '/' character and must not be longer than @item -volid text @kindex -volid sets volume id @cindex Image, set volume id, -volid -Specify the volume ID, which can be considered to be the name of the image. +Specify the volume ID, which most operating systems will consider to be +the volume name of the image or medium. +@* @command{xorriso} accepts any text up to 32 characters, but according to rarely obeyed specs stricter rules apply: @*