(Topic Commands): Make this the first subsection of

`Group Topics'.  Rearrange keys to mention the most important keys
first and to have subsections.  Add some more explanation for
C-k/C-y.
(Group Buffer): Add comment from Alex Schroeder as todo item.

diff --git a/texi/ChangeLog b/texi/ChangeLog
index 5505463..d4cc59c 100644 (file)
--- a/texi/ChangeLog
+++ b/texi/ChangeLog
@@ -4,6 +4,7 @@
        `Group Topics'.  Rearrange keys to mention the most important keys
        first and to have subsections.  Add some more explanation for
        C-k/C-y.
+       (Group Buffer): Add comment from Alex Schroeder as todo item.
 
 2001-09-06  Kai Gro\e,A_\e(Bjohann  <Kai.Grossjohann@CS.Uni-Dortmund.DE>
 

diff --git a/texi/gnus.texi b/texi/gnus.texi
index 9550b0b..982998e 100644 (file)
--- a/texi/gnus.texi
+++ b/texi/gnus.texi
@@ -1586,6 +1586,26 @@ default is @samp{Tuxedomoon.Jingle4.au}.
 @chapter Group Buffer
 @cindex group buffer
 
+@c Alex Schroeder suggests to rearrange this as follows:
+@c
+@c <kensanata> ok, just save it for reference.  I'll go to bed in a minute.
+@c   1. Selecting a Group, 2. (new) Finding a Group, 3. Group Levels,
+@c   4. Subscription Commands, 5. Group Maneuvering, 6. Group Data,
+@c   7. Group Score, 8. Group Buffer Format
+@c <kensanata> Group Levels should have more information on levels 5 to 9.  I
+@c   suggest to split the 4th paragraph ("Gnus considers groups...") as follows:
+@c <kensanata> First, "Gnus considers groups... (default 9)."
+@c <kensanata> New, a table summarizing what levels 1 to 9 mean.
+@c <kensanata> Third, "Gnus treats subscribed ... reasons of efficiency"
+@c <kensanata> Then expand the next paragraph or add some more to it.
+@c    This short one sentence explains levels 1 and 2, therefore I understand
+@c    that I should keep important news at 3 and boring news at 4.
+@c    Say so!  Then go on to explain why I should bother with levels 6 to 9.
+@c    Maybe keep those that you don't want to read temporarily at 6,
+@c    those that you never want to read at 8, those that offend your
+@c    human rights at 9...
+
+
 The @dfn{group buffer} lists all (or parts) of the available groups.  It
 is the first buffer shown when Gnus starts, and will never be killed as
 long as Gnus is active.
@@ -3557,8 +3577,8 @@ Edit the topic parameters (@code{gnus-topic-edit-parameters}).
 @subsection Topic Variables
 @cindex topic variables
 
-Now, if you select a topic, it will fold/unfold that topic, which is
-really neat, I think.
+The previous section told you how to tell Gnus which topics to display.
+This section explains how to tell Gnus what to display about each topic.
 
 @vindex gnus-topic-line-format
 The topic lines themselves are created according to the