all messages for Emacs-related lists mirrored at yhetil.org
 help / color / mirror / code / Atom feed
From: Toby Cubitt <tsc25@cantab.net>
To: 12706@debbugs.gnu.org
Subject: bug#12706: 24.2.50; Outdated timestamp documentation in Elisp manual
Date: Mon, 22 Oct 2012 21:02:28 +0200	[thread overview]
Message-ID: <20121022190228.GA21564@c3po> (raw)

[-- Attachment #1: Type: text/plain, Size: 372 bytes --]

The documentation in the Elisp manual for `file-attributes' and for
file-modification undo-list elements hasn't been updated to match the new
high-precision timestamp format.

Patch attached.

Toby
-- 
Dr T. S. Cubitt
Mathematics and Quantum Information group
Department of Mathematics
Complutense University
Madrid, Spain

email: tsc25@cantab.net
web:   www.dr-qubit.org

[-- Attachment #2: elisp_timestamp_doc.patch --]
[-- Type: text/x-patch, Size: 1659 bytes --]

=== modified file 'doc/lispref/files.texi'
--- doc/lispref/files.texi	2012-10-01 02:07:14 +0000
+++ doc/lispref/files.texi	2012-10-22 18:53:24 +0000
@@ -1220,12 +1220,13 @@
 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
-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.
+The time of last access, as a list of four integers.  The first
+integer has the high-order 16 bits of the seconds, the second integer
+the low 16 bits, the third the microseconds, and the fourth the
+picoseconds.  (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.
 
 @cindex modification time of file
 @item

=== modified file 'doc/lispref/text.texi'
--- doc/lispref/text.texi	2012-09-18 05:14:42 +0000
+++ doc/lispref/text.texi	2012-10-22 18:49:39 +0000
@@ -1233,7 +1233,7 @@
 positive, point was at the beginning of the deleted text, otherwise it
 was at the end.
 
-@item (t @var{high} . @var{low})
+@item (t @var{sec-high} @var{sec-low} @var{msec} @var{usec})
 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


             reply	other threads:[~2012-10-22 19:02 UTC|newest]

Thread overview: 8+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2012-10-22 19:02 Toby Cubitt [this message]
2012-10-22 19:58 ` bug#12706: 24.2.50; Outdated timestamp documentation in Elisp manual Eli Zaretskii
2012-10-22 20:08   ` Glenn Morris
2012-10-22 20:24     ` Toby Cubitt
2012-10-22 20:25     ` Eli Zaretskii
2012-10-23  8:02 ` Paul Eggert
2012-10-23 15:57   ` Glenn Morris
2012-10-24  5:13     ` Paul Eggert

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=20121022190228.GA21564@c3po \
    --to=tsc25@cantab.net \
    --cc=12706@debbugs.gnu.org \
    --cc=toby-dated-1352142136.ff38c0@dr-qubit.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
Code repositories for project(s) associated with this external index

	https://git.savannah.gnu.org/cgit/emacs.git
	https://git.savannah.gnu.org/cgit/emacs/org-mode.git

This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.