Introduction to group scan mode
[9/1/93: Not finished yet, but still helpful.]
[Started 1/8/93 by Clifford A. Adams]
[Last Modified 6/22/93]

	The group scan mode is a full-screen interface to newsgroup
selection and manipulation.  When it is completed it will be a
replacement for the newsgroup selection level of trn.  Group scan uses
much of the same code as the article scan mode and most of the basic
commands are similar.  To enter group scan mode, type ':' (colon) at the
newsgroup selection level.
(Type the letter 'h' in group scan mode for on-line help.)

	By default, group scan displays all subscribed newsgroups which
have unread articles.  Here is a sample (small) group scan screen:

---------- cut ----------
Top Level | all
+....    3> comp.risks
+....  411  comp.sys.amiga.games
+....    1  news.future
+....   32  news.software.readers
+....    4  news.announce.newgroups
+....    1  comp.sources.testers
+M...   29  comp.os.linux.announce
+.... 1422  comp.os.linux
+M...    3  comp.windows.x.announce
+M...    1  comp.sources.games
+....    2  alt.society.futures
+....    6  bit.listserv.xtropy-l
-TOP-
---------- cut ----------
...Each line represents one newsgroup, with the following meanings:
+M...    29> comp.os.linux.announce
|||||    | |      \--name of newsgroup
|||||    | \---------selection pointer
|||||    \-----------number of unread articles
||\\\----------------currently unused status columns.
|\-------------------"M" indicates a moderated newsgroup.
\--------------------group status: "+" means subscribed with unread articles

	One can move the selection pointer on the screen and between
screens of newsgroups with the same commands used in article scan mode
(see the article scan documentation for more details).  When the pointer
is next to a desired group, one can type a newsgroup command to enter
that group and start reading.  The newsgroup commands are:
	 'y': enters the newsgroup "the old fashioned way"
	      (by displaying the first unread article)
	 '=': enters the newsgroup through the '=' command
	 '+': enters the newsgroup via the TRN thread selector.
	 ';': enters the newsgroup using the article scan interface
SPACE/RETURN: enters the newsgroup using a default command
	      (The default command is usually the thread selector ('+').
	       See the "user configuration" instructions to change
	       this default.)

Other group scan mode commands:

n,p,<,>,t,b,^,$
	Movement commands which act the same as article scan mode.
^L,^R	Redraws the entire screen.
q	Quits the current level.  If at the "Top Level", exits strn.
	[The "Top Level" behavior may change.]
Q	Quits from group scan back to trn's newsgroup selection level.
	(One can then return to the same place in group scan later.)
L	Lists (toggles) newsgroup descriptions (if available).
	Newsgroup descriptions are currently only available with NNTP/INN
	servers supporting the "xgtitle" command.
	(Later strn versions should be more flexible.)
!cmd    Escape to a subshell and execute cmd.
&       Print current values of command-line switches.
&switch {switch}
        Set or unset more switches.
&&      Print current macro definitions.
&&def   Define a new macro.

Group display:
	Group scan has several commands to control which newsgroups are
displayed.  By default, only newsgroups with unread articles are displayed.
(Topic files and lists are always displayed.)  This behavior can be
changed with the following keys:

0	Toggle display newsgroups with no (0) unread articles.
	Entering one of these groups will enable unread+read display
	(in article scan), or use the select-unread when entering with
	the '+' command. 
U	Toggle display of unsubscribed newsgroups only.  Entering an
	unsubscribed newsgroup will ask the user to resubscribe.
A	Toggle display of all newsgroups (including unsubscribed,
	bogus, and empty groups (those with no existing articles))
u	Toggles the subscription status of the current newsgroup.

Moving between newsgroups:
N,P	When typed in article scan or the TRN thread selector strn will
	go to the Next/Previous newsgroup and start reading it.

