From: Dave Love <fx@gnu.org>
Date: Wed, 24 Jan 2001 22:21:31 +0000 (+0000)
Subject: (Time Stamps): New.
X-Git-Tag: emacs-pretest-21.0.96~116
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=9575b9aedb2df889d960705ffa21e282e18fbc2d;p=emacs.git

(Time Stamps): New.
---

diff --git a/man/files.texi b/man/files.texi
index 9e86b3e336a..fc134885ca0 100644
--- a/man/files.texi
+++ b/man/files.texi
@@ -434,6 +434,7 @@ every time a file is saved or written.  The default is @code{nil}.
 * Interlocking::        How Emacs protects against simultaneous editing
                           of one file by two users.
 * Shadowing: File Shadowing. Copying files to `shadows' automatically.
+* Time Stamps::         Emacs can update time stamps on saved files.
 @end menu
 
 @node Backup
@@ -762,6 +763,31 @@ asked again next time you hit @kbd{C-x 4 s} or exit Emacs.  If you do
 not want to be asked again, use @kbd{M-x shadow-cancel}, and you will
 not be asked until you change the file and save it again.
 
+@node Time Stamps
+@subsection Updating Time Stamps Automatically
+@findex time-stamp
+@cindex time stamps
+@cindex modification dates
+
+You can arrange to have time stamp text in a file updated
+automatically to reflect the modification time when you save the
+file.  To do this, include in the first eight lines a template like
+@example
+Time-stamp: <>
+@end example
+@noindent
+or
+@example
+Time-stamp: ""
+@end example
+@noindent
+and customize the value of the hook @code{write-file-hooks} to add
+@code{time-stamp}.  Such a template is updated with the current time
+and date when the file is written.
+
+You can customize the form of the template and the time string used
+along with other parameters in the Custom group @code{time-stamp}.
+
 @node Reverting
 @section Reverting a Buffer
 @findex revert-buffer