From 2ed80c17c35a6868a32f84f05c56fdff1c38985c Mon Sep 17 00:00:00 2001 From: Thomas Schmitt Date: Tue, 22 Apr 2014 08:55:56 +0000 Subject: [PATCH] Polished man page about -concat --- xorriso/xorriso.1 | 7 ++++- xorriso/xorriso.info | 67 ++++++++++++++++++++++++-------------------- xorriso/xorriso.texi | 11 +++++++- 3 files changed, 52 insertions(+), 33 deletions(-) diff --git a/xorriso/xorriso.1 b/xorriso/xorriso.1 index 04a84dc6..dcb31c80 100644 --- a/xorriso/xorriso.1 +++ b/xorriso/xorriso.1 @@ -4329,16 +4329,21 @@ An existing target file is not removed before writing begins. If it is not able to take content data, then this command fails. Mode overwrite truncates regular data files to 0 size before writing into them. Example: +.br \-concat append /home/me/accumulated_text /my/iso/text \-\- .br + Mode \fBpipe\fR expects as second parameter a delimiter word which shall mark the end of the program argument list. The third argument is the disk_path to the program. It must contain at least one '/'. $PATH is not applied. Further parameters up to the announced delimiter word are used as arguments with the program start. Example: .br - \-concat pipe + /usr/bin/wc + /my/iso/files* \-\- + \-iso_rr_pattern on \\ .br + \-concat pipe + /usr/bin/wc + "/my/iso/files*" \-\- +.br + The further parameters in all modes are the iso_rr_paths of data files. Their content gets concatenated in the copy. .TP diff --git a/xorriso/xorriso.info b/xorriso/xorriso.info index 707dfcea..f8b4d620 100644 --- a/xorriso/xorriso.info +++ b/xorriso/xorriso.info @@ -3807,15 +3807,20 @@ The directory permissions on disk have to allow rwx. standard error is /dev/fd/2). An existing target file is not removed before writing begins. If it is not able to take content data, then this command fails. Mode overwrite truncates regular - data files to 0 size before writing into them. Example: -concat - append /home/me/accumulated_text /my/iso/text - + data files to 0 size before writing into them. Example: + + -concat append /home/me/accumulated_text /my/iso/text - + Mode *pipe* expects as second parameter a delimiter word which shall mark the end of the program argument list. The third argument is the disk_path to the program. It must contain at least one '/'. $PATH is not applied. Further parameters up to the announced delimiter word are used as arguments with the program start. Example: - -concat pipe + /usr/bin/wc + /my/iso/files* - + + -iso_rr_pattern on \ + -concat pipe + /usr/bin/wc + "/my/iso/files*" - + The further parameters in all modes are the iso_rr_paths of data files. Their content gets concatenated in the copy. @@ -5112,7 +5117,7 @@ File: xorriso.info, Node: CommandIdx, Next: ConceptIdx, Prev: Legal, Up: Top * -mark sets synchronizing message: Frontend. (line 25) * -md5 controls handling of MD5 sums: Loading. (line 183) * -mkdir creates ISO directory: Insert. (line 171) -* -mount issues mount command for ISO session: Restore. (line 153) +* -mount issues mount command for ISO session: Restore. (line 158) * -mount_cmd composes mount command line: Inquiry. (line 52) * -mount_cmd controls mount command: Inquiry. (line 68) * -msg_op perform operations on program messages: Frontend. (line 30) @@ -5461,7 +5466,7 @@ File: xorriso.info, Node: ConceptIdx, Prev: CommandIdx, Up: Top * Session, _definition: Model. (line 6) * Session, altered start address, -displacement: Loading. (line 60) * Session, info string, -session_string: Inquiry. (line 78) -* Session, issue mount command, -mount: Restore. (line 153) +* Session, issue mount command, -mount: Restore. (line 158) * Session, log when written, -session_log: Scripting. (line 149) * Session, mount command line, -mount_cmd: Inquiry. (line 52) * Session, mount parameters, -mount_opts: Inquiry. (line 68) @@ -5544,31 +5549,31 @@ Node: Inquiry163190 Node: Navigate170325 Node: Verify178623 Node: Restore188450 -Node: Emulation197023 -Node: Scripting207411 -Node: Frontend215182 -Node: Examples224789 -Node: ExDevices225967 -Node: ExCreate226633 -Node: ExDialog227918 -Node: ExGrowing229183 -Node: ExModifying229988 -Node: ExBootable230492 -Node: ExCharset231044 -Node: ExPseudo231936 -Node: ExCdrecord232834 -Node: ExMkisofs233151 -Node: ExGrowisofs234491 -Node: ExException235626 -Node: ExTime236080 -Node: ExIncBackup236539 -Node: ExRestore240519 -Node: ExRecovery241452 -Node: Files242022 -Node: Seealso243321 -Node: Bugreport244044 -Node: Legal244625 -Node: CommandIdx245636 -Node: ConceptIdx262444 +Node: Emulation197054 +Node: Scripting207442 +Node: Frontend215213 +Node: Examples224820 +Node: ExDevices225998 +Node: ExCreate226664 +Node: ExDialog227949 +Node: ExGrowing229214 +Node: ExModifying230019 +Node: ExBootable230523 +Node: ExCharset231075 +Node: ExPseudo231967 +Node: ExCdrecord232865 +Node: ExMkisofs233182 +Node: ExGrowisofs234522 +Node: ExException235657 +Node: ExTime236111 +Node: ExIncBackup236570 +Node: ExRestore240550 +Node: ExRecovery241483 +Node: Files242053 +Node: Seealso243352 +Node: Bugreport244075 +Node: Legal244656 +Node: CommandIdx245667 +Node: ConceptIdx262475  End Tag Table diff --git a/xorriso/xorriso.texi b/xorriso/xorriso.texi index e249b21c..81348cbd 100644 --- a/xorriso/xorriso.texi +++ b/xorriso/xorriso.texi @@ -5047,16 +5047,25 @@ An existing target file is not removed before writing begins. If it is not able to take content data, then this command fails. Mode overwrite truncates regular data files to 0 size before writing into them. Example: +@* +@sp 1 -concat append /home/me/accumulated_text /my/iso/text -- @* +@sp 1 + Mode @strong{pipe} expects as second parameter a delimiter word which shall mark the end of the program argument list. The third argument is the disk_path to the program. It must contain at least one '/'. $PATH is not applied. Further parameters up to the announced delimiter word are used as arguments with the program start. Example: @* - -concat pipe + /usr/bin/wc + /my/iso/files* -- +@sp 1 + -iso_rr_pattern on \ @* + -concat pipe + /usr/bin/wc + "/my/iso/files*" -- +@* +@sp 1 + The further parameters in all modes are the iso_rr_paths of data files. Their content gets concatenated in the copy. @c man .TP