From 7353d3534ed41a2611d2f9e7eec6752af322934c Mon Sep 17 00:00:00 2001 From: Thomas Schmitt Date: Mon, 5 Nov 2012 09:37:47 +0000 Subject: [PATCH] Corrections in xorriso manual. Proposed by Paul Menzel. --- libisoburn/trunk/xorriso/xorriso.1 | 49 +++-- libisoburn/trunk/xorriso/xorriso.info | 287 +++++++++++++------------- libisoburn/trunk/xorriso/xorriso.texi | 105 +++++----- 3 files changed, 226 insertions(+), 215 deletions(-) diff --git a/libisoburn/trunk/xorriso/xorriso.1 b/libisoburn/trunk/xorriso/xorriso.1 index 9c6ed649..b215ed68 100644 --- a/libisoburn/trunk/xorriso/xorriso.1 +++ b/libisoburn/trunk/xorriso/xorriso.1 @@ -771,7 +771,7 @@ prevent inadverted mishaps. For reliably blocking access to a device file you have to deny its rw\-permissions in the filesystem. .TP \fB\-assert_volid\fR pattern severity -Refuse to load ISO images with volume ids which do not match the given +Refuse to load ISO images with volume IDs which do not match the given search pattern. When refusing an image, give up the input drive and issue an event of the given severity (like FAILURE, see \-abort_on). An empty search pattern accepts any image. @@ -2467,49 +2467,54 @@ The name must not contain a '/' character and must not be longer than 255 bytes. .TP \fB\-volid\fR text -Specify the volume ID. \fBxorriso\fR accepts any text up to 32 characters, +Specify the volume ID, which can be considered to be the name of the image. +\fBxorriso\fR accepts any text up to 32 characters, but according to rarely obeyed specs stricter rules apply: .br -ECMA\-119 demands ASCII characters out of [A\-Z0\-9_]. Like: "IMAGE_23" +ECMA\-119 demands ASCII characters out of [A\-Z0\-9_]. Like: .br -Joliet allows 16 UCS\-2 characters. Like: "Windows name" + "IMAGE_23" .br -Be aware that the volume id might get used automatically as name of the +Joliet allows 16 UCS\-2 characters. Like: +.br + "Windows name" +.br +Be aware that the volume id might get used automatically as the name of the mount point when the medium is inserted into a playful computer system. .br If an ISO image gets loaded while the volume ID is set to default "ISOIMAGE" or to "", then the volume ID of the loaded image will become the effective volume id for the next write run. But as soon as command \-volid is performed -afterwards, this pending id is overridden by the new setting. +afterwards, this pending ID is overridden by the new setting. .br Consider this when setting \-volid "ISOIMAGE" before executing \-dev, \-indev, or \-rollback. If you insist in \-volid "ISOIMAGE", set it again after those commands. .TP \fB\-volset_id\fR text -Set the volume set id string to be written with the next \-commit. +Set the volume set ID string to be written with the next \-commit. Permissible are up to 128 characters. This setting gets overridden by image loading. .TP \fB\-publisher\fR text -Set the publisher id string to be written with the next \-commit. This may +Set the publisher ID string to be written with the next \-commit. This may identify the person or organisation who specified what shall be recorded. Permissible are up to 128 characters. This setting gets overridden by image loading. .TP \fB\-application_id\fR text -Set the application id string to be written with the next \-commit. This may +Set the application ID string to be written with the next \-commit. This may identify the specification of how the data are recorded. Permissible are up to 128 characters. This setting gets overridden by image loading. .br -The special text "@xorriso@" gets converted to the id string of +The special text "@xorriso@" gets converted to the ID string of \fBxorriso\fR which is normally written as \-preparer_id. It is a wrong tradition to write -the program id as \-application_id. +the program ID as \-application_id. .TP \fB\-system_id\fR text -Set the system id string to be written with the next \-commit. This may +Set the system ID string to be written with the next \-commit. This may identify the system which can recognize and act upon the content of the System Area in image blocks 0 to 15. Permissible are up to 32 characters. This setting gets overridden by @@ -2564,16 +2569,16 @@ Permissible are up to 37 characters. This setting gets overridden by image loading. .TP \fB\-preparer_id\fR -Set the preparer id string to be written with the next \-commit. This may +Set the preparer ID string to be written with the next \-commit. This may identify the person or other entity which controls the preparation of the data -which shall be recorded. Normally this should be the id of \fBxorriso\fR +which shall be recorded. Normally this should be the ID of \fBxorriso\fR and not of the person or program which operates \fBxorriso\fR. Please avoid to change it. Permissible are up to 128 characters. .br -The special text "@xorriso@" gets converted to the id string of +The special text "@xorriso@" gets converted to the ID string of \fBxorriso\fR which is default at program startup. .br -Unlike other id strings, this setting is not influenced by image loading. +Unlike other ID strings, this setting is not influenced by image loading. .TP \fB\-out_charset\fR character_set_name Set the character set to which file names get converted when writing an @@ -3474,9 +3479,9 @@ Print available space on the output medium and the free space after subtracting already foreseeable consumption by next \-commit. .TP \fB\-pvd_info\fR -Print various id strings which can be found in loaded ISO images. Some of +Print various ID strings which can be found in loaded ISO images. Some of them may be changed by commands like \-volid or \-publisher. For these -ids \-pvd_info reports what would be written with the next \-commit. +IDs \-pvd_info reports what would be written with the next \-commit. .TP .B Navigation in ISO image and disk filesystem: .TP @@ -3820,7 +3825,7 @@ and their start block addresses, followed by binary bitmap data. .br \fBmap_with_volid="on"\fR examines tracks whether they are ISO images and -prints their volume ids into the human readable TOC of sector_map=. +prints their volume IDs into the human readable TOC of sector_map=. .br \fBpatch_lba0="on"\fR transfers within the data_to= file a copy of the currently @@ -4400,11 +4405,11 @@ This transport becomes visible with \-report_about "ALL". If path is not empty it gives the address of a plain text file where a log record gets appended after each session. This log can be used to determine the start_lba of a session for mount options \-o sbsector= -resp. \-s from date or volume id. +resp. \-s from date or volume ID. .br Record format is: timestamp start_lba size volume\-id .br -The first three items are single words, the rest of the line is the volume id. +The first three items are single words, the rest of the line is the volume ID. .TP \fB\-scsi_log\fR "on"|"off" Mode "on" enables very verbous logging of SCSI commands and drive replies. @@ -4840,7 +4845,7 @@ accordingly. .br ACL, xattr, hard links and MD5 checksums will be recorded. Accelerated comparison is enabled at the expense of potentially larger backup -size. Only media with the expected volume id or blank media are accepted. +size. Only media with the expected volume ID or blank media are accepted. Files with names matching *.o or *.swp get excluded explicitly. .br When done with writing the new session gets checked by its recorded MD5. diff --git a/libisoburn/trunk/xorriso/xorriso.info b/libisoburn/trunk/xorriso/xorriso.info index 1893fe5f..accfafe8 100644 --- a/libisoburn/trunk/xorriso/xorriso.info +++ b/libisoburn/trunk/xorriso/xorriso.info @@ -31,7 +31,7 @@ images with Rock Ridge extensions. * Extras:: Rock Ridge, POSIX, X/Open, El Torito, ACL, xattr * Processing:: Command processing * Dialog:: Dialog, Readline, Result pager -* Options:: Reference of commands +* Commands:: Reference of commands * Examples:: Examples * Files:: Files * Seealso:: See also @@ -467,7 +467,7 @@ arguments if dialog mode has not been enabled at that point, or by a problem event which triggers the threshold of command -abort_on.  -File: xorriso.info, Node: Dialog, Next: Options, Prev: Processing, Up: Top +File: xorriso.info, Node: Dialog, Next: Commands, Prev: Processing, Up: Top 8 Dialog, Readline, Result pager ******************************** @@ -502,10 +502,10 @@ The request to abort may or may not be obeyed by the current action. All actions try to abort as soon as possible.  -File: xorriso.info, Node: Options, Next: Examples, Prev: Dialog, Up: Top +File: xorriso.info, Node: Commands, Next: Examples, Prev: Dialog, Up: Top -9 Options -********* +9 Commands +********** All command words are shown with a leading dash although this dash is not mandatory for the command to be recognized. Nevertheless within @@ -539,7 +539,7 @@ inner dashes are interpreted as underscores. * Frontend:: Support for frontend programs via stdin and stdout  -File: xorriso.info, Node: ArgSort, Next: AqDrive, Prev: Options, Up: Options +File: xorriso.info, Node: ArgSort, Next: AqDrive, Prev: Commands, Up: Commands 9.1 Execution order of program arguments ======================================== @@ -572,7 +572,7 @@ loss of expressivity. listed sorting order may well make sense, though.  -File: xorriso.info, Node: AqDrive, Next: Loading, Prev: ArgSort, Up: Options +File: xorriso.info, Node: AqDrive, Next: Loading, Prev: ArgSort, Up: Commands 9.2 Acquiring source and target drive ===================================== @@ -632,7 +632,7 @@ commands which acquire the drive. output begins. The output drive is given up when writing is done.  -File: xorriso.info, Node: Loading, Next: Insert, Prev: AqDrive, Up: Options +File: xorriso.info, Node: Loading, Next: Insert, Prev: AqDrive, Up: Commands 9.3 Influencing the behavior of image loading ============================================= @@ -715,7 +715,7 @@ activate them only after image loading. filesystem. -assert_volid pattern severity - Refuse to load ISO images with volume ids which do not match the + Refuse to load ISO images with volume IDs which do not match the given search pattern. When refusing an image, give up the input drive and issue an event of the given severity (like FAILURE, see -abort_on). An empty search pattern accepts any image. @@ -915,7 +915,7 @@ activate them only after image loading. numbers. Currently the default is 32 tiles of 32 blocks = 2 MiB.  -File: xorriso.info, Node: Insert, Next: SetInsert, Prev: Loading, Up: Options +File: xorriso.info, Node: Insert, Next: SetInsert, Prev: Loading, Up: Commands 9.4 Inserting files into ISO image ================================== @@ -1116,7 +1116,7 @@ filesystem. depend on the number of iso_rr_path_original parameters.  -File: xorriso.info, Node: SetInsert, Next: Manip, Prev: Insert, Up: Options +File: xorriso.info, Node: SetInsert, Next: Manip, Prev: Insert, Up: Commands 9.5 Settings for file insertion =============================== @@ -1285,7 +1285,7 @@ File: xorriso.info, Node: SetInsert, Next: Manip, Prev: Insert, Up: Options overlap.  -File: xorriso.info, Node: Manip, Next: CmdFind, Prev: SetInsert, Up: Options +File: xorriso.info, Node: Manip, Next: CmdFind, Prev: SetInsert, Up: Commands 9.6 File manipulations ====================== @@ -1471,7 +1471,7 @@ whether they stem from the loaded image or were newly inserted. -boot_image "any" "cat_hidden=on"  -File: xorriso.info, Node: CmdFind, Next: Filter, Prev: Manip, Up: Options +File: xorriso.info, Node: CmdFind, Next: Filter, Prev: Manip, Up: Commands 9.7 Tree traversal command -find ================================ @@ -1769,7 +1769,7 @@ File: xorriso.info, Node: CmdFind, Next: Filter, Prev: Manip, Up: Options chmod a-w,a+r --  -File: xorriso.info, Node: Filter, Next: Writing, Prev: CmdFind, Up: Options +File: xorriso.info, Node: Filter, Next: Writing, Prev: CmdFind, Up: Commands 9.8 Filters for data file content ================================= @@ -1861,7 +1861,7 @@ there are many small files. directories.  -File: xorriso.info, Node: Writing, Next: SetWrite, Prev: Filter, Up: Options +File: xorriso.info, Node: Writing, Next: SetWrite, Prev: Filter, Up: Commands 9.9 Writing the result, drive control ===================================== @@ -2034,7 +2034,7 @@ File: xorriso.info, Node: Writing, Next: SetWrite, Prev: Filter, Up: Options "(current)".  -File: xorriso.info, Node: SetWrite, Next: Bootable, Prev: Writing, Up: Options +File: xorriso.info, Node: SetWrite, Next: Bootable, Prev: Writing, Up: Commands 9.10 Settings for result writing ================================ @@ -2193,46 +2193,47 @@ according to the setting of command -acl. than 255 bytes. -volid text - Specify the volume ID. `xorriso' accepts any text up to 32 - characters, but according to rarely obeyed specs stricter rules - apply: + 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: ECMA-119 demands ASCII characters out of [A-Z0-9_]. Like: "IMAGE_23" - Joliet allows 16 UCS-2 characters. Like: "Windows name" - Be aware that the volume id might get used automatically as name - of the mount point when the medium is inserted into a playful + Joliet allows 16 UCS-2 characters. Like: + "Windows name" + Be aware that the volume id might get used automatically as the + name of the mount point when the medium is inserted into a playful computer system. If an ISO image gets loaded while the volume ID is set to default "ISOIMAGE" or to "", then the volume ID of the loaded image will become the effective volume id for the next write run. But as soon - as command -volid is performed afterwards, this pending id is + as command -volid is performed afterwards, this pending ID is overridden by the new setting. Consider this when setting -volid "ISOIMAGE" before executing -dev, -indev, or -rollback. If you insist in -volid "ISOIMAGE", set it again after those commands. -volset_id text - Set the volume set id string to be written with the next -commit. + Set the volume set ID string to be written with the next -commit. Permissible are up to 128 characters. This setting gets overridden by image loading. -publisher text - Set the publisher id string to be written with the next -commit. + Set the publisher ID string to be written with the next -commit. This may identify the person or organisation who specified what shall be recorded. Permissible are up to 128 characters. This setting gets overridden by image loading. -application_id text - Set the application id string to be written with the next -commit. + Set the application ID string to be written with the next -commit. This may identify the specification of how the data are recorded. Permissible are up to 128 characters. This setting gets overridden by image loading. - The special text "@xorriso@" gets converted to the id string of + The special text "@xorriso@" gets converted to the ID string of `xorriso' which is normally written as -preparer_id. It is a wrong - tradition to write the program id as -application_id. + tradition to write the program ID as -application_id. -system_id text - Set the system id string to be written with the next -commit. This + Set the system ID string to be written with the next -commit. This may identify the system which can recognize and act upon the content of the System Area in image blocks 0 to 15. Permissible are up to 32 characters. This setting gets overridden by image @@ -2277,15 +2278,15 @@ according to the setting of command -acl. setting gets overridden by image loading. -preparer_id - Set the preparer id string to be written with the next -commit. + Set the preparer ID string to be written with the next -commit. This may identify the person or other entity which controls the preparation of the data which shall be recorded. Normally this - should be the id of `xorriso' and not of the person or program + should be the ID of `xorriso' and not of the person or program which operates `xorriso'. Please avoid to change it. Permissible are up to 128 characters. - The special text "@xorriso@" gets converted to the id string of + The special text "@xorriso@" gets converted to the ID string of `xorriso' which is default at program startup. - Unlike other id strings, this setting is not influenced by image + Unlike other ID strings, this setting is not influenced by image loading. -out_charset character_set_name @@ -2394,7 +2395,7 @@ according to the setting of command -acl. by -padding mode "included".  -File: xorriso.info, Node: Bootable, Next: Jigdo, Prev: SetWrite, Up: Options +File: xorriso.info, Node: Bootable, Next: Jigdo, Prev: SetWrite, Up: Commands 9.11 Bootable ISO images ======================== @@ -2656,7 +2657,7 @@ filesystem and announced by an MBR partition table entry. the next lower valid one.  -File: xorriso.info, Node: Jigdo, Next: Charset, Prev: Bootable, Up: Options +File: xorriso.info, Node: Jigdo, Next: Charset, Prev: Bootable, Up: Commands 9.12 Jigdo Template Extraction ============================== @@ -2735,7 +2736,7 @@ emulation, and padding will be counted as part of the ISO image. Alias: -checksum_algorithm_template  -File: xorriso.info, Node: Charset, Next: Exception, Prev: Jigdo, Up: Options +File: xorriso.info, Node: Charset, Next: Exception, Prev: Jigdo, Up: Commands 9.13 Character sets =================== @@ -2787,7 +2788,7 @@ display on your terminal. being sent to the terminal.  -File: xorriso.info, Node: Exception, Next: DialogCtl, Prev: Charset, Up: Options +File: xorriso.info, Node: Exception, Next: DialogCtl, Prev: Charset, Up: Commands 9.14 Exception processing ========================= @@ -2902,7 +2903,7 @@ failed unexpectedly. filtered.  -File: xorriso.info, Node: DialogCtl, Next: Inquiry, Prev: Exception, Up: Options +File: xorriso.info, Node: DialogCtl, Next: Inquiry, Prev: Exception, Up: Commands 9.15 Dialog mode control ======================== @@ -2957,7 +2958,7 @@ File: xorriso.info, Node: DialogCtl, Next: Inquiry, Prev: Exception, Up: Opt session.  -File: xorriso.info, Node: Inquiry, Next: Navigate, Prev: DialogCtl, Up: Options +File: xorriso.info, Node: Inquiry, Next: Navigate, Prev: DialogCtl, Up: Commands 9.16 Drive and media related inquiry actions ============================================ @@ -3049,13 +3050,13 @@ File: xorriso.info, Node: Inquiry, Next: Navigate, Prev: DialogCtl, Up: Opti subtracting already foreseeable consumption by next -commit. -pvd_info - Print various id strings which can be found in loaded ISO images. + Print various ID strings which can be found in loaded ISO images. Some of them may be changed by commands like -volid or -publisher. - For these ids -pvd_info reports what would be written with the + For these IDs -pvd_info reports what would be written with the next -commit.  -File: xorriso.info, Node: Navigate, Next: Verify, Prev: Inquiry, Up: Options +File: xorriso.info, Node: Navigate, Next: Verify, Prev: Inquiry, Up: Commands 9.17 Navigation in ISO image and disk filesystem ================================================ @@ -3240,7 +3241,7 @@ File: xorriso.info, Node: Navigate, Next: Verify, Prev: Inquiry, Up: Options Like -show_stream but working recursively.  -File: xorriso.info, Node: Verify, Next: Restore, Prev: Navigate, Up: Options +File: xorriso.info, Node: Verify, Next: Restore, Prev: Navigate, Up: Commands 9.18 Evaluation of readability and recovery =========================================== @@ -3359,7 +3360,7 @@ transmission errors. start block addresses, followed by binary bitmap data. map_with_volid="on" examines tracks whether they are ISO images and prints their - volume ids into the human readable TOC of sector_map=. + volume IDs into the human readable TOC of sector_map=. patch_lba0="on" transfers within the data_to= file a copy of the currently loaded session head to the start of that file and patches it @@ -3413,7 +3414,7 @@ transmission errors. paths. Only mismatching data files will be reported.  -File: xorriso.info, Node: Restore, Next: Emulation, Prev: Verify, Up: Options +File: xorriso.info, Node: Restore, Next: Emulation, Prev: Verify, Up: Commands 9.19 osirrox ISO-to-disk restore commands ========================================= @@ -3546,7 +3547,7 @@ The directory permissions on disk have to allow rwx. /sbin/mount.  -File: xorriso.info, Node: Emulation, Next: Scripting, Prev: Restore, Up: Options +File: xorriso.info, Node: Emulation, Next: Scripting, Prev: Restore, Up: Commands 9.20 Command compatibility emulations (cdrtools) ================================================ @@ -3724,7 +3725,7 @@ said programs trigger comparable actions. record.  -File: xorriso.info, Node: Scripting, Next: Frontend, Prev: Emulation, Up: Options +File: xorriso.info, Node: Scripting, Next: Frontend, Prev: Emulation, Up: Commands 9.21 Scripting, dialog and program control features =================================================== @@ -3864,10 +3865,10 @@ File: xorriso.info, Node: Scripting, Next: Frontend, Prev: Emulation, Up: Op If path is not empty it gives the address of a plain text file where a log record gets appended after each session. This log can be used to determine the start_lba of a session for mount options - -o sbsector= resp. -s from date or volume id. + -o sbsector= resp. -s from date or volume ID. Record format is: timestamp start_lba size volume-id The first three items are single words, the rest of the line is - the volume id. + the volume ID. -scsi_log "on"|"off" Mode "on" enables very verbous logging of SCSI commands and drive @@ -3890,7 +3891,7 @@ File: xorriso.info, Node: Scripting, Next: Frontend, Prev: Emulation, Up: Op readline history.  -File: xorriso.info, Node: Frontend, Next: ExDevices, Prev: Scripting, Up: Options +File: xorriso.info, Node: Frontend, Next: ExDevices, Prev: Scripting, Up: Commands 9.22 Support for frontend programs via stdin and stdout ======================================================= @@ -3925,7 +3926,7 @@ File: xorriso.info, Node: Frontend, Next: ExDevices, Prev: Scripting, Up: Op Use text as name of this program and perform -help.  -File: xorriso.info, Node: Examples, Next: Files, Prev: Options, Up: Top +File: xorriso.info, Node: Examples, Next: Files, Prev: Commands, Up: Top 10 Examples *********** @@ -4278,7 +4279,7 @@ counterparts. ISO file objects get created, deleted or get their attributes adjusted accordingly. ACL, xattr, hard links and MD5 checksums will be recorded. Accelerated comparison is enabled at the expense of potentially larger backup size. -Only media with the expected volume id or blank media are accepted. +Only media with the expected volume ID or blank media are accepted. Files with names matching *.o or *.swp get excluded explicitly. When done with writing the new session gets checked by its recorded MD5. @@ -4529,7 +4530,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 231) +* -abstract_file sets abstract file name: SetWrite. (line 232) * -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) @@ -4537,13 +4538,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 190) +* -application_id sets application id: SetWrite. (line 191) * -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 238) +* -biblio_file sets biblio file name: SetWrite. (line 239) * -blank erases media: Writing. (line 61) * -boot_image controls bootability: Bootable. (line 26) * -calm_drive reduces drive activity: Loading. (line 240) @@ -4562,7 +4563,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 333) +* -close controls media closing: SetWrite. (line 334) * -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) @@ -4571,7 +4572,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 225) +* -copyright_file sets copyright file name: SetWrite. (line 226) * -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) @@ -4589,11 +4590,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 322) +* -dummy controls write simulation: SetWrite. (line 323) * -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 309) +* -dvd_obs set write block size: SetWrite. (line 310) * -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) @@ -4611,12 +4612,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 326) +* -fs sets size of fifo: SetWrite. (line 327) * -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 266) +* -gid sets global ownership: SetWrite. (line 267) * -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) @@ -4664,17 +4665,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 256) +* -out_charset sets output character set: SetWrite. (line 257) * -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 347) +* -padding sets amount or mode of image padding: SetWrite. (line 348) * -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 244) +* -preparer_id sets preparer id: SetWrite. (line 245) * -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) @@ -4682,7 +4683,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 184) +* -publisher sets publisher id: SetWrite. (line 185) * -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) @@ -4720,30 +4721,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 282) +* -speed set write speed: SetWrite. (line 283) * -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 316) -* -stream_recording controls defect management: SetWrite. (line 297) -* -system_id sets system id: SetWrite. (line 199) +* -stdio_sync controls stdio buffer: SetWrite. (line 317) +* -stream_recording controls defect management: SetWrite. (line 298) +* -system_id sets system id: SetWrite. (line 200) * -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 262) +* -uid sets global ownership: SetWrite. (line 263) * -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 179) -* -volume_date sets volume timestamp: SetWrite. (line 206) -* -write_type chooses TAO or SAO/DAO: SetWrite. (line 339) +* -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) * -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 270) +* -zisofs controls zisofs production: SetWrite. (line 271)  File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top @@ -4778,7 +4779,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 256) +* Character Set, for output, -out_charset: SetWrite. (line 257) * 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) @@ -4835,9 +4836,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 270) +* Filter, zisofs parameters, -zisofs: SetWrite. (line 271) * GPT, _definition: Extras. (line 38) -* Group, global in ISO image, -gid: SetWrite. (line 266) +* Group, global in ISO image, -gid: SetWrite. (line 267) * Group, in ISO image, -chgrp: Manip. (line 50) * Group, in ISO image, -chgrp_r: Manip. (line 55) * Growing, _definition: Methods. (line 19) @@ -4847,19 +4848,19 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top * hidden, set in ISO image, -hide: Manip. (line 171) * Image reading, cache size, -data_cache_size: Loading. (line 269) * Image, _definition: Model. (line 9) -* Image, demand volume id, -assert_volid: Loading. (line 84) +* 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 231) -* Image, set application id, -application_id: SetWrite. (line 190) -* Image, set biblio file name, -biblio_file: SetWrite. (line 238) -* Image, set copyright file name, -copyright_file: SetWrite. (line 225) -* Image, set preparer id, -preparer_id: SetWrite. (line 244) -* Image, set publisher id, -publisher: SetWrite. (line 184) -* Image, set system id, -system_id: SetWrite. (line 199) +* 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 volume id, -volid: SetWrite. (line 160) -* Image, set volume set id, -volset_id: SetWrite. (line 179) -* Image, set volume timestamp, -volume_date: SetWrite. (line 206) +* Image, set volume set id, -volset_id: SetWrite. (line 180) +* Image, set volume timestamp, -volume_date: SetWrite. (line 207) * 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) @@ -4918,7 +4919,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 262) +* Ownership, global in ISO image, -uid: SetWrite. (line 263) * Ownership, in ISO image, -chown: Manip. (line 42) * Ownership, in ISO image, -chown_r: Manip. (line 47) * Partition offset, _definition: Bootable. (line 167) @@ -5000,25 +5001,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 309) +* Write, block size, -dvd_obs: SetWrite. (line 310) * Write, bootability, -boot_image: Bootable. (line 26) -* Write, buffer syncing, -stdio_sync: SetWrite. (line 316) -* Write, close media, -close: SetWrite. (line 333) +* Write, buffer syncing, -stdio_sync: SetWrite. (line 317) +* Write, close media, -close: SetWrite. (line 334) * Write, compliance to specs, -compliance: SetWrite. (line 58) -* Write, defect management, -stream_recording: SetWrite. (line 297) +* Write, defect management, -stream_recording: SetWrite. (line 298) * 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 326) +* Write, fifo size, -fs: SetWrite. (line 327) * 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 347) +* Write, padding image, -padding: SetWrite. (line 348) * Write, pending ISO image, -commit: Writing. (line 29) * Write, predict image size, -print_size: Inquiry. (line 80) -* Write, set speed, -speed: SetWrite. (line 282) -* Write, simulation, -dummy: SetWrite. (line 322) -* Write, TAO or SAO/DAO, -write_type: SetWrite. (line 339) +* Write, set speed, -speed: SetWrite. (line 283) +* Write, simulation, -dummy: SetWrite. (line 323) +* Write, TAO or SAO/DAO, -write_type: SetWrite. (line 340) * xattr, _definition: Extras. (line 65) * xattr, control handling, -xattr: Loading. (line 151) * xattr, set in ISO image, -setfattr: Manip. (line 111) @@ -5039,51 +5040,51 @@ Node: Drives11416 Node: Extras14731 Node: Processing19183 Node: Dialog22803 -Node: Options24480 -Node: ArgSort26154 -Node: AqDrive27644 -Node: Loading30688 -Node: Insert46143 -Node: SetInsert56278 -Node: Manip64854 -Node: CmdFind73677 -Node: Filter88381 -Node: Writing92936 -Node: SetWrite102114 -Node: Bootable120753 -Node: Jigdo136146 -Node: Charset140392 -Node: Exception143153 -Node: DialogCtl149272 -Node: Inquiry151869 -Node: Navigate156735 -Node: Verify165032 -Node: Restore174063 -Node: Emulation180972 -Node: Scripting190783 -Node: Frontend197943 -Node: Examples199243 -Node: ExDevices200420 -Node: ExCreate201079 -Node: ExDialog202364 -Node: ExGrowing203629 -Node: ExModifying204434 -Node: ExBootable204938 -Node: ExCharset205490 -Node: ExPseudo206311 -Node: ExCdrecord207209 -Node: ExMkisofs207526 -Node: ExGrowisofs208866 -Node: ExException210001 -Node: ExTime210455 -Node: ExIncBackup210914 -Node: ExRestore214906 -Node: ExRecovery215866 -Node: Files216436 -Node: Seealso217735 -Node: Bugreport218458 -Node: Legal219039 -Node: CommandIdx220050 -Node: ConceptIdx235995 +Node: Commands24481 +Node: ArgSort26158 +Node: AqDrive27650 +Node: Loading30695 +Node: Insert46151 +Node: SetInsert56287 +Node: Manip64864 +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  End Tag Table diff --git a/libisoburn/trunk/xorriso/xorriso.texi b/libisoburn/trunk/xorriso/xorriso.texi index 4831ed86..a00fbc2d 100644 --- a/libisoburn/trunk/xorriso/xorriso.texi +++ b/libisoburn/trunk/xorriso/xorriso.texi @@ -102,7 +102,7 @@ with Rock Ridge extensions. * Extras:: Rock Ridge, POSIX, X/Open, El Torito, ACL, xattr * Processing:: Command processing * Dialog:: Dialog, Readline, Result pager -* Options:: Reference of commands +* Commands:: Reference of commands * Examples:: Examples * Files:: Files * Seealso:: See also @@ -696,7 +696,7 @@ The program ends either by command -end, or by the end of program arguments if dialog mode has not been enabled at that point, or by a problem event which triggers the threshold of command -abort_on. @c man .SS -@node Dialog, Options, Processing, top +@node Dialog, Commands, Processing, top @chapter Dialog, Readline, Result pager @c man .B Dialog, Readline, Result pager: @c man .br @@ -742,8 +742,8 @@ Some actions apply paging to their info output, too. @* The request to abort may or may not be obeyed by the current action. All actions try to abort as soon as possible. -@node Options, Examples, Dialog, top -@chapter Options +@node Commands, Examples, Dialog, top +@chapter Commands @c man .br @c man .SH OPTIONS @c man .br @@ -778,7 +778,7 @@ inner dashes are interpreted as underscores. * Frontend:: Support for frontend programs via stdin and stdout @end menu @c man .TP -@node ArgSort, AqDrive, Options, Options +@node ArgSort, AqDrive, Commands, Commands @section Execution order of program arguments @c man .B Execution order of program arguments: @c man .PP @@ -820,7 +820,7 @@ well make sense, though. @end table @c man .PP @c man .TP -@node AqDrive, Loading, ArgSort, Options +@node AqDrive, Loading, ArgSort, Commands @section Acquiring source and target drive @c man .B Acquiring source and target drive: @c man .PP @@ -896,7 +896,7 @@ begins. The output drive is given up when writing is done. @end table @c man .TP @c man .B Influencing the behavior of image loading: -@node Loading, Insert, AqDrive, Options +@node Loading, Insert, AqDrive, Commands @section Influencing the behavior of image loading @c man .PP The following commands should normally be performed before loading an image @@ -995,8 +995,8 @@ have to deny its rw-permissions in the filesystem. @c man .TP @item -assert_volid pattern severity @kindex -assert_volid rejects undesired images -@cindex Image, demand volume id, -assert_volid -Refuse to load ISO images with volume ids which do not match the given +@cindex Image, demand volume ID, -assert_volid +Refuse to load ISO images with volume IDs which do not match the given search pattern. When refusing an image, give up the input drive and issue an event of the given severity (like FAILURE, see -abort_on). An empty search pattern accepts any image. @@ -1235,7 +1235,7 @@ Currently the default is 32 tiles of 32 blocks = 2 MiB. @end table @c man .TP @c man .B Inserting files into ISO image: -@node Insert, SetInsert, Loading, Options +@node Insert, SetInsert, Loading, Commands @section Inserting files into ISO image @c man .PP The following commands expect file addresses of two kinds: @@ -1502,7 +1502,7 @@ parameters. @end table @c man .TP @c man .B Settings for file insertion: -@node SetInsert, Manip, Insert, Options +@node SetInsert, Manip, Insert, Commands @section Settings for file insertion @c man .TP @table @asis @@ -1725,7 +1725,7 @@ parameter and their contents may not overlap. @end table @c man .TP @c man .B File manipulations: -@node Manip, CmdFind, SetInsert, Options +@node Manip, CmdFind, SetInsert, Commands @section File manipulations @c man .PP The following commands manipulate files in the ISO image, regardless whether @@ -1992,7 +1992,7 @@ Rather use: -boot_image "any" "cat_hidden=on" @end table @c man .TP @c man .B Tree traversal command -find: -@node CmdFind, Filter, Manip, Options +@node CmdFind, Filter, Manip, Commands @section Tree traversal command -find @c man .PP @table @asis @@ -2387,7 +2387,7 @@ E.g.: @c man .TP @c man .B Filters for data file content: @c man .PP -@node Filter, Writing, CmdFind, Options +@node Filter, Writing, CmdFind, Commands @section Filters for data file content @cindex Filter, _definition @strong{Filters} may be installed between data files in the ISO image and their @@ -2505,7 +2505,7 @@ Like -set_filter but affecting all data files below eventual directories. @end table @c man .TP @c man .B Writing the result, drive control: -@node Writing, SetWrite, Filter, Options +@node Writing, SetWrite, Filter, Commands @section Writing the result, drive control @c man .PP (see also paragraph about settings below) @@ -2730,7 +2730,7 @@ The currently recognized type is marked by text "(current)". @end table @c man .TP @c man .B Settings for result writing: -@node SetWrite, Bootable, Writing, Options +@node SetWrite, Bootable, Writing, Commands @section Settings for result writing @c man .PP Rock Ridge info will be generated by default. @@ -2924,20 +2924,25 @@ 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. @command{xorriso} accepts any text up to 32 characters, +Specify the volume ID, which can be considered to be the name of the image. +@command{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" +ECMA-119 demands ASCII characters out of [A-Z0-9_]. Like: @* -Joliet allows 16 UCS-2 characters. Like: "Windows name" + "IMAGE_23" @* -Be aware that the volume id might get used automatically as name of the +Joliet allows 16 UCS-2 characters. Like: +@* + "Windows name" +@* +Be aware that the volume id might get used automatically as the name of the mount point when the medium is inserted into a playful computer system. @* If an ISO image gets loaded while the volume ID is set to default "ISOIMAGE" or to "", then the volume ID of the loaded image will become the effective volume id for the next write run. But as soon as command -volid is performed -afterwards, this pending id is overridden by the new setting. +afterwards, this pending ID is overridden by the new setting. @* Consider this when setting -volid "ISOIMAGE" before executing -dev, -indev, or -rollback. @@ -2946,14 +2951,14 @@ If you insist in -volid "ISOIMAGE", set it again after those commands. @item -volset_id text @kindex -volset_id sets volume set id @cindex Image, set volume set id, -volset_id -Set the volume set id string to be written with the next -commit. +Set the volume set ID string to be written with the next -commit. Permissible are up to 128 characters. This setting gets overridden by image loading. @c man .TP @item -publisher text @kindex -publisher sets publisher id @cindex Image, set publisher id, -publisher -Set the publisher id string to be written with the next -commit. This may +Set the publisher ID string to be written with the next -commit. This may identify the person or organisation who specified what shall be recorded. Permissible are up to 128 characters. This setting gets overridden by image loading. @@ -2961,20 +2966,20 @@ image loading. @item -application_id text @kindex -application_id sets application id @cindex Image, set application id, -application_id -Set the application id string to be written with the next -commit. This may +Set the application ID string to be written with the next -commit. This may identify the specification of how the data are recorded. Permissible are up to 128 characters. This setting gets overridden by image loading. @* -The special text "@@xorriso@@" gets converted to the id string of +The special text "@@xorriso@@" gets converted to the ID string of @command{xorriso} which is normally written as -preparer_id. It is a wrong tradition to write -the program id as -application_id. +the program ID as -application_id. @c man .TP @item -system_id text @kindex -system_id sets system id @cindex Image, set system id, -system_id -Set the system id string to be written with the next -commit. This may +Set the system ID string to be written with the next -commit. This may identify the system which can recognize and act upon the content of the System Area in image blocks 0 to 15. Permissible are up to 32 characters. This setting gets overridden by @@ -3039,16 +3044,16 @@ image loading. @item -preparer_id @kindex -preparer_id sets preparer id @cindex Image, set preparer id, -preparer_id -Set the preparer id string to be written with the next -commit. This may +Set the preparer ID string to be written with the next -commit. This may identify the person or other entity which controls the preparation of the data -which shall be recorded. Normally this should be the id of @command{xorriso} +which shall be recorded. Normally this should be the ID of @command{xorriso} and not of the person or program which operates @command{xorriso}. Please avoid to change it. Permissible are up to 128 characters. @* -The special text "@@xorriso@@" gets converted to the id string of +The special text "@@xorriso@@" gets converted to the ID string of @command{xorriso} which is default at program startup. @* -Unlike other id strings, this setting is not influenced by image loading. +Unlike other ID strings, this setting is not influenced by image loading. @c man .TP @item -out_charset character_set_name @kindex -out_charset sets output character set @@ -3195,7 +3200,7 @@ The same effect is achieved by -padding mode "included". @end table @c man .TP @c man .B Bootable ISO images: -@node Bootable, Jigdo, SetWrite, Options +@node Bootable, Jigdo, SetWrite, Commands @section Bootable ISO images @c man .PP Contrary to published specifications many BIOSes will load an El Torito @@ -3541,7 +3546,7 @@ lower valid one. @end table @c man .TP @c man .B Jigdo Template Extraction: -@node Jigdo, Charset, Bootable, Options +@node Jigdo, Charset, Bootable, Commands @section Jigdo Template Extraction @c man .PP @cindex Jigdo Template Extraction, _definition @@ -3649,7 +3654,7 @@ Alias: -checksum_algorithm_template @end table @c man .TP @c man .B Character sets: -@node Charset, Exception, Jigdo, Options +@node Charset, Exception, Jigdo, Commands @section Character sets @c man .PP @cindex Character Set, _definition @@ -3713,7 +3718,7 @@ If this appears necessary, one should consider to set -backslash_codes to @end table @c man .TP @c man .B Exception processing: -@node Exception, DialogCtl, Charset, Options +@node Exception, DialogCtl, Charset, Commands @section Exception processing @c man .PP Since the tasks of @command{xorriso} are manifold and prone to external @@ -3874,7 +3879,7 @@ file content stems from the loaded ISO image and is not filtered. @end table @c man .TP @c man .B Dialog mode control: -@node DialogCtl, Inquiry, Exception, Options +@node DialogCtl, Inquiry, Exception, Commands @section Dialog mode control @table @asis @c man .TP @@ -3949,7 +3954,7 @@ use -rollback to revoke the whole session. @end table @c man .TP @c man .B Drive and media related inquiry actions: -@node Inquiry, Navigate, DialogCtl, Options +@node Inquiry, Navigate, DialogCtl, Commands @section Drive and media related inquiry actions @table @asis @c man .TP @@ -4073,13 +4078,13 @@ subtracting already foreseeable consumption by next -commit. @item -pvd_info @kindex -pvd_info shows image id strings @cindex Image, show id strings, -pvd_info -Print various id strings which can be found in loaded ISO images. Some of +Print various ID strings which can be found in loaded ISO images. Some of them may be changed by commands like -volid or -publisher. For these -ids -pvd_info reports what would be written with the next -commit. +IDs -pvd_info reports what would be written with the next -commit. @end table @c man .TP @c man .B Navigation in ISO image and disk filesystem: -@node Navigate, Verify, Inquiry, Options +@node Navigate, Verify, Inquiry, Commands @section Navigation in ISO image and disk filesystem @table @asis @c man .TP @@ -4345,7 +4350,7 @@ Like -show_stream but working recursively. @end table @c man .TP @c man .B Evaluation of readability and recovery: -@node Verify, Restore, Navigate, Options +@node Verify, Restore, Navigate, Commands @section Evaluation of readability and recovery @c man .PP It is not uncommon that optical media produce read errors. The reasons may be @@ -4490,7 +4495,7 @@ and their start block addresses, followed by binary bitmap data. @* @item map_with_volid="on" examines tracks whether they are ISO images and -prints their volume ids into the human readable TOC of sector_map=. +prints their volume IDs into the human readable TOC of sector_map=. @* @item patch_lba0="on" transfers within the data_to= file a copy of the currently @@ -4552,7 +4557,7 @@ Only mismatching data files will be reported. @end table @c man .TP @c man .B osirrox ISO-to-disk restore commands: -@node Restore, Emulation, Verify, Options +@node Restore, Emulation, Verify, Commands @section osirrox ISO-to-disk restore commands @c man .PP Normally @command{xorriso} only writes to disk files which were given as stdio: @@ -4714,7 +4719,7 @@ reachable as /bin/mount or /sbin/mount. @end table @c man .TP @c man .B Command compatibility emulations: -@node Emulation, Scripting, Restore, Options +@node Emulation, Scripting, Restore, Commands @section Command compatibility emulations (cdrtools) @c man .PP Writing of ISO 9660 on CD is traditionally done by program mkisofs @@ -4963,7 +4968,7 @@ Program scdbackup_verify will recognize and verify tag resp. record. @end table @c man .TP @c man .B Scripting, dialog and program control features: -@node Scripting, Frontend, Emulation, Options +@node Scripting, Frontend, Emulation, Commands @section Scripting, dialog and program control features @table @asis @c man .TP @@ -5163,11 +5168,11 @@ This transport becomes visible with -report_about "ALL". If path is not empty it gives the address of a plain text file where a log record gets appended after each session. This log can be used to determine the start_lba of a session for mount options -o sbsector= -resp. -s from date or volume id. +resp. -s from date or volume ID. @* Record format is: timestamp start_lba size volume-id @* -The first three items are single words, the rest of the line is the volume id. +The first three items are single words, the rest of the line is the volume ID. @c man .TP @item -scsi_log "on"|"off" @kindex -scsi_log reports SCSI commands @@ -5203,7 +5208,7 @@ Do not execute the line but store it in readline history. @end table @c man .TP @c man .B Support for frontend programs via stdin and stdout: -@node Frontend, ExDevices, Scripting, Options +@node Frontend, ExDevices, Scripting, Commands @section Support for frontend programs via stdin and stdout @table @asis @c man .TP @@ -5252,7 +5257,7 @@ Use text as name of this program in subsequent messages Use text as name of this program and perform -help. @end table @c man .br -@node Examples, Files, Options, Top +@node Examples, Files, Commands, Top @chapter Examples @c man .SH EXAMPLES @c man .SS @@ -5758,7 +5763,7 @@ accordingly. @* ACL, xattr, hard links and MD5 checksums will be recorded. Accelerated comparison is enabled at the expense of potentially larger backup -size. Only media with the expected volume id or blank media are accepted. +size. Only media with the expected volume ID or blank media are accepted. Files with names matching *.o or *.swp get excluded explicitly. @* When done with writing the new session gets checked by its recorded MD5.