
                           =====  T. T. F. N.  =====

                       (The Thread Following Newsreader)


   This document was last updated by Robert Orwin for version 0.35 of !TTFN

      Further development of TTFN since source release of version 0.39 in
      April 1997, by Richard Sargeant.  Updated for some changes in 0.40.


Contents
--------

   1.0 Introduction
       1.1 Concepts    **** IMPORTANT **** READ THIS SECTION ****
           1.1.1 TTFN & NewsBase - How they interact
           1.1.2 Expiry vs. Manual Deletion - How it affects multi-user
                 operation.

   2.0 Running TTFN

       2.1 "Application needs xxxk to start up"
       2.2 "TTFN requires RISC OS 3.10 or later"
       2.3 "Please open a directory containing !Scrap and try again"
       2.4 "TTFN is already running"

   3.0 Configuring TTFN

       3.1 The setup Window
           3.1.1 "Edit..."
           3.1.2 "Organization"
           3.1.3 "Default User"
           3.1.4 "Ext. Edit"
           3.1.5 "Time Zone"
           3.1.6 "Attribution"
           3.1.7 "Quote Character"
           3.1.8 "Quote Signatures"
           3.1.9 "Signature"
          3.1.10 "Signature Separator"
          3.1.11 "Add Tagline"
          3.1.12 "Display Width"
          3.1.13 "Follow Threads"
          3.1.14 "Hide Headers"
          3.1.15 "Article Foreground Colour"
          3.1.16 "Article Background Colour"

       3.2 The Address Book

       3.3 Distribution Lists

   4.0 User Management

       4.1 Creating a New User
       4.2 Deleting an Existing User
       4.3 Maintaining User Details
           4.3.1 Editing the Real-Life Name
           4.3.2 Editing Signature files
           4.3.3 Editing Address Book
           4.3.4 Miscellaneous files in the home directory
           4.3.5 Group Subscription on a per-user basis

   5.0 Reading News/Mail

       5.1 Obtaining a list of active newsgroups.
       5.2 The NewsGroups window.
       5.3 The Article List window
       5.4 The Threads List window
       5.5 The Article Display window
           5.5.1 The buttons and their functions
           5.5.2 Keypress specific functions
           5.5.3 The article window menu
       5.6 Selecting multiple articles
       5.7 Catching up with a group

   6.0 Composing new News/Mail.

       6.1 Creating Email
           6.1.1 Creating a new email item
           6.1.2 Replying to an existing item/news article
           6.1.3 "No run action specified for this filetype"

       6.2 Creating Usenet News
           6.2.1 Creating a new news article
           6.2.2 Following-Up to an existing article
           6.2.3 Netiquette

       6.3 Posting Composed News & Mail

       6.4 Including binary files in outgoing news/mail.

   7.0 Files within the Resources directory.

   8.0 Advanced Features

       8.1 Disabling User Management and Configuration Windows.
       8.2 Forcing startup with a particular user-id.

   9.0 Troubleshooting.

       9.1 "Aaaaaarrrrggghhh, the posting confirmation box didn't appear!"
       9.2 "The estimate of unread articles appears to be incorrect."
       9.3 "I'd like to contribute material for use in this user guide."


----------------------------------------------------------------------------

1.0 Introduction
================

This file was very written in a great hurry, therefore it's probably
quite inaccurate, has appalling spelling and no doubt the grammar leaves
a lot to be desired.  Hopefully you will find the information you require,
if not feel free to email me with questions.

This guide is not intended to be a beginners guide to email and news, it
is aimed at people who are already familiar with text messages on the
internet.  The documentation may improve with time, but don't count on
it!

