 ==========================================================================
 H E L P
 ==========================================================================
| ===============
| Getting Started
| ===============
| 
|         This document is meant to give you a quick-startup guide to using
| Tknews.  It is recommended that you read through it carefully before going
| any further if you are not yet familiar with this program.
| 
| WHAT IS IT?
| -----------
|         
|         Tknews is a Tk-based newsreader for the X-Windows environment,
| developed through the sponsorship of the Interactive Instructional Computing
| Facilities (IICF) at The Ohio State University.  It is meant as a 
| replacement for rn when the user has access to X Windows (i.e. they are
| not at home dialing in over a modem).
| 
| INTERFACE COMPOSITION
| ---------------------
| 
|         Most of the commands which are accessible to you are available
| through the menubar which you see at the top of the interface.  The best
| way to get familiar with all of the commands which the newsreader provides
| is to browse through these menus.  Below the menubar is a status line,
| and below that a message line.  The status bar provides information about
| the current mode you are in, and the message line displays brief system
| messages.
| 
|         Below these are the metainfo box and the info box.  The metainfo
| box is where you will see information which summarizes things.  It is in
| this area that you will find the listing of the groups which have unread
| articles in them, the list of unread articles in a particular group,
| and the list of newsgroups available for subscribing/unsubscribing.  The
| information contained in the metainfo area depends directly on which
| mode your newsreader is currently in (see MODES below).
| 
|         The info area contains information, generally article bodies,
| but also help information (such as this document).  You will spend most
| of your time looking at this portion of the interface.
| 
| THE BASICS
| ----------
| 
|         So how do you use this thing?  Basically, just remember a few
| key concepts on how tknews operates.  First, anything that is in the
| metainfo listbox can be accessed by double-clicking the first mouse
| button on it.  What type of "access" is done depends on your current
| mode (see Modes, below).  When you double-click on a newsgroup, you
| enter that newsgroup, when you double-click on an article listing, 
| that article is loaded into the text widget.  When you double-click
| in Grouplist mode, you toggle the current subscribed/unsubscribed
| setting for that newsgroup.
| 
|         Another often-used feature is the spacebar.  It performs nearly
| the same function as it does in rn; namely it "does the right thing".
| When you press the spacebar in Groups mode, the currently highlighted
| newsgroup will be loaded.  When you press it in Articles mode, it will
| either scroll the current article's text down a page, or, if you are
| at the end of the current article, it will load in the next unread 
| article.  If no more unread articles are available in the newsgroup,
| the spacebar will bring you back out into the Groups mode once again.
| 
|         It is also very important to know about the key bindings.  Many
| commands are directly related to the rn commands, and are bound to
| the same keyboard strokes.  Some commands, however, are specific to tknews
| and thus don't relate to rn commands.  To get a list of the default
| bindings, select the Bindings item of the Help menu in the menubar.
| 
|         Finally, to help you move the selection around in the
| metainfo listbox, emacs-style bindings are provided for moving the current
| selection.  Control-n will move the highlight bar down one line, Control-p
| will move it up.  The arrow keys also accomplish this.  Control-f and 
| Control-b will move the info text widget up and down a line, respectively.
| 
|         Note also that the return key is equivalent to a double-click in
| terms of effect.
| 
| MODES
| -----
| 
|         There are several modes which the interface supports.  Modes
| are ways of designating certain paradigms in the interface's behavior.
| The modes are described below.
|
| GroupList :  This mode is used for subscribing/unsubscribing to a list
|              of newsgroups.  It is the mode used by both the "New Groups"
|              command and the "All Groups" command.  
| 
| Groups : This mode is used to show the user all of the unread articles
|          in subscribed newsgroups.  It displays a list of all newsgroups
|          with one or more unread articles.
| 
| Articles : This mode is used to browse through the available articles of
|            a newsgroup.  Initially, only unread articles are shown, but
|            various navigational commands allow you to view other,
|            previously read articles.
|
 ==========================================================================
