Polished man page about -concat

This commit is contained in:
Thomas Schmitt 2014-04-22 08:55:56 +00:00
parent 30828a4867
commit 2ed80c17c3
3 changed files with 52 additions and 33 deletions

View File

@ -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. able to take content data, then this command fails.
Mode overwrite truncates regular data files to 0 size before writing into them. Mode overwrite truncates regular data files to 0 size before writing into them.
Example: Example:
.br
\-concat append /home/me/accumulated_text /my/iso/text \-\- \-concat append /home/me/accumulated_text /my/iso/text \-\-
.br .br
Mode \fBpipe\fR expects as second parameter a delimiter word which shall 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 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. to the program. It must contain at least one '/'. $PATH is not applied.
Further parameters up to the announced delimiter Further parameters up to the announced delimiter
word are used as arguments with the program start. Example: word are used as arguments with the program start. Example:
.br .br
\-concat pipe + /usr/bin/wc + /my/iso/files* \-\- \-iso_rr_pattern on \\
.br .br
\-concat pipe + /usr/bin/wc + "/my/iso/files*" \-\-
.br
The further parameters in all modes are the iso_rr_paths of data files. The further parameters in all modes are the iso_rr_paths of data files.
Their content gets concatenated in the copy. Their content gets concatenated in the copy.
.TP .TP

View File

@ -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 standard error is /dev/fd/2). An existing target file is not
removed before writing begins. If it is not able to take content removed before writing begins. If it is not able to take content
data, then this command fails. Mode overwrite truncates regular data, then this command fails. Mode overwrite truncates regular
data files to 0 size before writing into them. Example: -concat data files to 0 size before writing into them. Example:
append /home/me/accumulated_text /my/iso/text -
-concat append /home/me/accumulated_text /my/iso/text -
Mode *pipe* expects as second parameter a delimiter word which Mode *pipe* expects as second parameter a delimiter word which
shall mark the end of the program argument list. The third shall mark the end of the program argument list. The third
argument is the disk_path to the program. It must contain at least argument is the disk_path to the program. It must contain at least
one '/'. $PATH is not applied. Further parameters up to the one '/'. $PATH is not applied. Further parameters up to the
announced delimiter word are used as arguments with the program announced delimiter word are used as arguments with the program
start. Example: 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 The further parameters in all modes are the iso_rr_paths of data
files. Their content gets concatenated in the copy. 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) * -mark sets synchronizing message: Frontend. (line 25)
* -md5 controls handling of MD5 sums: Loading. (line 183) * -md5 controls handling of MD5 sums: Loading. (line 183)
* -mkdir creates ISO directory: Insert. (line 171) * -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 composes mount command line: Inquiry. (line 52)
* -mount_cmd controls mount command: Inquiry. (line 68) * -mount_cmd controls mount command: Inquiry. (line 68)
* -msg_op perform operations on program messages: Frontend. (line 30) * -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, _definition: Model. (line 6)
* Session, altered start address, -displacement: Loading. (line 60) * Session, altered start address, -displacement: Loading. (line 60)
* Session, info string, -session_string: Inquiry. (line 78) * 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, log when written, -session_log: Scripting. (line 149)
* Session, mount command line, -mount_cmd: Inquiry. (line 52) * Session, mount command line, -mount_cmd: Inquiry. (line 52)
* Session, mount parameters, -mount_opts: Inquiry. (line 68) * Session, mount parameters, -mount_opts: Inquiry. (line 68)
@ -5544,31 +5549,31 @@ Node: Inquiry163190
Node: Navigate170325 Node: Navigate170325
Node: Verify178623 Node: Verify178623
Node: Restore188450 Node: Restore188450
Node: Emulation197023 Node: Emulation197054
Node: Scripting207411 Node: Scripting207442
Node: Frontend215182 Node: Frontend215213
Node: Examples224789 Node: Examples224820
Node: ExDevices225967 Node: ExDevices225998
Node: ExCreate226633 Node: ExCreate226664
Node: ExDialog227918 Node: ExDialog227949
Node: ExGrowing229183 Node: ExGrowing229214
Node: ExModifying229988 Node: ExModifying230019
Node: ExBootable230492 Node: ExBootable230523
Node: ExCharset231044 Node: ExCharset231075
Node: ExPseudo231936 Node: ExPseudo231967
Node: ExCdrecord232834 Node: ExCdrecord232865
Node: ExMkisofs233151 Node: ExMkisofs233182
Node: ExGrowisofs234491 Node: ExGrowisofs234522
Node: ExException235626 Node: ExException235657
Node: ExTime236080 Node: ExTime236111
Node: ExIncBackup236539 Node: ExIncBackup236570
Node: ExRestore240519 Node: ExRestore240550
Node: ExRecovery241452 Node: ExRecovery241483
Node: Files242022 Node: Files242053
Node: Seealso243321 Node: Seealso243352
Node: Bugreport244044 Node: Bugreport244075
Node: Legal244625 Node: Legal244656
Node: CommandIdx245636 Node: CommandIdx245667
Node: ConceptIdx262444 Node: ConceptIdx262475
 
End Tag Table End Tag Table

View File

@ -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. able to take content data, then this command fails.
Mode overwrite truncates regular data files to 0 size before writing into them. Mode overwrite truncates regular data files to 0 size before writing into them.
Example: Example:
@*
@sp 1
-concat append /home/me/accumulated_text /my/iso/text -- -concat append /home/me/accumulated_text /my/iso/text --
@* @*
@sp 1
Mode @strong{pipe} expects as second parameter a delimiter word which shall 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 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. to the program. It must contain at least one '/'. $PATH is not applied.
Further parameters up to the announced delimiter Further parameters up to the announced delimiter
word are used as arguments with the program start. Example: 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. The further parameters in all modes are the iso_rr_paths of data files.
Their content gets concatenated in the copy. Their content gets concatenated in the copy.
@c man .TP @c man .TP