From: Eric Abrahamsen <eric@ericabrahamsen.net>
To: ding@gnus.org
Subject: Proposed new introductory section to the Gnus manual
Date: Mon, 19 Aug 2019 07:26:17 +0800 [thread overview]
Message-ID: <87o90mm4x2.fsf@ericabrahamsen.net> (raw)
Hi folks,
I just filed this bug:
https://debbugs.gnu.org/cgi/bugreport.cgi?bug=37078, which proposes a
new introductory section to the Gnus manual, called "Don't Panic". It's
meant to be a brief orientation, and a crash course in the style of the
vim tutorials that start with how to quit vim. If this goes in, we might
want to change or remove the existing "Mail in a Newsreader" section of
the manual, which covers some of the same ground, but which I find more
panic-inducing than not :)
Let me know if you have any comments/questions/suggestions!
━━━━━━━━━━━━━
DON’T PANIC
━━━━━━━━━━━━━
Welcome, gentle user, to the Gnus newsreader and email client! Gnus is
unlike most clients, in part because of its gross configurability, and
in part because of its historical origins. While Gnus is now a
fully-featured email client, it began life as a newsreader, and its DNA
is still newsreader DNA. Thus it behaves a little differently than most
mail clients.
The typical assumptions of a newsreader are:
1. The news server offers a potentially enormous number of newsgroups to
read. The user may only be interested in some of those groups, and
more interested in some than others.
2. Groups probably see a high volume of articles, and the user won’t
want to read all of them. Mechanisms are needed for foregrounding
interesting articles, and backgrounding uninteresting articles.
3. Once a group has been scanned and dealt with by the user, it’s
unlikely to be of further interest until new articles come in.
These assumptions lead to certain default Gnus behaviors:
1. Not all interesting groups are equally interesting, thus there are
varying degrees of “subscribedness”, with different behavior
depending on “how subscribed” a group is.
2. There are a large number of commands and tools for scoring and
sorting articles, or otherwise sweeping them under the rug.
3. Gnus will only show you groups with unread or ticked articles; groups
with no new articles are hidden.
4. When entering a group, only unread or ticked articles are shown, all
other articles are hidden.
If this seems draconian, think of it as Enforced Inbox Zero. This is the
way Gnus works by default. It is possible to make it work more like an
email client (always showing read groups and read messages), but that
will take some effort on the part of the user, and Gnus won’t ever
really like it.
The brief introduction below should be enough to get you off the ground.
Servers, Groups, and Articles
═════════════════════════════
The fundamental building blocks of Gnus are servers, groups, and
articles. Servers represent stores of articles, either local or
remote. A server maintains a list of groups, and those groups contain
articles. Because Gnus presents a unified interface to wide variety of
servers, the vocabulary doesn’t always quite line up (see XXX for a
more complete glossary). Thus a local maildir is referred to as a
“server” the same as a Usenet or IMAP server is; “group” might mean an
NNTP group, IMAP folder, or local mail directory; and an “article”
might elsewhere be known as a message or an email. Gnus employs
unified terms for all these things.
A Gnus installation is basically just a list of one or more servers,
plus the user’s subscribed groups from those servers.
Servers can be added and configured in two places: in the user’s
gnus.el startup file, using the `gnus-select-method’ and
`gnus-secondary-select-methods’ options, or within Gnus itself using
commands in the *Server* buffer. See XXX for details.
Some servers (including the more mail-like servers) will automatically
subscribe the user to all their groups. Other servers (more news-like)
will not. In the latter case, it’s necessary to enter the *Server*
buffer (with “^”), press return on the server in question, and then
subscribe to individual groups using “u”.
Getting Mail
════════════
New mail has to come from somewhere. Some servers, such as NNTP or
IMAP, are themselves responsible for adding newly-arrived articles.
Others, such as maildir or mbox servers, only store articles and don’t
fetch them from anywhere.
In the second case, Gnus provides for “mail sources”: places where new
mail is fetched from. A mail source might be a local spool, or a
remote POP server, or some other source of incoming messages. Mail
sources are usually configured globally, but can be specified
per-group (see XXX for more information).
The “g” key is used to update Gnus and fetch new mail. Servers that
fetch their own mail will do so; additionally, all the mail sources
will be scanned for new mail. That incoming mail will then be split
into local servers according to the users splitting rules (see XXX).
Viewing Mail
════════════
By default, Gnus’s *Group* buffer only displays groups with unread
messages. It is always possible to display all the groups temporarily
with “L”, and to configure Gnus to always display some groups (see
XXX). The “j” key will prompt for a group name and jump to it,
displaying it if necessary.
Press “RET” on a group to enter it: by default Gnus will only show
unread and ticked articles. It’s possible to see already-read mail,
either by giving a prefix argument to “RET” before entering the group,
or by pressing “/ o” once the group is open.
Articles can be opened and scrolled using “RET” and/or “SPC”, and “n”
will select the next message.
Sending Mail
════════════
When sending messages, too, Gnus makes a distinction between news-like
and mail-like behavior. News servers handle mail delivery themselves,
and no additional configuration is necessary. Begin composing a news
article using the “a” key in the *Group* buffer, or “f” if you’re in a
group and replying to an article.
Mail message composition starts with “m” in the *Group* buffer, or “r”
if you’re replying to an existing message. Because mail is sent with
SMTP, which is an entirely separate process from the mail-reading
servers, it must also be configured separately, with the option
`message-send-mail-function’ (see XXX).
next reply other threads:[~2019-08-18 23:26 UTC|newest]
Thread overview: 43+ messages / expand[flat|nested] mbox.gz Atom feed top
2019-08-18 23:26 Eric Abrahamsen [this message]
2019-08-19 0:34 ` dick.r.chiang
2019-08-19 1:06 ` Eric Abrahamsen
2019-08-19 2:46 ` Bob Newell
2019-08-19 7:01 ` Eric S Fraga
2019-08-20 4:26 ` Eric Abrahamsen
2019-08-20 11:37 ` dick
2019-09-09 8:13 ` Eric Abrahamsen
2019-09-09 11:52 ` dick
2019-09-09 18:39 ` Bob Newell
2019-09-09 19:48 ` dick
2019-09-10 2:36 ` Eric Abrahamsen
2019-09-10 20:21 ` dick
2019-09-10 23:50 ` Eric Abrahamsen
2019-09-12 19:19 ` Michael
2019-09-13 9:19 ` Eric Abrahamsen
2019-09-13 15:08 ` Eric S Fraga
2019-09-13 16:54 ` Michael
2019-09-16 2:51 ` Eric Abrahamsen
2019-09-13 18:24 ` Bob Newell
2019-09-13 18:39 ` Change input method or smtp server depending on addressee (was: Proposed new introductory section to the Gnus manual) Jorge A. Alfaro-Murillo
2019-09-14 17:38 ` Change input method or smtp server depending on addressee Štěpán Němec
2019-09-16 18:26 ` Bob Newell
2019-09-16 8:52 ` Robert Pluim
2019-12-20 12:54 ` 황병희
2019-09-16 2:55 ` Proposed new introductory section to the Gnus manual Eric Abrahamsen
2019-09-16 18:34 ` Bob Newell
2019-09-10 20:39 ` Adam Sjøgren
2019-09-10 20:54 ` dick
2019-09-12 5:31 ` Steinar Bang
2019-09-07 19:50 ` Adam Sjøgren
2019-09-08 17:00 ` Bob Newell
2019-08-19 16:01 ` Adam Sjøgren
2019-08-19 18:04 ` Bob Newell
2019-08-19 18:09 ` Adam Sjøgren
2019-08-20 4:29 ` Eric Abrahamsen
2019-09-07 19:44 ` Adam Sjøgren
2019-08-19 16:16 ` Eric S Fraga
2019-08-20 7:08 ` Bjørn Mork
2019-08-20 9:51 ` Eric S Fraga
2019-08-20 10:32 ` Bjørn Mork
2019-08-20 10:55 ` Eric S Fraga
2019-08-19 17:55 ` Adam Sjøgren
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=87o90mm4x2.fsf@ericabrahamsen.net \
--to=eric@ericabrahamsen.net \
--cc=ding@gnus.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).