changeset 35524:91c357a883aa

(Time Stamps): New.

--- a/man/files.texi	Wed Jan 24 22:20:54 2001 +0000
+++ b/man/files.texi	Wed Jan 24 22:21:31 2001 +0000
@@ -434,6 +434,7 @@
 * 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 @@
 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