GNU bug report logs -
#55569
Improve documentation of mail-user-agent
Previous Next
Reported by: Damien Cassou <damien <at> cassou.me>
Date: Sun, 22 May 2022 06:17:01 UTC
Severity: minor
Tags: patch
Done: Eli Zaretskii <eliz <at> gnu.org>
Bug is archived. No further changes may be made.
Full log
View this message in rfc822 format
> From: Damien Cassou <damien <at> cassou.me>
> Cc: 55569 <at> debbugs.gnu.org
> Date: Sun, 22 May 2022 09:18:58 +0200
>
> Hi Eli,
>
> Eli Zaretskii <eliz <at> gnu.org> writes:
> >> +@code{mh-e-user-agent}. Additional options may be available; check
> >> +with the author of your mail user agent package for details. You may
> >> +also define another mail user agent using `define-mail-user-agent'.
> >
> > Thanks, but what do you mean by "the author of your mail user agent
> > package"?
>
>
> I mean that the authors of notmuch and mu4e both define a symbol to be
> used as value for the `mail-user-agent` variable: `mu4e-user-agent` and
> `notmuch-user-agent`. These symbols should be documented somewhere in
> notmuch and mu4e manuals so their users know they should pass them to
> `mail-user-agent`. There might be other mail user agent packages out
> there that I don't know about.
>
>
> > This is an Emacs user manual, and I very much doubt that
> > Emacs users could figure out where and how to check that.
> >
> > Can we provide more practical advice here how to check for those
> > additional options?
>
>
> I could certainly mention the symbols for notmuch and mu4e if you think
> that is ok to mention external packages inside the Emacs manual but I'm
> not sure what else I could do.
If those additional options are supposed to be documented in the MUA
manual, let's suggest that users look in those manuals. That is IMO
better than to send them to some unnamed "authors".
This bug report was last modified 2 years and 362 days ago.
Previous Next
GNU bug tracking system
Copyright (C) 1999 Darren O. Benham,
1997,2003 nCipher Corporation Ltd,
1994-97 Ian Jackson.