GNU bug report logs - #12706
24.2.50; Outdated timestamp documentation in Elisp manual

Previous Next

To add a comment to this bug, you must first unarchive it, by sending
a message to control AT debbugs.gnu.org, with unarchive 12706 in the body.
You can then email your comments to 12706 AT debbugs.gnu.org in the normal way.

Toggle the display of automated, internal messages from the tracker.

Message #5 received at submit <at> debbugs.gnu.org (full text, mbox):

From: Toby Cubitt <tsc25 <at> cantab.net>
To: bug-gnu-emacs <at> gnu.org
Subject: 24.2.50; Outdated timestamp documentation in Elisp manual
Date: Mon, 22 Oct 2012 21:02:28 +0200

[Message part 1 (text/plain, 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 <at> cantab.net
web:   www.dr-qubit.org

[elisp_timestamp_doc.patch (text/x-patch, attachment)]

Message #8 received at 12706 <at> debbugs.gnu.org (full text, mbox):

From: Eli Zaretskii <eliz <at> gnu.org>
To: Toby Cubitt <toby-dated-1352142136.ff38c0 <at> dr-qubit.org>
Cc: 12706 <at> debbugs.gnu.org
Subject: Re: bug#12706: 24.2.50;
	Outdated timestamp documentation in Elisp manual
Date: Mon, 22 Oct 2012 21:58:52 +0200

> Date: Mon, 22 Oct 2012 21:02:28 +0200
> From: Toby Cubitt <tsc25 <at> cantab.net>
> 
> 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.

That's normal at this stage: documentation usually gets updated only
late in the release process, which didn't start yet.  There are
markings in etc/NEWS that tell which changes are not documented yet.

> Patch attached.

Thanks.

Message #11 received at 12706 <at> debbugs.gnu.org (full text, mbox):

From: Glenn Morris <rgm <at> gnu.org>
To: Eli Zaretskii <eliz <at> gnu.org>
Cc: Toby Cubitt <toby-dated-1352142136.ff38c0 <at> dr-qubit.org>,
	12706 <at> debbugs.gnu.org
Subject: Re: bug#12706: 24.2.50;
	Outdated timestamp documentation in Elisp manual
Date: Mon, 22 Oct 2012 16:08:29 -0400

Eli Zaretskii wrote:

>> 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.
>
> That's normal at this stage: documentation usually gets updated only
> late in the release process, which didn't start yet.  There are
> markings in etc/NEWS that tell which changes are not documented yet.

The file-attributes entry is marked with "---", so it's good that we
have this report.

Message #14 received at 12706 <at> debbugs.gnu.org (full text, mbox):

From: Toby Cubitt <toby-dated-1352147036.f557d3 <at> dr-qubit.org>
To: Glenn Morris <rgm <at> gnu.org>
Cc: Eli Zaretskii <eliz <at> gnu.org>, 12706 <at> debbugs.gnu.org
Subject: Re: bug#12706: 24.2.50; Outdated timestamp documentation in Elisp
	manual
Date: Mon, 22 Oct 2012 22:24:07 +0200

On Mon, Oct 22, 2012 at 04:08:29PM -0400, Glenn Morris wrote:
> Eli Zaretskii wrote:
> 
> >> 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.
> >
> > That's normal at this stage: documentation usually gets updated only
> > late in the release process, which didn't start yet.  There are
> > markings in etc/NEWS that tell which changes are not documented yet.

Ah, I didn't realise that's how things worked. I'll know for next
time. Thanks!

> The file-attributes entry is marked with "---", so it's good that we
> have this report.

Glad it's still useful for something. I suspect the changes to the undo
entry format also risked being overlooked too, since they aren't
mentioned explicitly in that etc/NEWS entry.

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

email: tsc25 <at> cantab.net
web:   www.dr-qubit.org

Message #17 received at 12706 <at> debbugs.gnu.org (full text, mbox):

From: Eli Zaretskii <eliz <at> gnu.org>
To: Glenn Morris <rgm <at> gnu.org>
Cc: toby-dated-1352142136.ff38c0 <at> dr-qubit.org, 12706 <at> debbugs.gnu.org
Subject: Re: bug#12706: 24.2.50;
	Outdated timestamp documentation in Elisp manual
Date: Mon, 22 Oct 2012 22:25:54 +0200

> From: Glenn Morris <rgm <at> gnu.org>
> Cc: Toby Cubitt <toby-dated-1352142136.ff38c0 <at> dr-qubit.org>,  12706 <at> debbugs.gnu.org
> Date: Mon, 22 Oct 2012 16:08:29 -0400
> 
> Eli Zaretskii wrote:
> 
> >> 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.
> >
> > That's normal at this stage: documentation usually gets updated only
> > late in the release process, which didn't start yet.  There are
> > markings in etc/NEWS that tell which changes are not documented yet.
> 
> The file-attributes entry is marked with "---"

Then _that_ is a bug.

Message #22 received at 12706-done <at> debbugs.gnu.org (full text, mbox):

From: Paul Eggert <eggert <at> cs.ucla.edu>
To: Toby Cubitt <toby-dated-1352142136.ff38c0 <at> dr-qubit.org>
Cc: 12706-done <at> debbugs.gnu.org
Subject: 24.2.50; Outdated timestamp documentation in Elisp manual
Date: Tue, 23 Oct 2012 01:02:13 -0700

Thanks for the bug report.  I installed a fix for it in
trunk bzr 110628, which you can see here:

http://bzr.savannah.gnu.org/lh/emacs/trunk/revision/110628

Message #25 received at 12706 <at> debbugs.gnu.org (full text, mbox):

From: Glenn Morris <rgm <at> gnu.org>
To: 12706 <at> debbugs.gnu.org
Cc: eggert <at> cs.ucla.edu
Subject: Re: bug#12706: 24.2.50;
	Outdated timestamp documentation in Elisp manual
Date: Tue, 23 Oct 2012 11:57:13 -0400

Paul Eggert wrote:

> Thanks for the bug report.  I installed a fix for it in
> trunk bzr 110628, which you can see here:
>
> http://bzr.savannah.gnu.org/lh/emacs/trunk/revision/110628

There's still more to do.


You can use @code{file-attributes} to get a file's last modification
time as a list of two numbers.  @xref{File Attributes}.

@cindex modification time of file
@item
The time of last modification as a list of two integers (as above).

@item
The time of last status change as a list of two integers (as above).

For example, here are the file attributes for @file{files.texi}:
[...]
@item (19145 42977)
was last accessed on Oct 5 2009, at 10:01:37.


etc.

Message #28 received at 12706 <at> debbugs.gnu.org (full text, mbox):

From: Paul Eggert <eggert <at> cs.ucla.edu>
To: Glenn Morris <rgm <at> gnu.org>
Cc: 12706 <at> debbugs.gnu.org
Subject: Re: bug#12706: 24.2.50; Outdated timestamp documentation in Elisp
	manual
Date: Tue, 23 Oct 2012 22:13:44 -0700

On 10/23/2012 08:57 AM, Glenn Morris wrote:
> There's still more to do.

Thanks, I fixed the documentation problems you mentioned
(and a few others that I found after looking again)
in trunk bzr 110646.

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.