From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Toby Cubitt Newsgroups: gmane.emacs.bugs Subject: bug#12706: 24.2.50; Outdated timestamp documentation in Elisp manual Date: Mon, 22 Oct 2012 21:02:28 +0200 Message-ID: <20121022190228.GA21564@c3po> Reply-To: Toby Cubitt NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: multipart/mixed; boundary="SUOF0GtieIMvvwua" X-Trace: ger.gmane.org 1350932602 12835 80.91.229.3 (22 Oct 2012 19:03:22 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Mon, 22 Oct 2012 19:03:22 +0000 (UTC) To: 12706@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Mon Oct 22 21:03:30 2012 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1TQNHd-0001mu-Nj for geb-bug-gnu-emacs@m.gmane.org; Mon, 22 Oct 2012 21:03:29 +0200 Original-Received: from localhost ([::1]:43087 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TQNHW-0000wD-4b for geb-bug-gnu-emacs@m.gmane.org; Mon, 22 Oct 2012 15:03:22 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:56737) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TQNHQ-0000vx-5G for bug-gnu-emacs@gnu.org; Mon, 22 Oct 2012 15:03:20 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1TQNHO-0000Fh-Vo for bug-gnu-emacs@gnu.org; Mon, 22 Oct 2012 15:03:16 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:45992) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TQNHO-0000FW-Ss for bug-gnu-emacs@gnu.org; Mon, 22 Oct 2012 15:03:14 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.72) (envelope-from ) id 1TQNJ8-0002yk-Bs for bug-gnu-emacs@gnu.org; Mon, 22 Oct 2012 15:05:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Toby Cubitt Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Mon, 22 Oct 2012 19:05:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 12706 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Original-Received: via spool by submit@debbugs.gnu.org id=B.135093265911389 (code B ref -1); Mon, 22 Oct 2012 19:05:02 +0000 Original-Received: (at submit) by debbugs.gnu.org; 22 Oct 2012 19:04:19 +0000 Original-Received: from localhost ([127.0.0.1]:56243 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1TQNIQ-0002xe-PL for submit@debbugs.gnu.org; Mon, 22 Oct 2012 15:04:19 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:39313) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1TQNIN-0002xR-Re for submit@debbugs.gnu.org; Mon, 22 Oct 2012 15:04:17 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1TQNGW-0008WR-K1 for submit@debbugs.gnu.org; Mon, 22 Oct 2012 15:02:22 -0400 Original-Received: from lists.gnu.org ([208.118.235.17]:52610) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TQNGW-0008WN-HC for submit@debbugs.gnu.org; Mon, 22 Oct 2012 15:02:20 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:56496) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TQNGV-0000qj-Ht for bug-gnu-emacs@gnu.org; Mon, 22 Oct 2012 15:02:20 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1TQNGU-0008W3-DU for bug-gnu-emacs@gnu.org; Mon, 22 Oct 2012 15:02:19 -0400 Original-Received: from sanddollar.geekisp.com ([216.168.135.167]:14919) by eggs.gnu.org with smtp (Exim 4.71) (envelope-from ) id 1TQNGU-0008Vv-8f for bug-gnu-emacs@gnu.org; Mon, 22 Oct 2012 15:02:18 -0400 Original-Received: (qmail 12481 invoked by uid 1003); 22 Oct 2012 19:02:16 -0000 Original-Received: from localhost (localhost.geekisp.com [127.0.0.1]) by localhost.geekisp.com (tmda-ofmipd) with ESMTP; Mon, 22 Oct 2012 15:02:15 -0400 Content-Disposition: inline X-PGP-Key: http://www.dr-qubit.org/gpg-toby.asc User-Agent: Mutt/1.5.21 (2010-09-15) X-Delivery-Agent: TMDA/1.1.11 (Ladyburn) X-Primary-Address: toby@dr-qubit.org X-detected-operating-system: by eggs.gnu.org: Genre and OS details not recognized. X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 2) X-Received-From: 140.186.70.43 X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:65864 Archived-At: --SUOF0GtieIMvvwua Content-Type: text/plain; charset=us-ascii Content-Disposition: inline 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 --SUOF0GtieIMvvwua Content-Type: text/x-patch; charset=us-ascii Content-Disposition: attachment; filename="elisp_timestamp_doc.patch" === 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 --SUOF0GtieIMvvwua--