wimupdate: add --ref option for updating delta WIMs

[wimlib] / doc / man1 / wimupdate.1

diff --git a/doc/man1/wimupdate.1 b/doc/man1/wimupdate.1
index a3beadf9a67329791d6d8f99f8b9f1fa54e6642b..7c07914946543a82a7bc6d15c2ef30c1d8c8a259 100644 (file)
--- a/doc/man1/wimupdate.1
+++ b/doc/man1/wimupdate.1
@@ -1,4 +1,4 @@
-.TH WIMUPDATE "1" "July 2017" "wimlib 1.12.0" "User Commands"
+.TH WIMUPDATE "1" "September 2022" "wimlib 1.13.6" "User Commands"
 .SH NAME
 wimupdate \- Update a WIM image
 .SH SYNOPSIS
@@ -163,6 +163,13 @@ Compact the WIM archive in-place and append any new data, eliminating "holes".
 This is efficient, but in general this option should \fInot\fR be used because a
 failed or interrupted compaction will corrupt the WIM archive.  For more
 information, see the documentation for this option in \fBwimoptimize\fR(1).
+.TP
+\fB--ref\fR="\fIGLOB\fR"
+File glob of WIM(s) on which the delta WIM is based.  Updating split WIMs is not
+allowed, but updating delta WIMs is allowed.  When updating a delta WIM, the
+WIM(s) on which the delta WIM is based should be specified using this option.
+(It isn't a hard requirement, but it's needed for data deduplication to work
+fully and for the TOTALBYTES statistic to be correctly updated.)
 .SH NOTES
 \fBwimupdate\fR can be viewed as redundant with \fBwimmountrw\fR, since a WIM
 image can also be updated by mounting it read-write.  However, \fBwimupdate\fR
@@ -220,7 +227,7 @@ $ wimupdate boot.wim 2 < update_commands.txt
 .PP
 Add some files and directories to a WIM image.  Note that the first path of each
 \fBadd\fR command specifies the files to add, while the second path of each
-\fBadd\fR command specify the locations at which to to add them inside the WIM
+\fBadd\fR command specify the locations at which to add them inside the WIM
 image:
 .PP
 .RS