[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
bug#37078: 27.0.50; Proposal: new introductory section to the Gnus manua
From: |
Eli Zaretskii |
Subject: |
bug#37078: 27.0.50; Proposal: new introductory section to the Gnus manual |
Date: |
Fri, 24 Jul 2020 22:08:00 +0300 |
> From: Eric Abrahamsen <eric@ericabrahamsen.net>
> Cc: larsi@gnus.org, 37078@debbugs.gnu.org
> Date: Fri, 24 Jul 2020 11:49:19 -0700
>
> Okay, here's another stab at it. Since the sections have been slimmed
> down I've just turned them into headings, which I think aids digestion
> and removes the heading collision problem.
That's okay.
> I feel like adding cross references to the first paragraph of "The
> Basics of Servers, Groups, and Articles" has made it even harder to
> parse, and am inclined to turn that into an unordered list of three
> terms.
I like the result. Maybe I'm biased, so it would be good to hear
other opinions.
A few minor Texinfo comments below.
> +using interactive commands in the Server buffer. See @pxref{Finding
"See @pxref" again.
> +per-group (see @pxref{Mail Sources} for more information).
Same here.
> +@xref{Scanning New Messages} for details on fetching new mail.
^
Please add a comma after the closing brace: old versions of Texinfo
require it.
> +@xref{Selecting a Group} for how to enter a group, and @pxref{Summary
Same here.
> +messages, @xref{Summary Mail Commands} for details.
And here, you want "@pxref" or "see @ref". @xref produces a
capitalized "See", which is inappropriate in the middle of a sentence.
> +For information about what happens once you've started composing a
> +message, @xref{Composing Messages}. For information on setting up
> +@dfn{SMTP} servers in particular, @xref{Mail Variables, ,Mail
> +Variables,message,Message manual}.
Same here (twice).
Also, did you mean @dfn{SMTP} or @acronym{SMTP}?
Thanks.
- bug#37078: 27.0.50; Proposal: new introductory section to the Gnus manual, (continued)
- bug#37078: 27.0.50; Proposal: new introductory section to the Gnus manual, Eric Abrahamsen, 2020/07/20
- bug#37078: 27.0.50; Proposal: new introductory section to the Gnus manual, Lars Ingebrigtsen, 2020/07/20
- bug#37078: 27.0.50; Proposal: new introductory section to the Gnus manual, Eric Abrahamsen, 2020/07/20
- bug#37078: 27.0.50; Proposal: new introductory section to the Gnus manual, Eric Abrahamsen, 2020/07/22
- bug#37078: 27.0.50; Proposal: new introductory section to the Gnus manual, Eli Zaretskii, 2020/07/23
- bug#37078: 27.0.50; Proposal: new introductory section to the Gnus manual, Robert Pluim, 2020/07/23
- bug#37078: 27.0.50; Proposal: new introductory section to the Gnus manual, Eric Abrahamsen, 2020/07/23
- bug#37078: 27.0.50; Proposal: new introductory section to the Gnus manual, Eric Abrahamsen, 2020/07/23
- bug#37078: 27.0.50; Proposal: new introductory section to the Gnus manual, Eli Zaretskii, 2020/07/23
- bug#37078: 27.0.50; Proposal: new introductory section to the Gnus manual, Eric Abrahamsen, 2020/07/24
- bug#37078: 27.0.50; Proposal: new introductory section to the Gnus manual,
Eli Zaretskii <=
- bug#37078: 27.0.50; Proposal: new introductory section to the Gnus manual, Eric Abrahamsen, 2020/07/24
- bug#37078: 27.0.50; Proposal: new introductory section to the Gnus manual, Eli Zaretskii, 2020/07/25
- bug#37078: 27.0.50; Proposal: new introductory section to the Gnus manual, Eric Abrahamsen, 2020/07/27
- bug#37078: 27.0.50; Proposal: new introductory section to the Gnus manual, Lars Ingebrigtsen, 2020/07/27