This reader has been written with multiple users in mind, but without any
futile attempt at security.  Therefore each user has independent real life
names, signatures and article tracking but no passwords will be asked for
when changing user-id's.  This functionality may be added in later versions,
should there be any demand for it.

  1.1 Concepts
  ------------
    Before going any further it is probably a good idea to familiarise
    yourself with the concepts behind NewsBase and how they apply to TTFN.

    1.1.1 TTFN & NewsBase - How they interact.

      NewsBase is a news debatcher and server, to which client newsreaders
      communicate and present the information to the user in a format that
      allows easy browsing.  NewsBase performs *all* functions at the
      transport level and thus isolating clients from it completely.

      To this end TTFN gives little functionality unless NewsBase is loaded.
      The order of loading TTFN and NewsBase is irrelevant, but *both* must
      be loaded in order for TTFN to function as detailed within this
      document.

      If you haven't set up and loaded NewsBase I suggest you do that first,
      the documentation accompanying NewsBase has details of how to do this.

    1.1.2 Expiry vs. Manual Deletion - How it affects multi-user operation.

      Basically there are two schools of thought about how to deal with
      the deletion of news articles.  On the one side there is the
      "Delete as you read/decide you don't want to read" and the other
      is "Let the system 'expire' old news when it reaches a certain age".
      I am heavily on favour of the latter and would recommend that you
      do *not* enable the deletion of news. My reasons are as follows:

        i) Multi-user operation becomes kind of useless.
       ii) Doesn't allow threads to become long enough to follow.
      iii) It is far more sensible to simple "lock" the few articles you
           want to keep against expiry than delete everything but the
           ones you don't want to keep.

      TTFN 0.25 and later does support deletion from newsgroups (enabled by
      turning "Client Deletion" on in NewsBase).  I do not recommend
      this operation and the estimates of unread articles in the newsgroups
      window for users other than the user doing the deletion is highly
      likely to be *very* inaccurate.  *Don't* complain to me.


2.0 Running TTFN
================

Double click on the TTFN icon.  There are several possible reasons why
!TTFN could possibly not run.

  2.1 Not enough free memory, usually accompanied by a message saying
      something like "Application needs xxxK to start up".  Make sure the
      required amount of memory is available and retry.

  2.2 "TTFN requires RISC OS 3.10 or later".  You need to have RISC OS
      version 3.10 or later installed in your machine for this program to
      run, it will *not* work on RISC OS 2.00, and probably not 3.00.

  2.3 "Please open a directory containing !Scrap and try again".  During
      operation TTFN needs to generate working files and these are stored
      within the Acorn supplied application !Scrap, the filer needs to see
      it before TTFN will run.

  2.4 "TTFN is already running".  A copy of TTFN is already executing on
      your machine.  You are not allowed to run multiple copies, some
      confusion could occur with respect to tracking read/unread articles
      if this were permitted.


When you get TTFN to load successfully you will see a new icon appear on
the icon bar, this is the TTFN icon.  The text beneath the icon is the name
of the currently selected user-id.


