GNU bug report logs - #10876
Please mention format-time-string in "Time of Day"

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 10876 in the body.
You can then email your comments to 10876 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: Lennart Borgman <lennart.borgman <at> gmail.com>
To: Emacs Bugs <bug-gnu-emacs <at> gnu.org>
Subject: Please mention format-time-string in "Time of Day"
Date: Fri, 24 Feb 2012 03:18:27 +0100

Please mention the function format-time-string in the elisp manual in
the chapter "Time of Day" (39.5 in my version here).

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

From: Chong Yidong <cyd <at> gnu.org>
To: Lennart Borgman <lennart.borgman <at> gmail.com>
Cc: 10876 <at> debbugs.gnu.org
Subject: Re: bug#10876: Please mention format-time-string in "Time of Day"
Date: Sat, 25 Feb 2012 12:39:13 +0800

Lennart Borgman <lennart.borgman <at> gmail.com> writes:

> Please mention the function format-time-string in the elisp manual in
> the chapter "Time of Day" (39.5 in my version here).

Please explain why you think it deserves a special mention.  There are
three nodes all about handling times, one after the other; it is silly
to add links in every node to all the other neighboring nodes, unless
there is a particularly good reason.

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

From: Lennart Borgman <lennart.borgman <at> gmail.com>
To: Chong Yidong <cyd <at> gnu.org>
Cc: 10876 <at> debbugs.gnu.org
Subject: Re: bug#10876: Please mention format-time-string in "Time of Day"
Date: Sat, 25 Feb 2012 06:01:39 +0100

On Sat, Feb 25, 2012 at 05:39, Chong Yidong <cyd <at> gnu.org> wrote:
> Lennart Borgman <lennart.borgman <at> gmail.com> writes:
>
>> Please mention the function format-time-string in the elisp manual in
>> the chapter "Time of Day" (39.5 in my version here).
>
> Please explain why you think it deserves a special mention.  There are
> three nodes all about handling times, one after the other; it is silly
> to add links in every node to all the other neighboring nodes, unless
> there is a particularly good reason.

format-time-string is similar to current-time-string, but more
flexible. So they should probably be mentioned in the same place.

However maybe a better suggestion is to move current-time-string to
"39.7 Parsing and Formatting Times" and add a link to 39.7 from 39.5?
(Actually I think the whole part about "date and time" should be a
little bit reorganized. Having a heading "Date and Time" (instead of
"Time of Day") and subheadings for "Time Conversion" and "Time
Parsing" looks better to me.)

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

From: Chong Yidong <cyd <at> gnu.org>
To: Lennart Borgman <lennart.borgman <at> gmail.com>
Cc: 10876 <at> debbugs.gnu.org
Subject: Re: bug#10876: Please mention format-time-string in "Time of Day"
Date: Sat, 17 Mar 2012 22:00:29 +0800

Lennart Borgman <lennart.borgman <at> gmail.com> writes:

> format-time-string is similar to current-time-string, but more
> flexible. So they should probably be mentioned in the same place.
>
> However maybe a better suggestion is to move current-time-string to
> "39.7 Parsing and Formatting Times" and add a link to 39.7 from 39.5?
> (Actually I think the whole part about "date and time" should be a
> little bit reorganized. Having a heading "Date and Time" (instead of
> "Time of Day") and subheadings for "Time Conversion" and "Time
> Parsing" looks better to me.)

I have tweaked the text to make the connection clearer.

Previous Next

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