[Emacs-diffs] /srv/bzr/emacs/trunk r110646: Update manual for new time stamp format.

[Paul Eggert]

------------------------------------------------------------
revno: 110646
fixes bug: http://debbugs.gnu.org/12706
committer: Paul Eggert <address@hidden>
branch nick: trunk
timestamp: Wed 2012-10-24 05:12:23 +0000
message:
  Update manual for new time stamp format.
  
  These instances were missed the first time around.
  Problem reported by Glenn Morris in <http://bugs.gnu.org/12706#25>.
  * doc/lispintro/emacs-lisp-intro.texi (Files List):
  * doc/lispref/buffers.texi (Modification Time):
  * doc/lispref/files.texi (Testing Accessibility, File Attributes):
  * doc/lispref/intro.texi (Version Info):
  * doc/lispref/os.texi (Time of Day):
  * doc/misc/emacs-mime.texi (time-date): 
  Update for new time stamp format (HIGH LOW MICROSEC PICOSEC).
  * doc/misc/emacs-mime.texi (time-date): 
  Also, fix bogus time stamp and modernize a bit.
modified:
  doc/lispintro/ChangeLog
  doc/lispintro/emacs-lisp-intro.texi
  doc/lispref/ChangeLog
  doc/lispref/buffers.texi
  doc/lispref/files.texi
  doc/lispref/intro.texi
  doc/lispref/os.texi
  doc/misc/ChangeLog
  doc/misc/emacs-mime.texi

