From: Ben Kaduk <kaduk@mit.edu>
Date: Thu, 5 Jul 2012 18:34:56 +0000 (-0400)
Subject: Document absolute times for 'kinit -s'
X-Git-Tag: krb5-1.11-alpha1~444
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=20f85a81151f69689e3c060e89852687eb6c5a3c;p=thirdparty%2Fkrb5.git

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 6143c95e47..a07962d4d3 100644
--- 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