New option update_r, -find actions "update" and "add_missing" (not yet completed)

libisoburn/trunk/xorriso/xorriso.1

@@ -543,18 +543,28 @@ Like -add but read the parameter words from file disk_path.
 One pathspec resp. disk_path pattern per line. 
 .TP
 \fB\-update\fR disk_path iso_rr_path
+WARNING: This option is fewly tested and has potential to spoil your ISO image.
+.br
 Compare file object disk_path with file object iso_rr_path. If they do not
 match, then perform the necessary image manipulations to make iso_rr_path
-a matching copy of disk_path. This comparison can imply lengthy content
+a matching copy of disk_path. This comparison will imply lengthy content
 reading before a decision is made. On the other hand it strives for the
-smallest possible amount of add-on data in order to achieve the matching copy.
+smallest possible amount of add-on data which is needed to achieve the
+matching copy.
 .br
 -update is also a convenient compromise between -add addressing and -cp_r
 addressing: Its semantics is similar to -add and thus avoids the pitfalls
 inherited from cp -r behavior. Its syntax resembles cp, though.
 .br
 Note: Not all subtleties of link following are implemented yet.
-Use with caution.
+.TP
+\fB\-update_r\fR disk_path iso_rr_path
+WARNING: This option is fewly tested and has potential to spoil your ISO image.
+.br
+Like -update but working recursively. I.e. all file objects below both
+addresses get compared whether they have counterparts below the other address
+and whether both counterparts match. If there is a mismatch then the necessary
+update manipulation is done.
 .TP
 \fB\-cpr\fR disk_path [***] iso_rr_path
 Insert the given files or directory trees from filesystem 
@@ -715,6 +725,15 @@ E.g.:
 .br
   -find / -exec compare /home/thomas
 .br
+"update" performs command -update with the found file address as iso_rr_path.
+The corresponding file address is determined like with above "compare".
+.br
+WARNING: This action is fewly tested and has potential to spoil your ISO image.
+.br
+E.g.:
+.br
+  -find / -exec update /home/thomas
+.br
 "find" performs another run of -find on the matching file address. It accepts
 the same params as -find, except iso_rr_path.
 E.g.:
@@ -1267,8 +1286,8 @@ Similar to shell command du -sk.
 Like -find but operating on local filesystem and not on the ISO image.
 This is subject to the settings of -follow.
 .br
--findx accepts the -exec actions as does -find. But except two
-other actions it will allways perform action "echo".
+-findx accepts the -exec actions as does -find. But except the following few
+actions it will allways perform action "echo".
 .br
 "in_iso" iso_rr_path_start reports the path if its counterpart exist in
 the ISO image. For this the disk_path of the -find command gets replaced
@@ -1281,7 +1300,13 @@ not exist in the ISO image. The report format is the same as with command
 -compare.
 E.g.
 .br
-  -find /home -exec not_in_iso /
+  -find /home/thomas -exec not_in_iso /thomas_on_cd
+.br
+"add_missing" iso_rr_path_start adds the counterpart if it does not yet
+exist in the ISO image. 
+E.g.
+.br
+  -find /home/thomas -exec add_missing /thomas_on_cd
 .TP
 \fB\-compare\fR disk_path iso_rr_path
 Compare attributes and eventual data file content of a fileobject in the
@@ -1637,7 +1662,9 @@ first and only session to the output drive.
 .SS
 .B Write a ISO image into a pipe (single-session only)
 \fB$\fR xorriso -outdev - \\
+.br
  ...
+.br
  | gzip >image.iso.gz
 .SS
 .B Adjust thresholds for verbosity, exit value and program abort