3.0 Configuring TTFN
====================

  3.1 The Setup Window
  --------------------

    To configure TTFN you must open the setup window, there are two methods
    of doing this.  Most of the default settings will be acceptable, but you
    may wish to change some options.

    1. Click on the TTFN icon on the iconbar with ADJUST.

    2. Click MENU over the TTFN icon and choose "Setup..." from the
         resulting menu.

    All things being equal, the TTFN setup window should now appear.

    Once you have made the required changes to the options click on "OK" just
    to apply them for this session or on "SAVE" to save these settings to
    disk.  These will then be the settings that TTFN uses each time it is
    run.

    There follows a description of each configuration option, those marked
    with three asterisks (***) are the fields you *should* change.

    3.1.1 Edit...

      This is accompanied by two buttons labelled "Address Book" and
      "TagLines".  Clicking on one of them will bring up the appropriate
      file into an editor for you to edit.  See also sections: 3.2
      and 3.1.11.

      The icon marked "Dist. Lists" will open a directory viewer, on
      the directory that contains all your distribution lists.  Edit the
      files as you wish.

    3.1.2 Organization: ***

      Enter your organization description here, this is incorporated into
      every outgoing mail and news item that is sent from within TTFN.
      If you delete all text from this writable icon no "Organization:"
      line will be generated on outgoing news/mail.  If a user has an
      special organization line defined in Newsbase, that will be used
      instead of the default organization line which is what's set here.

    3.1.3 Default User: ***

      The user that will be selected when TTFN starts up.  Select your
      preferred user from those available, or if your desired username is
      not present see section 4, entitled "User Management".

    3.1.4 Ext. Edit:

      If this option is enabled then TTFN will first try to ask any editor
      application that is running and supports the external editing
      protocol to assist with TTFN to edit your new message.  TTFN will
      fall-back to the built in OLE facility if no suitable editor is
      running - this does not work for some StrongEd users.  External
      editing is new to TTFN 0.40, and tested with Zap and StrongEd.

    3.1.5 Time Zone:

      The setting for the time zone is now read direct from RISC OS.

    3.1.6 Attribution Lines:

      This is the line that is put directly before a quoted article in a
      news followup or a mail reply.  Usually takes the form of:

           In article <msg-id>, <real-name> wrote:

           Where %m becomes the Message-ID.
                 %d becomes the Date: header line.
                 %u becomes the senders RL name (for followups) or
                            "you" for personal replies.
                 %r becomes the senders real life name irrespective of
                            being a followup or personal reply.
                 %e becomes the senders email address.
                 %n becomes a newline character.

      *NB* both %m and %u will insert "you" if no real life name was found
           on the From: line.

      So, to get output as the above example you would enter

             In article %m, %u wrote:

      Attribution lines for usenet news and private email replies may be
      configured independently and two separate writable icons are provided
      for this reason.

    3.1.7 Quote Character:

      This is the character that the quoted message is indented with.  The
      convention in usenet is to use a single greater than sign, followed by
      a single space ("> "), but there is space to input up to three
      characters should you deem them necessary.

    3.1.8 Quote Signatures:

      This controls the quoting of signatures when replying to an email item
      or following up to a news article.  When selected, all of the previous
      article will be quoted. When this is not ticked it attempts to stop
      quoting when it finds a line containing only the string in the
      "Signature Separator" field.

    3.1.9 Signature:

      Determines which set of signature files should be used, to edit
      signature files for a particular user, please read the section 4,
      entitled "User Management".  Setting this to "Normal" will be adequate
      for initial use.

    3.1.10 Signature Separator:

      This is used when generating outgoing articles and is placed just
      before any signature files and before a tagline is appended.  This can
      be used to allow intelligent newsreaders/composers to automatically
      cut signatures from quoted postings when replying to/following up to
      mail/news items.  The general UseNet convention is to use two minus
      signs followed by a single space ("-- ").

    3.1.11 Add Tagline:

      Taglines could be considered almost as a cult within the FidoNet
      world, and I like them so this option got implemented!  If this option
      is ticked TTFN will add a tagline to your outgoing messages *after*
      your signature and will be picked at random from the file
      <TTFN$Dir>.Resources.TagLines.

    3.1.12 Display Width:

      This is the maximum width of the article display window measured in
      characters.  80 is a general convention, but I would recommend setting
      this to the maximum width your favourite screen mode will allow.

    3.1.13 Follow Threads:

      Decides whether the reader (you) gets to use the thread following
      abilities on selected groups.  The thread following facilities within
      TTFN comprise of grouping articles together by subject line and when
      this option is turned on you can configure thread following for each
      individual group.  See also: section 5.2.

    3.1.14 Hide Headers:

      When turned on this will suppress the display of article headers
      within the article display window by simply auto scrolling the window
      down to a point where the headers are not visible.  This is useful for
      people who are not using a larger than standard screen mode.

      Also will determine whether message headers are printed with articles.

    3.1.15 Article Foreground Colour:

      Choose the colour you desire for the text display in the article
      window.

    3.1.16 Article BackGround Colour:

      Choose the colour of the background in the article window.


  3.2 The Address Book
  --------------------

    TTFN has built into it the ability to specify and use a list of
    frequently posted to email addresses.  To access the file that defines
    this list open the !TTFN setup window and click on the icon labelled
    "Edit... Address Book".

    This file should contain one line per address of the format:

       <Description>,<Email Address>

    <Description> is for your information only, it will be displayed on
    a menu from which you pick that entry.

    <Email Address> should be a valid email address _or_ a hash character
    (#) followed by the name of a valid distribution list (see section 3.2).

    The two are separated by a comma followed by any number of spaces or tab
    characters.

    The end of the address book list is signified by one line containing:

      end,

    if it is not present then the behaviour of TTFN (up to and including
    version 0.39) is, um, err _undefined_  ;-)

    When you are finished, save the file back out to the default path
    (i.e. press F3 then <enter>).

  3.3 Distribution Lists
  ----------------------

    Sometimes it is convenient to post to a "list" of people rather than to
    each one independently.  TTFN now supports distribution list expansion.
    You create/edit your distribution lists by simply typing into an editor
    a list of email addresses, one per line and saving it into the directory
    viewer opened by pressing "Edit... Dist Lists" from the TTFN setup
    window.  There are a couple of examples already present.

    You use the filename of the distribution list as the name of the list,
    and putting a hash followed by the distribution list name in the
    To:, Cc: or Bcc: writable icons of the new mail/reply dialogue box,
    prefixed with a hash character (#).  This will cause it to be expanded
    to the list of email addresses within that distribution list.

    *NB* this will only work correctly if, when specifying a distribution
    list, there is *nothing* else specified within that line.  i.e.
    the following are acceptable.

       #Authors
       #test

    The following is not acceptable:

      rob@wong.demon.co.uk, #Authors

    The following will not be processed correctly:

      #Authors, rob@wong.demon.co.uk

    Hopefully these shortcomings will be rectified soon.


4.0 User Management
===================

Without a doubt the standard distribution of TTFN will not have your
preferred username configured and you will want to add your own.

To open the user management window, click with MENU on the TTFN icon and
choose "Users..." from the resulting menu.

  4.1 Creating a new user

    In the section labelled "Create User", type in the new username and
    either press <return> or click on the button labelled "Add".  If
    no error message is produced you now have a new user-id.  The TTFN
    message window will appear informing you of the creation of your
    user-id if the addition was successful.  Click anywhere within the
    message window to close it.

  4.2 Deleting an existing user

    In the section labelled "Delete User", select the unwanted user from
    the menu available and then click on erase.  You will not be allowed
    to delete users named "root" or "postmaster" and neither will you be
    allowed to delete the currently selected user.  The TTFN message
    window will appear informing you of the deletion of the unwanted
    user-id if deletion was successful.

  4.3 Maintaining User details

    In the section labelled "Edit User Details", select the user you
    wish to edit.

    4.3.1 Editing the Real Life Name

      Simply type in the replacement Real-Life name and press either
      <return> or click on "Set".  Newsbase will update the details.

    4.3.2 Editing Signature Files

      Click on the button appropriate to the signature file you wish to
      edit.  Simply save the edited file back to it's original location
      when you are happy with it.  If you have taglines turned on you
      should have *TWO BLANK LINES* at the end of the signature file.

    4.3.3 Editing Address Book

      Allows the default address book to be replaced on a per-user basis.
      If this file is missing or has no entries, the default book is used.

    4.3.4 Miscellaneous files in the home directory

      The files Signature, AltSig1, AltSig2, and AddrBook are the four
      that are edit by using the icons described in 4.3.2 and 4.3.3.
      In the same directory, two other files may be created manually,
      and will be used as follows.  NoArchive is a file that is scanned
      each time a new news posting or followup article is created and
      contains a list of newsgroups for which you want to include the
      header "X-No-Archive: yes" - reputable search engines on the
      Internet will then ignore the item when they index articles.  URL
      is a file that will make TTFN generate a "X-URL: <URL>" header
      on new news and mail items.  The first line in this file is used,
      and should contain the user's chosen URL; eg. http://www.demon.net/

    4.3.5 Group Subscription on a per-user basis.

      Each user can 'subscribe' to a subset of the available groups (i.e.
      as listed by NewsBase).  You may, for example, have two people using
      the same dial-up account, but want to read entirely different
      newsgroups.  TTFN 0.30 and later allows you to decide exactly
      what groups each user sees in the Newsgroups window.

      Within the user management window, there is an option called
      "Group subscription", this will produce a menu of *all* the available
      groups for that particular user, and allow you to subscribe to/
      unsubscribe from each group independently, a tick by the group name
      indicates that you are subscribed to that group.

      As each user encounters new groups that have been created, TTFN will
      ask if you want to be subscribed to each group.  You can either
      click on "Yes" or "No" to decide on a per-new-group basis or click
      on "Yes to All" or "No to All" to indicate your preference on all
      new groups.  You will *not* be asked about any new Email.* groups,
      instead each user is automatically subscribed to their own
      Email.<username>* groups and automatically unsubscribed to
      everyone else's.  If you want to be able to view someone else's
      email groups you can still achieve this via the User Management
      window.


5.0 Reading News/Mail
=====================

For instructions on how to start a new debatch please see the documentation
accompanying NewsBase.  This section will assume you have successfully
configured both NewsBase *and* TTFN, and that you have managed to
successfully debatch a news download.

  5.1 Obtaining a list of active newsgroups
  -----------------------------------------

    Ensure that both NewsBase and TTFN are loaded.  Single click on the
    TTFN icon on the icon bar, and after a short delay you should be
    presented with a window containing a list of newsgroups to which you
    are subscribed.  This is the "NewsGroups" window.

  5.2 The NewsGroups window
  -------------------------

    This shows a list of currently existing newsgroups within your news
    database.  Initially this will consist of just two, namely Email.root
    and Email.postmaster.

    To the immediate left of each newsgroup name is a radio button, this
    determines whether TTFN will attempt to follow threads, each group
    can have it's radio button set independently of the others.  To change
    the state of a radio button, single click on it with SELECT.  A radio
    button in the "on" position indicates thread following is active. See
    also: section 3.1.13.

    On the right hand side of the newsgroups window are two columns of
    numbers, representing (left to right) the number of unread articles
    and the total number of articles in each group.  These figures are
    estimates and may be incorrect occasionally, but will be corrected
    when you open a group for perusal.

    In order to open a group and be presented with either a list of
    articles or a list of threads, double click with SELECT on your
    chosen newsgroup name.  Depending on the status of the associated
    radio button (see above) you will now be presented with either
    the Article List window or the Thread List window.

    Double-clicking on a group with ADJUST will result in TTFN attempting
    to not list the majority of the articles that have already been
    read.

    Pressing the SPACE BAR while the newsgroups window has the input focus
    will result in the first group with unread articles being opened.

    The usual cursor/paging/home/end keys can be used to navigate this
    window when it has the input focus.  You can also press "Escape"
    to close it.

  5.3 The Article List window
  ---------------------------

    This contains a list of articles contained within your selected
    newsgroup.  Three items of information are listed for each group, from
    left to right these are:

      The article number (as allocated by !NewsBase)
      The "Subject:" line of the article
      The sender of the article.

    Initially all article subjects will be displayed in black on a grey
    background.  This indicates that the articles have not been read.
    Later, when you have read an article, the subject display will change
    to a dark grey colour to indicate that the article has been read.

    To view and article double click on it.  This will present you with
    a display of the article.  For an explanation of what does what in
    this window see section 5.5 "The Article Display window".

    The usual cursor/paging/home/end keys can be used to navigate this
    window when it has the input focus.  You can also press "Escape"
    to close it.  Pressing the space-bar will open the article display
    window on the first unread article.  If there are no unread articles
    to be read, the article list window is closed.

  5.4 The Thread List window
  --------------------------

    This contains a list of unique subject lines that exist within
    the current group.  Each subject is displayed along with two numbers,
    the left-most being the number of unread articles within that "thread"
    and the other one being the total number of articles within that
    "thread".  Double clicking on a thread title will display an article
    from the thread, if there were unread articles it will display the
    first unread article.  If there are no unread articles in your
    chosen thread it will show the first article within the thread.
    Either way the Article display window will be opened (see next
    section).

    The usual cursor/paging/home/end keys can be used to navigate this
    window when it has the input focus.  You can also press "Escape"
    to close it.  Pressing the space-bar will open the article display
    window on the first unread article in the first thread with an
    unread article.  If there are no unread articles to be read, the
    thread list window will be closed.

  5.5 The Article Display window
  ------------------------------

    This displays the actual articles.  At the top you will see some
    information displayed about the current article, including the
    identification of the author and the subject line of the article/
    email item.  You will also see a row of buttons which perform various
    functions.

    5.5.1 The buttons and their functions

    " < "      = Previous article (in group/thread)
                 Also operable by pressing the left cursor key or
                 "B" for "B"ack.

    "Del"      = Delete article (This may not be available in newsgroups,
    	       	 see the newsbase option entitled "Allow Deletion").

    " > "      = Next article (in group/thread)
                 Also operable by pressing the right cursor key
                 or the "N" key.

    "Followup" = Start a followup article (newsgroups only)
                 Also operable by pressing "F".

    "Reply"    = Start a personal reply to sender of current article
                 Also operable by pressing "R".

    "Post"     = Create a new posting.
                 Also operable by pressing "P".

    "Mail"     = Create a new personal Email item
                 Also operable by pressing "M".

    Locking and unlocking the displayed article (respected by a NewsBase
    expiry operation) is performed by clicking on the PadLock icon in the
    top right hand corner of the window.

    5.5.2 Keypress specific functions

      Other keys which perform functions within this window are as follows.

      Space-Bar  : This is very much of a "Do-The-Right-Thing" button.
                   Will proceed to next article *if* the bottom of the
                   current article has been seen, otherwise performs a
                   Page-Down operation.

      Page-Down  : Pages the article display down by one screenful.

      Page-Up    : Pages the article display up by one screenful.

      Up-Cursor  : Scrolls the article display up by one line.

      Down-Cursor: Scrolls the article display down by one line.

      Home       : Scrolls the article display to the very top.

      End/Copy   : Scrolls the article display to the very bottom.

      D		 : Starts a uudecoding operation on the current article.
                   (equivalent to choosing "UUdecode" from the article
                   window menu.

      L          : Toggle the lock status of the current article.

      U          : Marks the current article as being "unread".

      G          : Open URL contained in the "X-URL:" header (if present).

      X          : Toggles the rot13 display.

      F3         : Opens a save dialogue box, allowing you to save the
                   current article to a file or to another application.

      PRINT      : Produces a hard copy of the current article.  Because
                   this function requires the cooperation of the Printers
                   application, an error message will occur if it is not
                   already running before choosing to print a message.

      DELETE     : Will delete the current article from the news database
                   (newsbase settings permitting) and progress to the
                   next unread article.

      $          : Valid if a header only article is shown (contains no
                   body text) and requests to download it again in full.


      NB: "Next Article" when threading will take you to the next
          article in that thread.  When at the end of a thread it will
          take you to the next unread article in the next thread with
          unread articles (accompanied by a flashing of the subject
          line at the top of the article display window to signify change
          of thread), otherwise it will close the article display.

    5.5.3 The Article Window Menu

      Pressing "MENU" while the mouse pointer is over the main article
      display window will yield the following options:

      "Save"        : leads to a save dialogue box, allowing you to
                      save the current article to a text file.  You can
                      optionally strip the header lines from the saved
                      file.

      "Mark"        : leads to a submenu that allows you to mark the
                      current article as being unread or read by the
                      current user.

      "File Article": Allows filing of articles into user defined
                      folders.  The last option on this menu is
                      a writable icon, allowing you to create a new
                      folder by specifying a name.  The folder will
                      then be created and displayed in the NewsGroups
                      window as "Folder.<what-you-typed>".

      "Cancel"      : Cancellation of Usenet messages.  In the majority of
                      cases this will be greyed out and unavailable.  It
                      will only be available when viewing an article that
                      *you* have posted (i.e. <current-user>@<your-host>).
                      This option will generate a control message that will
                      be uploaded to the news server, which will in turn
                      pass it on to other servers in an effort to cancel
                      your posting.

      "UUdecode"    : Starts a uudecoding process on the current article.
       		      This version of TTFN does not support multi-part
       		      uuencodings (to be remedied soon) and will pop
       		      up a save box when the uudecoding has completed.
                      Simply drag the icon to a filer window to save it.

  5.6 Selecting multiple articles
  -------------------------------

    Within both the Article list window and the Thread List window it
    is possible to "select" multiple articles and perform operations
    on them as a group.

    Selecting multiple articles is achieved by use of the "SELECT" and
    "ADJUST" buttons in conjunction with drag operations.  Try it out and
    see what can be done.  Selected articles are signified by being
    displayed in reverse video (i.e. white on black as opposed to the
    more usual black on white).  Alternatively you can press "MENU" over
    either window and use the "Select" submenu to to select either:

    "All"    - Will select all articles/threads.
    "Read"   - Will select all read articles/threads containing at least
               one read article.
    "Unread" - Will select all unread articles/threads contain only
               unread articles.

    Once you have your desired articles selected using the "Selection"
    submenu from the main menu you can:

    "Mark as"   : Mark selected articles as being read or unread.

    "File in"   : File selected articles in a folder of your choice
                  (NB for large numbers of articles this can take
                  some time!)

    "Lock"      : Lock selected articles against deletion.

    "Unlock"    : Unlock articles, allowing an expiry operation to
                  delete them.

    "Clear"     : Deselects all the selected articles.

    "Delete"    : Deletes the selected articles - only available in
                  "Email.*", "Folder.*" and "junk" groups.

  5.7 Catching up with a group
  ----------------------------

    This option is available from the first level menu on both the Article
    and Thread list windows, it is a quick way of marking all unread
    articles as being "read", thus "Catching Up" on the current group.


6.0 Composing new News/Mail
===========================

  6.1 Creating Email
  ------------------

    In general, an email item will either be a new "conversation" or a
    continuation of an existing one.

    6.1.1 Creating a new email

      There are several possible ways to initiate this:

        1. From the NewsGroups window, press "MENU" and click on
           "Compose Mail"

        2. From either the Article List or Thread List window click on menu
           and choose "Mail" from the "Compose" submenu.

        3. Click on the "Mail" button in the main article display window

      To:, Cc: and Bcc:  enter a valid email address or multiple valid
             email addresses separated by commas.  Alternatively click
             on the small icon just to the right of the writable icons
             to reveal the address book.  Using SELECT on the address
             book will insert the appropriate email address, using ADJUST
             will append the appropriate email address

             The Bcc: line is ignored by current versions of TTFN and
             NewsBase - anything entered there will be ignored.

       Subject: Enter a short description of the subject matter of your
             mail item.

       You can ask the remote system to return a receipt to you when
       the message has been received by the remote system (NB, this
       will not signify when the recipient actually read the mail,
       just when it arrived at the remote system).  To ask for
       a receipt use the option box marked "Return Receipt".  It is
       worth noting that not all systems honour this feature, and
       it cannot be relied upon.

    6.1.2 Replying to an existing mail item

      To reply to an existing mail item (or write a personal reply to the
      author of a news article), display the required message as described
      in previous sections and then click on the button marked "Reply".
      After a short a dialogue box will appear containing information about
      the followup, you may change some aspect of it if it is unacceptable.
      Clicking on OK will, after a short delay, bring up an editor window.
      You can now make you additions and then post the reply in the manner
      described in section 6.3

      Within the dialogue box mentioned above, clicking on "OK" with SELECT
      will result in the previous article being quoted, using ADJUST will
      generate a reply without quoting said article.

      A receipt can be requested upon delivery to the remote system by
      using the option box called "Return Receipt". See above section
      for a fuller description.

    6.1.3 No run action specified for this filetype.

      This error message is generated by the filer when a file is
      run and it cannot figure out which program to load in order to
      deal with it.  If you see while attempting to use TTFN then
      almost certainly your filer has not seen a text editor.  Open
      a filer window containing a text editor (!Edit will do) and
      then everything should proceed unhindered.

      Clicking on "Followup" with SELECT will result in the article being
      quoted, using ADJUST will generate a reply without quoting said
      article.

  6.2 Creating Usenet News
  ------------------------

    As with email you either create a new "thread" or "conversation" within
    a newsgroup group or you "follow-up" to an existing one.

    6.2.1 Creating a new news item

      This is created in very much the same manner as new email items, you
      can do any of the following three things to initiate a new email item.

        1. From the NewsGroups window, press "MENU" and click on
           "Compose News"

        2. From either the Article List or Thread List window click on menu
           and choose "News" from the "Compose" submenu.

        3. Click on the "Post" button in the main article display window

      All three of these actions will result in the displaying of a small
      dialogue box entitled "New Email".  The following fields are available
      for user input:

        Newsgroups/Followup-To:  Enter a list of valid newsgroups separated
                    by commas. Clicking on the small icon to the right of
                    this writable icon will bring up a menu containing a
                    list of newsgroups that exist within your news database.
                    Choosing one results in it's name being inserted into
                    the writable icon.

        Subject   : Enter a one-line summary of the content of your new
                    article.

        Keywords  : An optional field, fill in something relevant if you
                    feel like it!

       Clicking on "OK" will then build a blank message, which will be
       loaded into your favourite editor for you to write your message.
       For "how to post my composed news" see section 6.3

    6.2.2 Following-Up to an existing news article.

      To followup to an existing news article display the required message
      as described in previous sections and then click on the button marked
      "Followup".  After a short a dialogue box will appear containing
      information about the followup, you may change some aspect of it if it
      is unacceptable.  Clicking on OK will, after a short delay, bring up
      an editor window.  You can now make you additions and then post the
      reply in the manner described in section 6.3

      Within the dialogue box mentioned above, clicking on "OK" with SELECT
      will result in the previous article being quoted, using ADJUST will
      generate a reply without quoting said article.

    6.2.3 Netiqutte

      This is basically a list of "don't do's" when posting usenet news,
      none of what follows is strictly enforced but if you don't follow
      it you'll end up rubbing other users up the wrong way, and probably
      get some nasty email too.

      1. Signatures should be kept to a minimum, 4 or 5 lines is acceptable
         anything more is considered "over the top" and a waste of
         bandwidth.

      2. Quoting.  Always try and keep quoting the previous article to
         a minimum.  Quote just enough so that your comments make sense
         to someone who as not seen the previous article, but most
         definitely do not quote a 40+ line message and then add "I agree"
         at the bottom.

      3. No advertising of commercial products or services.  Thankfully
         usenet has been relatively free of this kind of mass junk
         mailing - lets keep it that way.

      4. Try and keep on-topic when in a particular newsgroup.

      5. It's a good idea to "lurk" in a newsgroup (read but not
         contribute) for a while - you get to know what annoys the
         regulars and what would be sensible postings.  i.e. don't
         just dive into the red dwarf group shouting "those ending
         lyrics, is it 'Goldfish Shouls' or 'Goldfishes' ".  You
         won't enjoy the responses.

      6. Don't ask "How do I create a new newsgroup".  The basic
         sentiment on this subject is that if you don't know, or don't
         know how to find out then you probably haven't considered the
         implications of creating a new group.  If you really want to
         know the answer, read alt.config for a while.

  6.3 Posting your composed News & Mail
  -------------------------------------

    OK, so you have your newly created masterpiece in !Edit (or whatever)
    and you can't figure out how to post it.  Press F3 to bring up the
    save file dialogue box and save the file.  Close the editor window
    and a small dialogue box will pop-up asking you to confirm the posting
    of your inane ramblings :-)  Click on "Send" to send it, or double-
    click on "Discard" to not send it.  The other option displayed lets
    you continue editing the message, by clicking on "Resume editing".

    If external editing is in use, the editor window will shut after saving.

  6.4 Including binary files in outgoing News/Mail
  ------------------------------------------------

    The most widely spread method of mailing/posting binary file is to
    uuencode the file first.  This basically turns an 8-bit binary file
    into 7-bit ASCII so it can be transmitted across non 8-bit clean
    transport systems (such as SMTP).  Dragging a non-Text file onto
    the TTFN icon on the icon bar will result in it being uuencoded
    and a save box will pop up.  From here you can drag it to either
    a filer window or to another application.

    To include a uuencoded file in a message you are composing, simply
    place the caret in your message at the point you wish to include
    the file, drag your archive (or whatever) to the TTFN icon and
    then drag the text-file icon from the resulting save box to your
    editor window, then post your message in the usual manner.  Simple!


