[[[

* subversion-1.1.1.orig/doc/book/book/ch07.xml
  Documentation update for svn:text-time.

]]]


diff -upr subversion-1.1.1.orig/doc/book/book/ch07.xml subversion-1.1.1/doc/book/book/ch07.xml
--- subversion-1.1.1.orig/doc/book/book/ch07.xml	2004-09-14 04:50:26.000000000 +0200
+++ subversion-1.1.1/doc/book/book/ch07.xml	2004-11-09 06:39:07.000000000 +0100
@@ -626,6 +626,9 @@ collabnet = svn.collab.net
                 <command>svn switch</command>, and <command>svn
                 revert</command> commands will also set last-commit
                 timestamps on files that they touch.</para>
+
+              <para>For saving timestamps on a file-by-file-manner please
+                see also <xref linkend="svn-ch-7-sect-2.3.7" />.
             </listitem>
           </varlistentry>
           
@@ -1628,6 +1631,40 @@ Cumulus clouds are appearing more freque
           its use, see <xref linkend="svn-ch-7-sect-3"/>.</para>
 
       </sect3>
+      <sect3 id="svn-ch-7-sect-2.3.7">
+        <title><literal>svn:text-time</literal></title>
+
+        <para>In the <quote>normal</quote> development cycle it is essential
+          that modified files have a newer timestamp, so that tools
+          like <command>make</command> know which files it has to 
+          rebuild.</para>
+
+        <para>This means that version control systems <emphasis>must
+          </emphasis> change a files' modification timestamp to the current
+          value.</para>
+          
+        <para>But this holds true only for development.</para>
+        <para>If you're just versioning your home directory or some 
+          documentation, you'd maybe like to get your files' timestamps 
+          back as they were on a commit.</para>
+
+        <para>That's why there's the <literal>svn:text-time</literal>
+          property. If a file has this property set to any value it
+          will be overwritten <emphasis>on every commit</emphasis> with
+          a string that describes the modification date of this file.</para>
+
+        <para>If the configuration variable <literal>use-commit-times
+          </literal> is also set, then files with this property get their
+          modification time set to the saved values on 
+          <command>svn export</command>, <command>svn checkout</command>
+          and <command>svn update</command>.</para>
+
+        <para>You can set this property on individual files via <command>
+          svn propset</command>, or use the
+          <literal>auto-props</literal> configuration section for 
+          <command>svn import</command> and <command>svn add</command>.</para>
+
+      </sect3>
     </sect2>
 
     <!-- ***************************************************************** -->