New option -volume_date, for grub-mkrescue: -as mkisofs --modification-date=

libisoburn/trunk/xorriso/xorriso.texi

@@ -44,7 +44,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 "Apr 06, 2010"
+@c man .TH XORRISO 1 "Apr 07, 2010"
 @c man .\" Please adjust this date whenever revising the manpage.
 @c man .\"
 @c man .\" Some roff macros, for reference:
@@ -2408,6 +2408,36 @@ System Area in image blocks 0 to 15.
 Permissible are up to 32 characters. This setting gets overridden by
 image loading.
 @c man .TP
+@item -volume_date type timestring
+@kindex -volume_date   sets volume timestamp
+@cindex Image, set volume timestamp, -volume_date
+Set one of the four overall timestamps for subsequent image writing.
+Available types are:
+@*
+"c"  time when the volume was created.
+@*
+"m"  time when volume was last modified.
+@*
+"x"  time when the information in the volume expires.
+@*
+"f"  time since when the volume is effectively valid.
+@*
+"uuid"  sets a timestring that overrides "m" time literally.
+@*
+It must consist of 16 decimal digits which form YYYYMMDDhhmmsscc, with
+YYYY between 1970 and 2999.
+It is supposed to match this GRUB line:
+@*
+ search --fs-uuid --set YYYY-MM-DD-hh-mm-ss-cc
+@*
+E.g. 2010040711405800 is 7 Apr 2010 11:40:58 (+0 centiseconds).
+@*
+Timestrings for the other types may be given as with option -alter_date.
+They are prone to timezone computations. The timestrings "default" or
+"overridden" cause default settings: "c" and "m" will show the current time
+of image creation. "x" and "f" will be marked as insignificant.
+"uuid" will be deactivated.
+@c man .TP
 @item -out_charset character_set_name
 @kindex -out_charset   sets output character set
 @cindex Character Set, for output, -out_charset