GNU bug report logs -
#61325
30.0.50; Jokes in GNUS manual
Previous Next
Reported by: Ihor Radchenko <yantar92 <at> posteo.net>
Date: Mon, 6 Feb 2023 16:02:02 UTC
Severity: wishlist
Found in version 30.0.50
Done: Stefan Kangas <stefankangas <at> gmail.com>
Bug is archived. No further changes may be made.
Full log
Message #296 received at 61325 <at> debbugs.gnu.org (full text, mbox):
[[[ To any NSA and FBI agents reading my email: please consider ]]]
[[[ whether defending the US Constitution against all enemies, ]]]
[[[ foreign or domestic, requires you to follow Snowden's example. ]]]
> > That seems like a useful feature. But the GNUS manual has to explain it.
> And, it does...
> 8.13 Kill Files
> ===============
> Gnus still supports those pesky old kill files. In fact, the kill file
> entries can now be expiring, which is something I wrote before Daniel
> Quinlan thought of doing score files, so I’ve left the code in there.
That section gives full documentation of the kill file feature,
but the text with the joke doesn't say anything about it.
So that section still has the problem I complained about,
of using a term that has not been explained.
That section ought to have a sentence saying what kill files do,
with an xref to the Kill Files node.
Can someone please write that small fix?
> 8.4 Score File Format
> =====================
> A score file is an ‘emacs-lisp’ file that normally contains just a
> single form. Casual users are not expected to edit these files;
> everything can be changed from the summary buffer.
The most important documentation for score files
is how to use the score feature. Does the GNUS manual
have that?
If it already has good documentation of using that feature, there is
no need to write it over again. But the section with the joke needs
to have a sentence or two saying what scores and score files do,
plus a cross reference to the explanation of how to use them.
Can someone please write that small fix?
--
Dr Richard Stallman (https://stallman.org)
Chief GNUisance of the GNU Project (https://gnu.org)
Founder, Free Software Foundation (https://fsf.org)
Internet Hall-of-Famer (https://internethalloffame.org)
This bug report was last modified 1 year and 261 days ago.
Previous Next
GNU bug tracking system
Copyright (C) 1999 Darren O. Benham,
1997,2003 nCipher Corporation Ltd,
1994-97 Ian Jackson.