home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 3 / PDCD_3.iso / internet / ttfn / !TTFN / Docs / UserGuide < prev    next >
Text File  |  1994-11-10  |  43KB  |  1,012 lines
  1.  
  2.                                     !TTFN
  3.  
  4.                        (The Thread Following Newsreader)
  5.  
  6.  
  7.            This document was last updated for version 0.35 of !TTFN
  8.  
  9.  
  10. Contents
  11. --------
  12.  
  13.    1.0 Introduction   
  14.        1.1 Concepts    **** IMPORTANT **** READ THIS SECTION ****
  15.            1.1.1 TTFN & NewsBase - How they interact
  16.            1.1.2 Expiry vs. Manual Deletion - How it affects multi-user 
  17.                  operation.
  18.            
  19.    2.0 Running TTFN
  20.       
  21.        2.1 "Application needs xxxk to start up"
  22.        2.2 "TTFN Requires RiscOS 3.10 or later"
  23.        2.3 "Please open a directory containing !Scrap and try again"
  24.        2.4 "<UserHome$Dir> not defined"
  25.        2.5 "TTFN is already running"
  26.        
  27.    3.0 Configuring TTFN
  28.    
  29.        3.1 The setup Window
  30.            3.1.1 "Edit..."
  31.            3.1.2 "Organization"
  32.            3.1.3 "Default User"
  33.            3.1.4 "Time Zone"
  34.            3.1.5 "Attribution"
  35.            3.1.6 "Quote Character"
  36.            3.1.7 "Quote Signatures"
  37.            3.1.8 "Signature"
  38.            3.1.9 "Signature Seperator"
  39.           3.1.10 "Add Tagline"
  40.           3.1.11 "Display Width"
  41.           3.1.12 "Follow Threads"
  42.           3.1.13 "Hide Headers"
  43.           3.1.14 "Article Foreground Colour"
  44.           3.1.15 "Article Background Colour"
  45.           
  46.        3.2 The Address Book
  47.        
  48.        3.3 Distribution Lists
  49.        
  50.    4.0 User Management
  51.    
  52.        4.1 Creating a New User
  53.        4.2 Deleting an Existing User
  54.        4.3 Maintaining User Details       
  55.            4.3.1 Editing the Real-Life Name
  56.            4.3.2 Editing Signature files
  57.            4.3.3 Group Subscription on a per-user basis
  58.     
  59.    5.0 Reading News/Mail
  60.    
  61.        5.1 Obtaining a list of active newsgroups.
  62.        5.2 The NewsGroups window.
  63.        5.3 The Article List window
  64.        5.4 The Threads List window
  65.        5.5 The Article Display window
  66.            5.5.1 The buttons and their functions
  67.            5.5.2 Keypress specific functions
  68.            5.5.3 The article window menu
  69.        5.6 Selecting multiple articles
  70.        5.7 Catching up with a group
  71.        
  72.    6.0 Composing new News/Mail.
  73.    
  74.        6.1 Creating Email
  75.            6.1.1 Creating a new email item
  76.            6.1.2 Replying to an existing item/news article
  77.            6.1.3 "No run action specified for this filetype"
  78.            
  79.        6.2 Creating Usenet News
  80.            6.2.1 Creating a new news article
  81.            6.2.2 Following-Up to an existing article
  82.            6.2.3 Nettiquette
  83.         
  84.        6.3 Posting Composed News & Mail
  85.  
  86.        6.4 Including binary files in outgoing news/mail.
  87.  
  88.    7.0 Files within the Resources directory.
  89.  
  90.    8.0 Advanced Features
  91.    
  92.        8.1 Disabling User Management and Configuration Windows.
  93.        8.2 Forcing startup with a particular user-id.
  94.        
  95.    9.0 Troubleshooting.
  96.    
  97.        9.1 "Aaaaaarrrrggghhh, the posting confirmation box didn't appear!"
  98.        
  99.        
  100. ----------------------------------------------------------------------------
  101.  
  102. 1.0 Introduction
  103. ================
  104.  
  105. THis file was very written in a great hurry, therefore it's probably
  106. quite inaccurate, has apalling spelling and no doubt the grammar leaves
  107. a lot to be desired.  Hopefully you will find the information you require,
  108. if not feel free to email me with questions.
  109.  
  110. This guide is not intended to be a beginners guide to email and news, it
  111. is aimed at people who are already familiar with text messages on the
  112. internet.  The documentation may improve with time, but don't count on
  113. it!
  114.  
  115. This reader has been written with multiple users in mind, but without any
  116. futile attempt at security.  Therefore each user has independant real life
  117. names, signatures and article tracking but no passwords will be asked for
  118. when changing user-id's.  This functionality may be added in later versions,
  119. should there be any demand for it.
  120.  
  121.   1.1 Concepts
  122.   ------------  
  123.     Before going any further it is probably a good idea to familiarise 
  124.     yourself with the concepts behind NewsBase and how they apply to TTFN.
  125.   
  126.     1.1.1 TTFN & NewsBase - How they interact.
  127.     
  128.       NewsBase is a news debatcher and server, to which client newsreaders
  129.       communicate and present the information to the user in a format that
  130.       allows easy browsing.  NewsBase performs *all* functions at the
  131.       transport level and thus isolating clients from it completely.
  132.   
  133.       To this end TTFN gives little functionality unless NewsBase is loaded.
  134.       The order of loading TTFN and NewsBase is irrelevent, but *both* must 
  135.       be loaded in order for TTFN to function as detailed within this 
  136.       document.
  137.   
  138.       If you haven't set up and loaded NewsBase I suggest you do that first,
  139.       the documentation accompanying NewsBase has details of how to do this.
  140.   
  141.     1.1.2 Expiry vs. Manual Deletion - How it affects multi-user operation.
  142.   
  143.       Basically there are two schools of thought about how to deal with
  144.       the deletion of news articles.  On the one side there is the
  145.       "Delete as you read/decide you don't want to read" and the other
  146.       is "Let the system 'expire' old news when it reaches a certain age".
  147.       I am heavily on favour of the latter and would recommend that you
  148.       do *not* enable the deletion of news. My reasons are as follows:
  149.   
  150.         i) Multi-user operation becomes kind of useless.
  151.        ii) Doesn't allow threads to become long enough to follow.
  152.       iii) It is far more sensible to simple "lock" the few articles you
  153.            want to keep against expiry than delete everything but the
  154.            ones you don't want to keep.  
  155.   
  156.       TTFN 0.25 and later does support deletion from newsgroups (enabled by
  157.       turning "Client Deletion" on in NewsBase).  I do not recommend
  158.       this operation and the estimates of unread articles in the newsgroups
  159.       window for users other than the user doing the deletion is highly
  160.       likely to be *very* inaccurate.  *Don't* complain to me.
  161.       
  162.   
  163. 2.0 Running TTFN
  164. ================
  165.  
  166. Double click on the TTFN icon.  There are several possible reasons why
  167. !TTFN could possibly not run.
  168.  
  169.   2.1 Not enough free memory, usually accomanied by a message saying 
  170.       something like "Application needs xxxK to start up".  Make sure the 
  171.       required amount of memory is available and retry.
  172.    
  173.   2.2 "TTFN requires Risc OS 3.10 or later".  You need to have Risc OS 
  174.       version 3.10 or later installed in your machine for this program to 
  175.       run, it will *not* work on Risc OS 2.00
  176.    
  177.   2.3 "Please open a directory containing !Scrap and try again".  During
  178.       operation TTFN needs to generate working files and these are stored 
  179.       within the Acorn supplied application !Scrap, the filer needs to see
  180.       it before TTFN will run.
  181.    
  182.   2.4 "UserHome$Dir not defined".  A system variable called "UserHome$Dir" 
  183.       needs to be defined.  This resides inside !NewsDir and therefore
  184.       !NewsDir needs to have been seen by the filer before running TTFN
  185.       (or newsbase for that matter!).
  186.    
  187.   2.5 "TTFN is already running".  A copy of TTFN is already executing on
  188.       your machine.  You are not allowed to run multiple copies, some
  189.       confusion could occur with respect to tracking read/unread articles
  190.       if this were permitted.
  191.   
  192.   
  193. When you get TTFN to load successfully you will see a new icon appear on
  194. the icon bar, this is the TTFN icon.  The text beneath the icon is the name
  195. of the currently selected user-id.
  196.  
  197.  
  198. 3.0 Configuring TTFN
  199. ====================
  200.  
  201.   3.1 The Setup Window
  202.   --------------------
  203.   
  204.     To configure TTFN you must open the setup window, there are two methods
  205.     of doing this.  Most of the default settings will be acceptable, but you
  206.     may wish to changle some options.
  207.  
  208.     1. Click on the TTFN icon on the iconbar with ADJUST.
  209.  
  210.     2. Click MENU over the TTFN icon and choose "Setup..." from the 
  211.          resulting menu.
  212.    
  213.     All things being equal, the TTFN setup window should now appear.    
  214.    
  215.     Once you have made the required changes to the options click on "OK" just
  216.     to apply them for this session or on "SAVE" to save these settings to 
  217.     disk.  These will then be the settings that TTFN uses