7.0 Files within the "Resources" Directory
==========================================

  This is where several 'special' files are stored.  The names of these
  files are fixed and you should be very careful when editing them.

  DO NOT EDIT the files that are marked as such.

   AddrBook   - The TTFN address book, see section 3.2

   Taglines   - Should contain one-line quotes/funny statements, one of
                which will be tagged on the end of each post/mailing you
                make if the "Add Tagline" option within the "Signature"
                section of the setup window is selected.

   !Config    - Configuration of TTFN - Alteration other than from within
                the TTFN configuration window is not recommended.
                *** DO NOT EDIT ***

   Messages   - Various bits of information relating to TTFN.  Some
                variables that affect the way TTFN operates.
                *** DO NOT EDIT *** (unless you know what you're doing)

   Templates  - Window definitions.
                *** DO NOT EDIT *** (unless you know what you're doing)

   !Newsbase  - Obey file - checks if Newsbase has already been located
                (usually by the filer) and starts it up.  Used when
                Newsbase has not been detected and SELECT has been
                clicked on the TTFN application icon (on the iconbar).
                May be replaced with !Newsbase application, in which
                case it will be *Filer_Run instead - the indication that
                Newsbase is not ready is unavailable in the latter mode.
                *** DO NOT EDIT *** (unless you know what you're doing)

    Sprites   - Sprites required by some TTFN windows (standard resolution)
    Sprites22 - Sprites required by some TTFN windows (higher resolution)

    Icons     - Extra sprites for RISC OS 3.10 used if !NewLook not present.
    Icons22   - Extra sprites for RISC OS 3.10 used if !NewLook not present.


8.0 Advanced Features
=====================

  8.1 Disabling User Management and Setup Windows
  -----------------------------------------------

    When operating TTFN in a multi-user environment, it is sometimes
    desirable to stop access to the User Management and Configuration
    windows.  To do this requires you to edit the !TTFN.Resources.Messages
    file.

    To disable the user management functions, look for the line starting
    "sec.users" and change the following "TRUE" to "FALSE".

    To disable the setup window, look for the line starting "sec.setup"
    and change the following "TRUE" to "FALSE".

  8.2 Forcing startup with a particular user-id
  ---------------------------------------------

    You can force TTFN to startup with *any* user-id, regardless of the
    default user setting by means of a command line parameter (say, from
    a !SLIPdial script).  To do this simply use the "-user <user-id>"
    parameters.  E.g. to load TTFN with user "root" active, use something
    like:

      WimpTask !TTFN -user root


9.0 Troubleshooting
===================

  9.1 "Aaaaaarrrrggghhh, the posting confirmation box didn't appear!"
  -------------------------------------------------------------------

  It's OK, you can stop panicking, your masterpiece is intact.  Simply
  select "Rescue" from the TTFN iconbar icon, your editing session will
  be restored.  Close the editor window to post your mail/news.

  9.2 "The estimate of unread articles appears to be incorrect."
  --------------------------------------------------------------

  This may happen if for any reason an article is deleted either by
  another user, or by Newsbase *before* it has been marked as read.
  The correct number of articles unread will be calculated and shown
  once the full list of articles/threads in a group has been opened.

  9.3 "I'd like to contribute material for use in this user guide."
  -----------------------------------------------------------------

          Arnold's Laws of Documentation:
          1) If it should exist, it doesn't.
          2) If it does exist, it's out of date.
          3) Only documentation for useless programs
             transcends the first two laws.

  If you find something that you feel should be changed in this guide,
  or have some useful material which may be added to the next version,
  then please send it by electronic mail to ttfn@arcade.demon.co.uk.

  The majority of this text is still as supplied by Robert Orwin in 0.39.

----------------------------------------------------------------------------
fin