Document absolute times for 'kinit -s'

kinit's -s argument takes a parameter, which is first interpreted
as a time interval ("deltat"), in the same format used for
the -l and -r arguments.  However, if that fails, the
time argument is interpreted as an absolute time, in one of
twelve different possible formats, some of which are subject to
localization via strptime().  Explicitly listing all twelve
possible interpretations is overkill, but give the user a hint that
absolute times are possible at all.

diff --git a/doc/rst_source/krb_users/user_commands/kinit.rst b/doc/rst_source/krb_users/user_commands/kinit.rst
index 6143c95e47c7242d04a421d7de4d66ee634f1dd5..a07962d4d3fdff255135fbf76863ff37f6f57ef5 100644 (file)
--- a/doc/rst_source/krb_users/user_commands/kinit.rst
+++ b/doc/rst_source/krb_users/user_commands/kinit.rst
@@ -73,7 +73,11 @@ OPTIONS
     validation before use.
 
     *start_time* specifies the duration of the delay before the ticket
-    can become valid using the same time format as the  **-l** option.
+    can become valid using the same time format as the  **-l** option;
+    alternately, an absolute time may be specified in one of several
+    forms, including *[[yy]yymmdd]hhmm[ss]* (and some variants with
+    *.* or *:* as a field separator), and some locale-specific time
+    specifications.
 
 **-r** *renewable_life*
     requests renewable tickets, with a total lifetime of