GNU bug report logs - #51852
Gnus: Add User-Defined Spec example

Previous Next

Package: emacs;

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

Date: Sun, 14 Nov 2021 18:22:02 UTC

Severity: normal

Tags: notabug

Done: Lars Ingebrigtsen <larsi <at> gnus.org>

Bug is archived. No further changes may be made.

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

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

View this report as an mbox folder, status mbox, maintainer mbox


Report forwarded to bug-gnu-emacs <at> gnu.org:
bug#51852; Package emacs. (Sun, 14 Nov 2021 18:22:02 GMT) Full text and rfc822 format available.

Acknowledgement sent to 積丹尼 Dan Jacobson <jidanni <at> jidanni.org>:
New bug report received and forwarded. Copy sent to bug-gnu-emacs <at> gnu.org. (Sun, 14 Nov 2021 18:22:02 GMT) Full text and rfc822 format available.

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: Gnus: Add User-Defined Spec example
Date: Mon, 15 Nov 2021 01:21:14 +0800
(info "(gnus) Formatting Basics") says

   Also Gnus supports some extended format specifications, such as
‘%&user-date;’.

OK, please say what user-date is, and list the rest.

Wait, on (info "(gnus) User-Defined Specs") we see it is something we
create ourselves. So on (info "(gnus) Formatting Basics") the "foo"
example should be used, and not "user-date".

And mainly, on (info "(gnus) User-Defined Specs") there is no example of
how to make a User-Defined Spec. E.g., how to continue the example on
(info "(gnus) Advanced Formatting") to finally get 96/08/09 .

By the way, that (info "(gnus) Advanced Formatting") example,

       Let’s take an example.  The ‘%o’ spec in the summary mode lines will
    return a date in compact ISO8601 format—‘19960809T230410’.  This is
    quite a mouthful, so we want to shave off the century number and the
    time, leaving us with a six-character date.  That would be ‘%~(cut-left
    2)~(max-right 6)~(pad 6)o’.  (Cutting is done before maxing, and we need
    the padding to ensure that the date is never less than 6 characters to
    make it look nice in columns.)

is bad programming: not Y10K proof.




Information forwarded to bug-gnu-emacs <at> gnu.org:
bug#51852; Package emacs. (Sun, 14 Nov 2021 18:37:01 GMT) Full text and rfc822 format available.

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

From: Lars Ingebrigtsen <larsi <at> gnus.org>
To: 積丹尼 Dan Jacobson <jidanni <at> jidanni.org>
Cc: 51852 <at> debbugs.gnu.org
Subject: Re: bug#51852: Gnus: Add User-Defined Spec example
Date: Sun, 14 Nov 2021 19:36:09 +0100
積丹尼 Dan Jacobson <jidanni <at> jidanni.org> writes:

> (info "(gnus) Formatting Basics") says
>
>    Also Gnus supports some extended format specifications, such as
> ‘%&user-date;’.
>
> OK, please say what user-date is, and list the rest.

It's documented in the "Summary Buffer Lines" node:

@item &user-date;
Age sensitive date format.  Various date format is defined in
@code{gnus-user-date-format-alist}.

There is (currently) no rest to list.

> And mainly, on (info "(gnus) User-Defined Specs") there is no example of
> how to make a User-Defined Spec. E.g., how to continue the example on
> (info "(gnus) Advanced Formatting") to finally get 96/08/09 .

This seems sufficient?

---
All the specs allow for inserting user defined specifiers---@samp{u}.
The next character in the format string should be a letter.  Gnus
will call the function @code{gnus-user-format-function-}@samp{X}, where
@samp{X} is the letter following @samp{%u}.  The function will be passed
a single parameter---what the parameter means depends on what buffer
it's being called from.
---

So there doesn't seem to be anything here to do, and I'm closing this
bug report.  If you want help with using Gnus, then I suggest asking on
an Emacs help-oriented mailing list.

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




Added tag(s) notabug. Request was from Lars Ingebrigtsen <larsi <at> gnus.org> to control <at> debbugs.gnu.org. (Sun, 14 Nov 2021 18:37:02 GMT) Full text and rfc822 format available.

bug closed, send any further explanations to 51852 <at> debbugs.gnu.org and 積丹尼 Dan Jacobson <jidanni <at> jidanni.org> Request was from Lars Ingebrigtsen <larsi <at> gnus.org> to control <at> debbugs.gnu.org. (Sun, 14 Nov 2021 18:37:02 GMT) Full text and rfc822 format available.

Information forwarded to bug-gnu-emacs <at> gnu.org:
bug#51852; Package emacs. (Mon, 15 Nov 2021 18:45:01 GMT) Full text and rfc822 format available.

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

From: 積丹尼 Dan Jacobson <jidanni <at> jidanni.org>
To: Lars Ingebrigtsen <larsi <at> gnus.org>
Cc: 51852 <at> debbugs.gnu.org
Subject: Re: bug#51852: Gnus: Add User-Defined Spec example
Date: Tue, 16 Nov 2021 02:44:31 +0800
Yes you have an example of how to call the function, but
I'm saying you need to add at least one example of the function itself.
E.g., like on https://www.emacswiki.org/emacs/GnusFormatting#h5o-7




bug archived. Request was from Debbugs Internal Request <help-debbugs <at> gnu.org> to internal_control <at> debbugs.gnu.org. (Tue, 14 Dec 2021 12:24:06 GMT) Full text and rfc822 format available.

This bug report was last modified 2 years and 95 days ago.

Previous Next


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