New -alter_date types: a-c , m-c , b-c , c

libisoburn/trunk/xorriso/xorriso.texi

@@ -50,7 +50,7 @@
 @c man .\" First parameter, NAME, should be all caps
 @c man .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
 @c man .\" other parameters are allowed: see man(7), man(1)
-@c man .TH XORRISO 1 "Version 1.3.3, Nov 14, 2013"
+@c man .TH XORRISO 1 "Version 1.3.3, Nov 27, 2013"
 @c man .\" Please adjust this date whenever revising the manpage.
 @c man .\"
 @c man .\" Some roff macros, for reference:
@@ -1981,9 +1981,18 @@ Use code \000 for 0-bytes.
 @item -alter_date type timestring iso_rr_path [***]
 @kindex -alter_date   sets timestamps in ISO image
 @cindex Timestamps, set in ISO image, -alter_date
-Alter the date entries of a file in the ISO image. type is
-one of "a", "m", "b" for access time, modification time,
-both times.
+Alter the date entries of files in the ISO image. type may be one of
+the following:
+@*
+"a" sets access time, updates ctime.
+@*
+"m" sets modification time, updates ctime.
+@*
+"b" sets access time and modification time, updates ctime.
+@*
+"a-c", "m-c", and "b-c" set the times without updating ctime.
+@*
+"c" sets the ctime.
 @*
 timestring may be in the following formats
 (see also section EXAMPLES):
@@ -2024,6 +2033,10 @@ These are normally given as GMT. The suffix "LOC" causes local timezone
 conversion. E.g. 2013010720574700, 2013010720574700LOC.
 The last two digits cc (centiseconds) will be ignored, but must be present
 in order to make the format recognizable.
+@*
+Example:
+@*
+  -alter_date m-c 2013.11.27.103951 /file1 /file2 --
 @c man .TP
 @item -alter_date_r type timestring iso_rr_path [***]
 @kindex -alter_date_r   sets timestamps in ISO image
@@ -5947,8 +5960,11 @@ $ xorriso -outdev /dev/sr0 -blank as_needed \
 @node ExCharset, ExPseudo, ExBootable, Examples
 @section Change existing file name tree from ISO-8859-1 to UTF-8
 This example assumes that the existing ISO image was written with character
-set ISO-8859-1 but that the readers expected UTF-8. Now a new session with
-the same files gets added with converted file names.
+set ISO-8859-1 but that the readers expected UTF-8. Now a new session
+gets added with converted file names.
+Command -changes_pending "yes" enables writing despite the lack of any
+manipulation command.
+@*
 In order to avoid any weaknesses of the local character set, this command
 pretends that it uses already the final target set UTF-8.
 Therefore strange file names may appear in messages, which
@@ -5959,7 +5975,7 @@ $ xorriso -in_charset ISO-8859-1 -local_charset UTF-8 \
 @*
    -out_charset UTF-8 -backslash_codes on -dev /dev/sr0 \
 @*
-   -alter_date m +0 / @minus{}@minus{} -commit -eject all
+   -changes_pending yes -commit -eject all
 @c man .SS
 @c man .B Operate on storage facilities other than optical drives
 @node ExPseudo, ExCdrecord, ExCharset, Examples