=== modified file 'doc/lispintro/ChangeLog'
--- a/doc/lispintro/ChangeLog   2012-10-17 03:44:00 +0000
+++ b/doc/lispintro/ChangeLog   2012-10-24 05:12:23 +0000
@@ -1,3 +1,8 @@
+2012-10-24  Paul Eggert  <address@hidden>
+
+       * emacs-lisp-intro.texi (Files List):
+       Update manual for new time stamp format (Bug#12706).
+
 2012-10-17  Gregor Zattler  <address@hidden>  (tiny change)
 
        * emacs-lisp-intro.texi (Narrowing advantages):

=== modified file 'doc/lispintro/emacs-lisp-intro.texi'
--- a/doc/lispintro/emacs-lisp-intro.texi       2012-10-23 15:06:07 +0000
+++ b/doc/lispintro/emacs-lisp-intro.texi       2012-10-24 05:12:23 +0000
@@ -238,7 +238,7 @@
 a division of the               @hfill email: @email{sales@@address@hidden
 Free Software Foundation, Inc.  @hfill Tel: +1 (617) address@hidden
 51 Franklin Street, Fifth Floor @hfill Fax: +1 (617) address@hidden
-Boston, MA 02110-1301 USA       
+Boston, MA 02110-1301 USA
 @end iftex
 
 @ifnottex
@@ -249,7 +249,7 @@
 a division of the                 email: sales@@fsf.org
 Free Software Foundation, Inc.    Tel: +1 (617) 542-5942
 51 Franklin Street, Fifth Floor   Fax: +1 (617) 542-2652
-Boston, MA 02110-1301 USA          
+Boston, MA 02110-1301 USA
 @end example
 @end ifnottex
 
@@ -15680,11 +15680,11 @@
 100
 @end group
 @group
-(17733 259)
-(17491 28834)
-(17596 62124)
-13157
-"-rw-rw-r--"
+(20615 27034 579989 697000)
+(17905 55681 0 0)
+(20615 26327 734791 805000)
+13188
+"-rw-r--r--"
 @end group
 @group
 nil

=== modified file 'doc/lispref/ChangeLog'
--- a/doc/lispref/ChangeLog     2012-10-24 03:48:50 +0000
+++ b/doc/lispref/ChangeLog     2012-10-24 05:12:23 +0000
@@ -1,3 +1,14 @@
+2012-10-24  Paul Eggert  <address@hidden>
+
+       Update manual for new time stamp format (Bug#12706).
+       * buffers.texi (Modification Time):
+       * files.texi (Testing Accessibility, File Attributes):
+       * intro.texi (Version Info):
+       * os.texi (Time of Day):
+       Update for new time stamp format (HIGH LOW MICROSEC PICOSEC).
+       These instances were missed the first time around.
+       Problem reported by Glenn Morris in <http://bugs.gnu.org/12706#25>.
+
 2012-10-24  Chong Yidong  <address@hidden>
 
        * keymaps.texi (Toolkit Differences): Node deleted.

=== modified file 'doc/lispref/buffers.texi'
--- a/doc/lispref/buffers.texi  2012-09-23 10:46:50 +0000
+++ b/doc/lispref/buffers.texi  2012-10-24 05:12:23 +0000
@@ -634,7 +634,8 @@
 @c Emacs 19 feature
 @defun visited-file-modtime
 This function returns the current buffer's recorded last file
-modification time, as a list of the form @code{(@var{high} @var{low})}.
+modification time, as a list of the form @code{(@var{high} @var{low}
address@hidden @var{picosec})}.
 (This is the same format that @code{file-attributes} uses to return
 time values; see @ref{File Attributes}.)
 
@@ -664,9 +665,8 @@
 visited file.
 
 If @var{time} is neither @code{nil} nor zero, it should have the form
address@hidden(@var{high} . @var{low})} or @code{(@var{high} @var{low})}, in
-either case containing two integers, each of which holds 16 bits of the
-time.
address@hidden(@var{high} @var{low} @var{microsec} @var{picosec})},
+the format used by @code{current-time} (@pxref{Time of Day}).
 
 This function is useful if the buffer was not read from the file
 normally, or if the file itself has been changed for some known benign
@@ -1237,4 +1237,3 @@
 @defun gap-size
 This function returns the current gap size of the current buffer.
 @end defun
-

=== modified file 'doc/lispref/files.texi'
--- a/doc/lispref/files.texi    2012-10-23 07:57:42 +0000
+++ b/doc/lispref/files.texi    2012-10-24 05:12:23 +0000
@@ -938,7 +938,7 @@
 @end example
 
 You can use @code{file-attributes} to get a file's last modification
-time as a list of two numbers.  @xref{File Attributes}.
+time as a list of four integers.  @xref{File Attributes}.
 @end defun
 
 @node Kinds of Files
@@ -1228,11 +1228,11 @@
 
 @cindex modification time of file
 @item
-The time of last modification as a list of two integers (as above).
+The time of last modification as a list of four integers (as above).
 This is the last time when the file's contents were modified.
 
 @item
-The time of last status change as a list of two integers (as above).
+The time of last status change as a list of four integers (as above).
 This is the time of the last change to the file's access mode bits,
 its owner and group, and other information recorded in the filesystem
 for the file, beyond the file's contents.
@@ -1275,9 +1275,9 @@
 @group
 (file-attributes "files.texi" 'string)
      @result{}  (nil 1 "lh" "users"
-          (19145 42977)
-          (19141 59576)
-          (18340 17300)
+          (20614 64019 50040 152000)
+          (20000 23 0 0)
+          (20614 64555 902289 872000)
           122295 "-rw-rw-rw-"
           nil  (5888 2 . 43978)
           (15479 . 46724))
@@ -1301,14 +1301,14 @@
 @item "users"
 is in the group with name "users".
 
address@hidden (19145 42977)
-was last accessed on Oct 5 2009, at 10:01:37.
-
address@hidden (19141 59576)
-last had its contents modified on Oct 2 2009, at 13:49:12.
-
address@hidden (18340 17300)
-last had its status changed on Feb 2 2008, at 12:19:00.
address@hidden (20614 64019 50040 152000)
+was last accessed on October 23, 2012, at 20:12:03.050040152 UTC.
+
address@hidden (20000 23 0 0)
+was last modified on July 15, 2001, at 08:53:43 UTC.
+
address@hidden (20614 64555 902289 872000)
+last had its status changed on October 23, 2012, at 20:20:59.902289872 UTC.
 
 @item 122295
 is 122295 bytes long.  (It may not contain 122295 characters, though,

=== modified file 'doc/lispref/intro.texi'
--- a/doc/lispref/intro.texi    2012-10-22 02:22:27 +0000
+++ b/doc/lispref/intro.texi    2012-10-24 05:12:23 +0000
@@ -493,13 +493,13 @@
 
 @defvar emacs-build-time
 The value of this variable indicates the time at which Emacs was
-built.  It is a list of three integers, like the value of
+built.  It is a list of four integers, like the value of
 @code{current-time} (@pxref{Time of Day}).
 
 @example
 @group
 emacs-build-time
-     @result{} (18846 52016 156039)
+     @result{} (20614 63694 515336 438000)
 @end group
 @end example
 @end defvar

=== modified file 'doc/lispref/os.texi'
--- a/doc/lispref/os.texi       2012-10-22 21:57:14 +0000
+++ b/doc/lispref/os.texi       2012-10-24 05:12:23 +0000
@@ -1199,7 +1199,7 @@
 the number of picoseconds from the start of that microsecond to the
 specified time.
 
-  The return value of @code{current-time} represents time using three
+  The return value of @code{current-time} represents time using four
 integers, as do the timestamps in the return value of
 @code{file-attributes} (@pxref{Definition of
 file-attributes}).  In function arguments, e.g.@: the @var{time-value}

=== modified file 'doc/misc/ChangeLog'
--- a/doc/misc/ChangeLog        2012-10-23 07:52:18 +0000
+++ b/doc/misc/ChangeLog        2012-10-24 05:12:23 +0000
@@ -1,3 +1,9 @@
+2012-10-24  Paul Eggert  <address@hidden>
+
+       Update manual for new time stamp format (Bug#12706).
+       * emacs-mime.texi (time-date): Update for new format.
+       Also, fix bogus time stamp and modernize a bit.
+
 2012-10-23  Glenn Morris  <address@hidden>
 
        * cl.texi: Include emacsver.texi.  Use Emacs version number rather

=== modified file 'doc/misc/emacs-mime.texi'
--- a/doc/misc/emacs-mime.texi  2012-01-19 07:21:25 +0000
+++ b/doc/misc/emacs-mime.texi  2012-10-24 05:12:23 +0000
@@ -1516,16 +1516,16 @@
 @result{} 905595714.0
 
 (seconds-to-time 905595714.0)
address@hidden (13818 19266 0)
address@hidden (13818 19266 0 0)
 
 (time-to-days '(13818 19266))
 @result{} 729644
 
 (days-to-time 729644)
address@hidden (961933 65536)
address@hidden (961933 512)
 
 (time-since '(13818 19266))
address@hidden (0 430)
address@hidden (6797 9607 984839 247000)
 
 (time-less-p '(13818 19266) '(13818 19145))
 @result{} nil
@@ -1546,7 +1546,7 @@
 (time-to-number-of-days
  (time-since
   (date-to-time "Mon, 01 Jan 2001 02:22:26 GMT")))
address@hidden 4.146122685185185
address@hidden 4314.095589286675
 @end example
 
 And finally, we have @code{safe-date-to-time}, which does the same as
@@ -1561,7 +1561,7 @@
 12:21:54 1998 +0200"}.
 
 @item time
-An internal Emacs time.  For instance: @code{(13818 26466)}.
+An internal Emacs time.  For instance: @code{(13818 26466 0 0)}.
 
 @item seconds
 A floating point representation of the internal Emacs time.  For