[svnbook commit] r3020 - trunk/src/en/book

cmpilato noreply at red-bean.com
Mon Mar 31 22:14:15 CDT 2008


Author: cmpilato
Date: Mon Mar 31 22:14:14 2008
New Revision: 3020

Log:
* src/en/book/ch03-advanced-topics.xml
  Note the differences in the time zones used by the Date and Id
  keywords.  Suggested by Eric Hanchrow <offby1 at blarg.net>.

Modified:
   trunk/src/en/book/ch03-advanced-topics.xml

Modified: trunk/src/en/book/ch03-advanced-topics.xml
==============================================================================
--- trunk/src/en/book/ch03-advanced-topics.xml	(original)
+++ trunk/src/en/book/ch03-advanced-topics.xml	Mon Mar 31 22:14:14 2008
@@ -1519,11 +1519,13 @@
         <term><literal>Date</literal></term>
         <listitem>
           <para>This keyword describes the last time the file was
-            known to have been changed in the repository, and
-            is of the form <literal>$Date:
-            2006-07-22 21:42:37 -0700 (Sat, 22 Jul 2006)
-            $</literal>.  It may also be specified as
-            <literal>LastChangedDate</literal>.</para>
+            known to have been changed in the repository, and is of
+            the form <literal>$Date: 2006-07-22 21:42:37 -0700 (Sat,
+            22 Jul 2006) $</literal>.  It may also be specified as
+            <literal>LastChangedDate</literal>.  Unlike the
+            <literal>Id</literal> keyword, which uses UTC, the
+            <literal>Date</literal> keyword displays dates using the
+            local time zone.</para>
         </listitem>
       </varlistentry>
       <varlistentry>
@@ -1561,13 +1563,16 @@
       <varlistentry>
         <term><literal>Id</literal></term>
         <listitem>
-          <para>This keyword is a compressed combination of the
-            other keywords.  Its substitution looks something like
+          <para>This keyword is a compressed combination of the other
+            keywords.  Its substitution looks something like
             <literal>$Id: calc.c 148 2006-07-28 21:30:43Z sally
             $</literal>, and is interpreted to mean that the file
             <filename>calc.c</filename> was last changed in revision
             148 on the evening of July 28, 2006 by the user
-            <literal>sally</literal>.</para>
+            <literal>sally</literal>.  The date displayed by this
+            keyword is in UTC, unlike that of the
+            <literal>Date</literal> keyword (which uses the local time
+            zone).</para>
         </listitem>
       </varlistentry>
     </variablelist>




More information about the svnbook-dev mailing list