Polished man page about -concat

libisoburn/trunk/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

libisoburn/trunk/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
+     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
      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: 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

libisoburn/trunk/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