[Emacs-diffs] /srv/bzr/emacs/trunk r110628: Fix outdated timestamp documentation in Elisp manual.

[Paul Eggert]

------------------------------------------------------------
revno: 110628
fixes bug: http://debbugs.gnu.org/12706
committer: Paul Eggert <address@hidden>
branch nick: trunk
timestamp: Tue 2012-10-23 00:57:42 -0700
message:
  Fix outdated timestamp documentation in Elisp manual.
  
  * doc/lispref/files.texi (File Attributes):
  * doc/lispref/text.texi (Undo):
  Time stamp resolution is now 1 picosecond, not 1 second.
  * etc/NEWS: Document increased precision in undo list.
modified:
  doc/lispref/ChangeLog
  doc/lispref/files.texi
  doc/lispref/text.texi
  etc/ChangeLog
  etc/NEWS

=== modified file 'doc/lispref/ChangeLog'
--- a/doc/lispref/ChangeLog     2012-10-23 02:39:13 +0000
+++ b/doc/lispref/ChangeLog     2012-10-23 07:57:42 +0000
@@ -1,3 +1,10 @@
+2012-10-23  Paul Eggert  <address@hidden>
+
+       Fix outdated timestamp documentation in Elisp manual (bug#12706).
+       * files.texi (File Attributes):
+       * text.texi (Undo):
+       Time stamp resolution is now 1 picosecond, not 1 second.
+
 2012-10-23  Chong Yidong  <address@hidden>
 
        * display.texi (Font Lookup): Remove font-list-limit.

=== modified file 'doc/lispref/files.texi'
--- a/doc/lispref/files.texi    2012-10-01 02:07:14 +0000
+++ b/doc/lispref/files.texi    2012-10-23 07:57:42 +0000
@@ -1220,9 +1220,8 @@
 The file's @acronym{GID}, likewise.
 
 @item
-The time of last access, as a list of two integers.
-The first integer has the high-order 16 bits of time,
-the second has the low 16 bits.  (This is similar to the
+The time of last access, as a list of four integers @code{(@var{sec-high}
address@hidden @var{microsec} @var{picosec})}.  (This is similar to the
 value of @code{current-time}; see @ref{Time of Day}.)  Note that on
 some FAT-based filesystems, only the date of last access is recorded,
 so this time will always hold the midnight of the day of last access.

=== modified file 'doc/lispref/text.texi'
--- a/doc/lispref/text.texi     2012-09-18 05:14:42 +0000
+++ b/doc/lispref/text.texi     2012-10-23 07:57:42 +0000
@@ -1233,11 +1233,12 @@
 positive, point was at the beginning of the deleted text, otherwise it
 was at the end.
 
address@hidden (t @var{high} . @var{low})
address@hidden (t @var{sec-high} @var{sec-low} @var{microsec} @var{picosec})
 This kind of element indicates that an unmodified buffer became
-modified.  The elements @var{high} and @var{low} are two integers, each
-recording 16 bits of the visited file's modification time as of when it
-was previously visited or saved.  @code{primitive-undo} uses those
+modified.  The list @code{(@var{sec-high} @var{sec-low} @var{microsec}
address@hidden)} represents the visited file's modification time as of
+when it was previously visited or saved, using the same format as
address@hidden; see @ref{Time of Day}.  @code{primitive-undo} uses those
 values to determine whether to mark the buffer as unmodified once again;
 it does so only if the file's modification time matches those numbers.
 

=== modified file 'etc/ChangeLog'
--- a/etc/ChangeLog     2012-10-21 01:35:46 +0000
+++ b/etc/ChangeLog     2012-10-23 07:57:42 +0000
@@ -1,3 +1,8 @@
+2012-10-23  Paul Eggert  <address@hidden>
+
+       Fix outdated timestamp documentation in Elisp manual (bug#12706).
+       * NEWS: Document increased precision in undo list.
+
 2012-10-21  Glenn Morris  <address@hidden>
 
        * images/icons/hicolor/32x32/apps/emacs22.png:

=== modified file 'etc/NEWS'
--- a/etc/NEWS  2012-10-23 02:39:13 +0000
+++ b/etc/NEWS  2012-10-23 07:57:42 +0000
@@ -843,6 +843,9 @@
 The PSECS slot is new, and uses picosecond resolution.  It can be
 accessed via the new timer--psecs accessor.
 
+*** Last-modified time stamps in undo lists now are of the form
+(t HI-SECS LO-SECS USECS PSECS) instead of (t HI-SECS . LO-SECS).
+
 +++
 ** Floating point functions now always return special values like NaN,
 instead of signaling errors, if given invalid args, e.g. (log -1.0).