GNU bug report logs - #44707
27.1; Add gnus-article-date-user user-defined examples

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 44707 in the body.
You can then email your comments to 44707 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: 積丹尼 Dan Jacobson <jidanni <at> jidanni.org>
To: bug-gnu-emacs <at> gnu.org
Subject: 27.1; Add gnus-article-date-user user-defined examples
Date: Tue, 17 Nov 2020 14:12:29 +0800

(info "(gnus) Article Date") says

‘W T s’
     Display the date using a user-defined format
     (‘gnus-article-date-user’).  The format is specified by the
     ‘gnus-article-time-format’ variable, and is a string that’s passed
     to ‘format-time-string’.  See the documentation of that variable
     for a list of possible format specs.

Without examples the user is a loss at figuring out how to set this.

Maybe one does
(setq gnus-article-date-user "%a, %d ...")
but probably not.

(info "(gnus) User-Defined Specs")
has no examples either. In fact maybe some words are missing... without
examples one cannot be sure.

gnus-article-date-headers is a variable defined in ‘gnus-art.el’.
its docstring seems to say we can do
(set-variable 'gnus-article-date-headers '(user-defined))

Same on (info "(gnus) Customizing Articles")

Maybe we are supposed to do
(set-variable 'gnus-article-date-headers '("%a, %d...")) but that
triggers an error.

Wait. Let's try
(set-variable 'gnus-article-time-format "%a, %d...")
(set-variable 'gnus-article-date-headers '(user-defined))

Ah, finally I figured out what the docs are trying to say. Wish they
added an example.

Alas, not only does doing that correctly affect W T s itself,
but it also affects all the other W T's!

emacs-version "27.1"

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

From: Lars Ingebrigtsen <larsi <at> gnus.org>
To: 積丹尼 Dan Jacobson <jidanni <at> jidanni.org>
Cc: 44707 <at> debbugs.gnu.org
Subject: Re: bug#44707: 27.1; Add gnus-article-date-user user-defined examples
Date: Tue, 24 Nov 2020 09:39:46 +0100

積丹尼 Dan Jacobson <jidanni <at> jidanni.org> writes:

> (info "(gnus) Article Date") says
>
> ‘W T s’
>      Display the date using a user-defined format
>      (‘gnus-article-date-user’).  The format is specified by the
>      ‘gnus-article-time-format’ variable, and is a string that’s passed
>      to ‘format-time-string’.  See the documentation of that variable
>      for a list of possible format specs.
>
> Without examples the user is a loss at figuring out how to set this.
>
> Maybe one does
> (setq gnus-article-date-user "%a, %d ...")
> but probably not.

The manual describes a command: `W T s', so I'm not sure why you're:

> (set-variable 'gnus-article-date-headers '(user-defined))

In any case, `gnus-article-date-user' has a default value that is pretty
self-explanatory.

Closing.

-- 
(domestic pets only, the antidote for overdose, milk.)
   bloggy blog: http://lars.ingebrigtsen.no

Previous Next

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