home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 3 / TheARMClub_PDCD3.iso / hensa / internet / easymail_1 / !Help next >
Text File  |  1994-01-22  |  45KB  |  987 lines
  1.  
  2. !Help file for EasyMail, Version 0.4 (22-Jan-1994)
  3. ==================================================
  4.  
  5. This !Help file is a 'rough guide' to EasyMail, and not a definative manual.
  6. A full manual requires some time to write, unfortunately I don't have enough
  7. time at present.
  8.  
  9. If you do have further questions concerning the use of EasyMail, then please
  10. feel free to post a public message to the 'General Acorn' conference area
  11. on Digital Databank BBS, or to demon.ip.support.archimedes newsgroup on demon.
  12.  
  13.  
  14. Copyright:
  15. =========
  16. 1.  EasyMail and all associated documentation is Copyright © 1994,1995,
  17.     Marc L.Veary.  All rights reserved.
  18. 2.  The software and all associated documentation is Public Domain and may
  19.     not be sold or included with any commercial software without the author's
  20.     written permission.  Public Domain Libraries, however, may distribute the
  21.     program provided they charge no more than 3 pounds Sterling per disc.
  22. 3.  The author, Marc L.Veary cannot accept any liability in anyway whatsoever
  23.     for any loss or damage whether monetary, data, computer hardware or
  24.     otherwise, cause from the use or misuse of this program or the information
  25.     contained within any associated documentation.
  26. 4.  The author can be contacted by E-Mail:
  27.        Digital Databank BBS: (0707) 329 306  - Marc Veary (#585)
  28.        Arcade BBS:           (0181) 654 2212 - Marc Veary (#1517)
  29.        Internet:             marc@mlveary.demon.co.uk
  30.  
  31. Acknowledgements:
  32. ================
  33. Many thanks to Simon Glass for the seed idea, Andrew Black for initial testing
  34. and comments, John Stonier, Dave Dade, Kevin Quinn, Steve Costine, Ben Summers
  35. and Steve Turnbull for the advice, encouraging and testing.  Thanks also to all
  36. those not named here for all the comments and suggestions, you know who you
  37. are...
  38.  
  39. Please Help:
  40. ===========
  41. EasyMail is a PD program which is under constant maintenance, therefore,
  42. please let me know of any bugs, comments, suggestions, or criticisms you might
  43. have concerning this program.  I would like to hear from you, even if the bug
  44. seems minor.
  45.  
  46. If EasyMail does crash with a fatal error, a record of the error will be
  47. created in a file called, 'ErrorLog'.  Which is created inside EasyMail's
  48. resources directory (<Shft> double-click on the !EasyMail IconSprite).  Please
  49. send this information to the author.
  50.  
  51. Things Needed:
  52. =============
  53. RISCOS 3.1 or later.
  54. Hard Disc Drive
  55. !TCPIP 2.01 or later (for internet access).
  56.    This is the PD version also called KA9Q
  57.  
  58.                  --------------------------------------------------
  59.  
  60. Introduction:
  61. ============
  62. EasyMail is an Off-Line Mail Reader (OLR) for RISCOS.  It was written using
  63. S-Base, and is therefore essentially a database application.
  64. Currently, EasyMail supports ArcBBS mail packets, UseNet news packets, Internet
  65. E-mail packets, Internet/UseNet access via CIX.
  66.  
  67. Features:
  68. ========
  69.   * Multiple ArcBBS support.
  70.   * Multiple users with optional password security.
  71.   * All messages are stored on a database providing 
  72.   * All messages are stored in a compressed format.
  73.   * No limit to the number of stored messages (except disc space).
  74.   * Mail safety feature to protect messages from one BBS being imported onto
  75.     the database of another BBS.
  76.   * Easy searching and browsing of stored messages.
  77.   * Integral text editor for easy composing of public or private messages.
  78.   * Composed messages are stored on a database in a compressed format.
  79.   * Easy browsing of composed messages.
  80.   * Exporting of messages is a variety of formats:
  81.     - ArcBBS
  82.     - UseNet
  83.     - Internet
  84.     - UseNet/Internet via CIX
  85.   * Database search facilities:
  86.     - messages to/from/both for each BBS user (BBS specific)
  87.     - messages posted by a user (UseNet/Internet)
  88.     - message subjects
  89.     - message text
  90.   * Message tagging.
  91.     - Locking.
  92.     - Read marked.
  93.     - User defined.
  94.   * Thread following.
  95.   * Multi-tasking or mono-tasking importing.
  96.   * Subject listing.
  97.   * Auto-Read feature.
  98.   * Multiple Signatures.
  99.   * Database maintenance.
  100.  
  101.                  --------------------------------------------------
  102.  
  103. Contents
  104. ========
  105.  
  106.    I.   Setting Up EasyMail:
  107.         ===================
  108.         1A.  Getting Started:
  109.         2A.  The Configure Window:
  110.         3A.  User Management:
  111.              1B.  Creating A New User:
  112.              2B.  Editing A User:
  113.              3B.  Deleting A User:
  114.         4A.  Logging On:
  115.              1B.  Selecting A User:
  116.              2B.  The Default User:
  117.  
  118.    II.  Importing E-Mail:
  119.         ================
  120.         1A.  ArcBBS Mail Packets:
  121.              1B.  Registering A BBS:
  122.              2B.  Selecting A BBS:
  123.              3B.  The Default BBS:
  124.         2A.  Internet/UseNet Mail Packets:
  125.              1B.  Before Importing For The First Time:
  126.              2B.  Users of !TCPIP (KA9Q):
  127.              3B.  Users of CIX, or other Protocol Suites:
  128.  
  129.    III. Batches:
  130.         =======
  131.         1A.  The Batches List:
  132.              1B.  Selecting Batches To Browse:
  133.              2B.  Deleting/Undeleting Batches:
  134.              3B.  The Batches List Menus:
  135.  
  136.    IV.  Conferences/Newsgroups:
  137.         ======================
  138.         1A.  The Message Areas List:
  139.              1B.  Selecting Message Areas To Browse:
  140.              2B.  Deleting And Undeleting Message Areas:
  141.              3B.  The Message Areas List Menus:
  142.  
  143.    V.   Users Maintenance And List:
  144.         ==========================
  145.         1A.  User List:
  146.         2A.  Adding And Editing New Users:
  147.         3A.  Deleting And Undeleting Message Areas:
  148.  
  149.    VI.  Composing E-Mail And News:
  150.         =========================
  151.         1A.  Toolbar Features:
  152.         2A.  Menus:
  153.         3A.  Exporting E-Mail And News:
  154.              1B.  The Replies Browser:
  155.              2B.  Sending Replies:
  156.  
  157.    VII. Browsing:
  158.         ========
  159.         1A.  Subject List:
  160.              1B.  Auto-Read:
  161.  
  162.    VIII. Signatures:
  163.          ==========
  164.          1A.  Editing Signatures:
  165.          2A.  Using A Signature:
  166.  
  167.    IX.  Tags:
  168.         ====
  169.         1A.  Defining A Tag:
  170.         2A.  Tagging A Message:
  171.         3A.  Searching For Tagged Messages:
  172.  
  173.    X.   Searching:
  174.         =========
  175.         1A.  The Search Window:
  176.              1B.  Message Text Search:
  177.              2B.  Subjects Search:
  178.  
  179.    XI.  Threads:
  180.         =======
  181.         1A.  Syntax:
  182.         2A.  Traversing Threads:
  183.  
  184.    XII. Questions & Answers, How Do I Do...?
  185.         ====================================
  186.  
  187.  
  188. I.  Setting Up EasyMail
  189.     ===================
  190.     
  191.     1A.  Getting Started:
  192.          ===============
  193.          Copy the program to a directory on your hard disc.  To start the
  194.          program, double-click on the EasyMail icon and EasyMail will install
  195.          itself on the icon bar.  The first time EasyMail is run, there will be
  196.          a few moments delay while EasyMail initialises itself.
  197.  
  198.     2A.  The Configure Window:
  199.          ====================
  200.          Click Menu over the Icon Bar and from the menu select the 'Configure'
  201.          option.  This opens the 'Configure' window.
  202.          
  203.          1B.  Organization:  (internet only)
  204.               ============
  205.               Whatever you place in this field will appear in the
  206.               'Organization:' header field of all generated UseNet messages.
  207.  
  208.          2B.  Host Address:  (internet only)
  209.               ============
  210.               This is used when you have direct access to the internet through,
  211.               for instance, a dial up account with Demon Internet.  If you have
  212.               Internet access of this type then this field should contain the
  213.               host address (the name used to refer to your computer).  For
  214.               example, name used refer to my computer is: mlveary.demon.co.uk
  215.  
  216.               If you are using !TCPIP (KA9Q) and this has been 'seen' by the
  217.               Filer, EasyMail will fill in this field for you.
  218.  
  219.               If you have access to the Internet via CIX, then this field will
  220.               contain something like: cix.compulink.co.uk
  221.               
  222.          3B.  News Quoter:  (internet only)
  223.               ===========
  224.               This is a phrase which is placed directly before a quote made in
  225.               a UseNet news article.  There are some special character
  226.               sequences which are interpreted when a quote is made:
  227.               1C.  %i is replaced by the Message-ID.
  228.               2C.  %u is replaced by the user's real name, if known.
  229.  
  230.          4B.  Mail Quoter:  (internet only)
  231.               ===========
  232.               This is a phrase which is placed directly before a quote made
  233.               when composing Internet e-mail.  The special character sequences
  234.               noted above may also be used here.
  235.  
  236.          5B.  Quote Prefix:  (internet only)
  237.               ============
  238.               Sets the default quote prefix.  This is generally a chevron '>'
  239.                 
  240.          6B.  Auto-format:
  241.               ===========
  242.               Sets the default status of the quote formatter.  If set, all
  243.               quotes will be formatted (wordwrapped).  This  feature can be
  244.               temporarily set off from the toolbar attached to the text
  245.               editing window used to compose messages.
  246.                 
  247.          7B.  Default Window:
  248.               ==============
  249.               This sets which window will be opened by default when clicking
  250.               with Select or Adjust on EasyMail's Icon Bar icon.  There is an
  251.               option on the icon bar menu to temporarily change this without
  252.               opening the 'Configure' window.
  253.  
  254.     3A.  User Management:
  255.          ===============
  256.          EasyMail is designed to be a multi-user program.  It has one permanent
  257.          user called 'PostMaster', any mail for which a post box cannot be
  258.          found gets sent to the PostMaster's post box.
  259.     
  260.          The management of users is done through the 'Logon' window which is
  261.          opened from the 'Logon' option on the icon bar menu.
  262.      
  263.          1B.  Creating A New User:
  264.               ===================
  265.               To create a new user open the 'Logon' window.  Click Menu over
  266.               the window and select the 'Add' option.
  267.              
  268.               1C.  Fullname:
  269.                    ========
  270.                    Enter your real name here.
  271.               
  272.               2C.  BBS name:
  273.                    ========
  274.                    Enter the name you use on BBSs.  Generally people use only
  275.                    one user name for all the BBSs they log on to.  If you use
  276.                    a different name for different BBSs then you will need to
  277.                    set up a user for each BBS.
  278.  
  279.               3C.  Internet name:
  280.                    =============
  281.                    Again, this is for those who have direct Internet access,
  282.                    access via CIX.  Enter the local part of your IP address
  283.                    into this field.  For example, I use 'marc'.  My complete
  284.                    IP address is then: marc@mlveary.demon.co.uk
  285.  
  286.               4C.  Password:
  287.                    ========
  288.                    Enter a password to be applied to this user.  If a password
  289.                    is entered this user cannot be used without first entering
  290.                    the correct password.  Leaving this field blank allows
  291.                    unrestricted access to this user.
  292.  
  293.               5C.  Quote signature:
  294.                    ===============
  295.                    If set on, will cause the user's signature to be
  296.                    automatically quoted when the text editing window is opened.
  297.  
  298.          2B.  Editing A User:
  299.               ==============
  300.               Select the 'Edit' option from the menu attached to the 'Logon'
  301.               window and make the necessary changed.  None of the changes are
  302.               permanent until the 'Save' icon is clicked.
  303.      
  304.          3B.  Deleting A User:
  305.               ===============
  306.               Selecting this option from the menu attached to the 'Logon' window
  307.               will delete the highlighted user, plus all mail received and
  308.               created by this user.  You are given the change to abort this
  309.               action when prompted to confirm the deletion.
  310.  
  311.     4A.  Logging On:
  312.          ==========
  313.          Everytime EasyMail is used the user must identify themselves by
  314.          selecting the appropriate user name from the list in the 'Logon'
  315.          window, or by using a pre-selected default user.
  316.          
  317.         1B.  Selecting A User:
  318.              ================
  319.              Highlight the appropriate user, click the 'Select' icon.  This
  320.              causes the highlighted user to be the current user.
  321.       
  322.         2B.  The Default User: (not necessarily the PostMaster)
  323.              ================
  324.              The default user is really a 'quick start' option.  It allows you
  325.              to designate one of the users as the default user, who is used by
  326.              default when the Icon Bar icon is clicked with Adjust, thus
  327.              bypassing the logging on sequence.  This is useful for single
  328.              users who don't want the hassle of logging on.
  329.              
  330.              To designate a user as the 'default' user, highlight the
  331.              appropriate user, from the menu attached to the window select
  332.              'Default user' and the  string "{Default}" will appear next to
  333.              that user's name.
  334.  
  335.  
  336. II. Importing E-Mail
  337.     ================
  338.     All mail is imported onto the database through the main window (Browser
  339.     Window).  The 'Browser' window is opened automatically once you have
  340.     logged on, or by clicking on the Icon Bar icon.
  341.     
  342.     NOTE: the title of the 'Browser' window will tell you whether you are
  343.     using the Internet browser window, or the ArcBBS browser window.  If you
  344.     are using the ArcBBS browser window for the first time, the window title
  345.     will say, "<Unknown>".
  346.  
  347.     1A.  ArcBBS Mail Packets:
  348.          ===================
  349.          To import an ArcBBS mail packet, simply decompress the file, and
  350.          drop it onto the 'Browser' window.  RAM transfer is supported, so
  351.          the necessity of decompressing the file before hand is not always
  352.          required.
  353.          
  354.          NOTE: when EasyMail imports the first mail packet for a BBS, the
  355.          BBS Conference Areas specified in the file to be imported are created.
  356.          If you subsequenty try to import to this BBS a mail packet whose
  357.          conference areas are in any way different to the ones created with
  358.          the first import, EasyMail will refuse to accept the import.
  359.          The reason for this is that it provides a certain level of security:
  360.          the mail packets from one BBS cannot be imported onto the database of
  361.          another BBS.
  362.          The drawback with this is that if you change your conference areas
  363.          on a BBS, any mail packed you download will not be accepted by
  364.          EasyMail.  You will either have to register another BBS, or delete
  365.          the old one and start again.
  366.          
  367.          Before being able to import an ArcBBS mail packet, the BBS from which
  368.          the packet was downloaded must be registered with EasyMail.
  369.          
  370.          1B.  Registering A BBS:
  371.               =================
  372.               From the menu attached to the 'Utilities' icon select the
  373.               'Maintain' option in the 'BBSs' submenu.  This opens the
  374.               'BBS List' window which list all the Bulletin Boards currently
  375.               registered with EasyMail.
  376.  
  377.               To add a BBS to the list, click the 'Add' icon, enter the label
  378.               (eg Arcade, Digital Databank, etc.) and then click the 'OK' icon.
  379.               Any number of Bulletin Boards may be registered with EasyMail.
  380.  
  381.          2B.  Selecting A BBS:
  382.               ===============
  383.               To use one of the listed Bulletin Boards, simply highlight the
  384.               required BBS and click the 'Select' icon.  The last imported
  385.               batch for this BBS (if there is one) will be loaded automatically.
  386.  
  387.          3B.  The Default BBS:
  388.               ===============
  389.               You can designate a BBS as the 'Default' BBS.  This means that
  390.               whenever the BBS browser is opened, this designated BBS is loaded
  391.               by default.
  392.  
  393.               To designate a BBS as the default simply highlight the required
  394.               BBS label, and from the menu attached to the 'BBS List' window
  395.               select the 'Default BBS' option.  You will see the string
  396.               '{Default}' appear against that BBS label.
  397.               
  398.     2A.  Internet/UseNet Mail Packets:
  399.          ============================
  400.  
  401.          1B.  Before Importing For The First Time:
  402.               ===================================
  403.               Although not entirely necessary, it will save you a lot of hassle
  404.               if you set up in EasyMail the newsgroups you read, before the
  405.               first UseNet news batch is imported.
  406.               
  407.               1C.  Setting Up Newsgroups:
  408.                    =====================
  409.                    On the 'Browser' window, click the icon with the four
  410.                    squares, this will open the 'Newsgroups' window.
  411.                    
  412.                    From the menu attached to this window, select 'Add' from
  413.                    the 'Options' submenu.  Type a newsgroup into the dialogue,
  414.                    and click 'OK' to create the newsgroup.  Repeat this for
  415.                    all the newsgroups you read.
  416.                    
  417.                    1D.  Suggested List:
  418.                         ==============
  419.                         comp.sys.acorn
  420.                         comp.sys.acorn.tech
  421.                         comp.sys.acorn.announce
  422.                         comp.binaries.acorn
  423.                         comp.sources.acorn
  424.                         demon.announce
  425.                         demon.answers
  426.                         demon.ip.support.archimedes
  427.  
  428.          2B.  Users of !TCPIP (KA9Q):
  429.               ======================
  430.               EasyMail will collect and debatch mail downloaded using !TCPIP,
  431.               Version 2.01 or later.  The Filer must have 'seen' the
  432.               !TCPIPUser pseudo application, for EasyMail to be able to import
  433.               an Internet or UseNet mail packet.
  434.               
  435.               1C.  Collecting E-Mail:
  436.                    =================
  437.                    Assuming that the Internet 'Browser' window is open, from
  438.                    the menu attached to the 'Utilities' icon select the
  439.                    'Collect mail' option.  This will import all UseNet news
  440.                    and any Internet E-Mail downloaded by !TCPIP.
  441.                    
  442.                    Once the import is complete, you will be asked if you wish
  443.                    to delete the News File and Mail File.
  444.  
  445.          3B.  Users of CIX, or other Protocol Suites:
  446.               ======================================
  447.               For UseNet news, each article must be separated by the #! rnews
  448.               separator as according to RFC 822 or the mail packet will not be
  449.               imported.
  450.               For Internet E-Mail, EasyMail does not mind what separator is
  451.               used between batched mail items as it works this out for itself
  452.               before the mail packet is imported.
  453.               
  454.               To import either UseNet news or Internet e-mail simply drop the
  455.               file onto the 'Browser' window.
  456.  
  457.  
  458. III. Batches
  459.      =======
  460.      Each mail packet imported into EasyMail is called a 'Batch'.  EasyMail
  461.      maintains a list of batches for each BBS, and for Internet/UseNet.  The
  462.      available batches are listed in the 'Batches' window.
  463.           
  464.      1A.  The Batches List:
  465.           ================
  466.           Click the 'Blue Box' icon.  This window lists all the batches which
  467.           have been imported onto the currently selected database.  The last
  468.           batch is always the batch which is loaded into the 'Browser' window
  469.           when it is opened.
  470.  
  471.           1B.  Selecting Batches To Browse:
  472.                ===========================
  473.                You may browse the messages in any number of batches.  Simply
  474.                highlight the required batches in the list and click the
  475.                'Select' icon.  This loads the 'Browser' window with all the
  476.                messages in the selected batches.
  477.  
  478.                Clicking the 'Select' icon with the 'Select' button performs the
  479.                search and closes the window, while clicking with the 'Adjust'
  480.                button performs the search but leave the window open.
  481.  
  482.           2B.  Deleting/Undeleting Batches:
  483.                ===========================
  484.                
  485.                1C.  Deleting:
  486.                     ========
  487.                     After a while, you will begin to accummulate a large number
  488.                     of batches and the database may be come rather large, which
  489.                     will have a bearing upon the speed of EasyMail.
  490.                
  491.                     To delete a batch (and all associated messages) highlight
  492.                     the required batches the select 'Delete' from the 'Options'
  493.                     submenu of the 'Batches' menu.
  494.  
  495.                     This does not automatically remove the batch and messages
  496.                     from the database, this is only done when a 'Rebuild' is
  497.                     performed on the database.  See the section on Maintenance.
  498.  
  499.                2C.  Undeleting:
  500.                     ==========
  501.                     Batches may be undeleted if required.  Simply select the
  502.                     'Show deleted' option from the 'Batches' menu and then
  503.                     highlight the batches required to be undeleted.  Follow
  504.                     the operations for deleting except select the 'Undelete'
  505.                     option from the submenu.               
  506.                
  507.           3B.  The Batches List Menus:
  508.                ======================
  509.                
  510.                1C.  Batch Menu:
  511.                     ==========
  512.                     * Batch           - Leads to the 'Options' submenu.
  513.                     * Select All      - Highlights all listed batches.
  514.                     * Clear selection - Clears highlighted batches.
  515.                     * Show deleted    - Includes deleted batches in the list.
  516.                
  517.                2C.  Options Menu:
  518.                     ============
  519.                     * Info     - Opens a window with information on the batch,
  520.                                  such as the number of messages, and if any of
  521.                                  them are tagged.
  522.                     * Delete   - Deletes the currently highlighted batches
  523.                                  They are not deleted from the database
  524.                                  but simply 'marked' as delete and will not
  525.                                  appear in the batch list unless 'Show
  526.                                  deleted' is set (ticked).
  527.                     * Undelete - Undeletes any highlighted batches which
  528.                                  have been marked as deleted.
  529.  
  530.  
  531. IV. Conferences/Newsgroups
  532.     ======================
  533.     Each message on the database is categorized into an message area.  For
  534.     ArcBBS these area called Conferences, on UseNet they are called Newsgroups.
  535.     The purpose of these message areas is to reduce the number of messages
  536.     a user must go through to find what they want to read.  For example, an
  537.     'S-Base User Group' area on a BBS should only contain messages relating to
  538.     S-Base and the User Group.  The UseNet newsgroup 'demon.test' is
  539.     specifically for test messages.
  540.     
  541.     EasyMail not only allows one or more batches to be browsed, but also allows
  542.     you to browse the messages in one or more message areas.  This is done in
  543.     much the same way as you would select a batch or group of batches.
  544.     
  545.     1A.  The Message Areas List:
  546.          ======================
  547.          Click the icon with 'Four Squares' open the message areas list.  When
  548.          using an ArcBBS database, the title of this window will say 'Areas'.
  549.          When using the Interent/UseNet database, the title of this window will
  550.          say 'Newsgroups'.
  551.          
  552.          1B.  Selecting Message Areas To Browse:
  553.               =================================
  554.               You may browse the messages in any number of message areas.
  555.               Simply highlight the required message areas and click the
  556.               'Select' icon.  This loads the 'Browser' window with all the
  557.               messages posted to the selected areas within the currently
  558.               selected batches.
  559.  
  560.          2B.  Deleting And Undeleting Message Areas:
  561.               =====================================
  562.               As with batches, message areas can be deleted and undeleted.
  563.               The rules for batches also apply to message areas.
  564.  
  565.          3B.  The Message Areas List Menus:
  566.               ============================
  567.               
  568.               1C.  Area/Newsgroups:
  569.                    ===============
  570.                    * Options         - Leads to the 'Options' submenu.
  571.                    * Select All      - Highlights all listed message areas.
  572.                    * Clear selection - Clears highlighted message areas.
  573.                    * Show deleted    - Includes deleted message areas in the
  574.                                        list.
  575.  
  576.               2C.  Options Menu:
  577.                    ============
  578.                    * Add      - This allows you to add new conferences/news-
  579.                                 groups to the currently active list.
  580.                    * Edit     - This allows you to edit an conference/newgroup.
  581.                    * Delete   - Deletes the currently highlighted message
  582.                                 areas.  They are not deleted from the database
  583.                                 but simply 'marked' as delete and will not
  584.                                 appear in the message areas list unless 'Show
  585.                                 deleted' is set (ticked).
  586.                    * Undelete - Undeletes any highlighted message areas which
  587.                                 have been marked as deleted.
  588.  
  589.               NOTE: Active areas/newsgroups are automatically included in the
  590.               'Area' or 'Newsgroups' menu attached to the text editing
  591.               window.  See later for further details.
  592.  
  593.  
  594. V.  Users Maintenance And List
  595.     ==========================
  596.     EasyMail maintains a list of users for the internet for a BBS.  When it
  597.     'sees' a new user (as a mail packet is being imported), appropriate
  598.     details are captured and a database record created.  All known users can
  599.     be browser through the 'User List' window.  This is accessed through the
  600.     'Maintain' option of the menu attached to the 'Person' icon in the
  601.     'Browser' window.
  602.  
  603.     1A.  User List:
  604.          =========
  605.          The basic purpose of this window is to manage which users are to be
  606.          included in any 'User List' menus.  Only users records which are not
  607.          marked as deleted with be included in any menus and these users
  608.          records will be displayed by default in the window.
  609.          
  610.          All user records created while importing a mail packet are
  611.          automatically marked as deleted.  This means that even when a mail
  612.          packet has been imported the 'User List' window will not contain any
  613.          new users.
  614.  
  615.     2A.  Adding And Editing New Users:
  616.          ============================
  617.          Adding and editing user records can be done by click the appropriate
  618.          icon, and filling in the required details.
  619.  
  620.          For ArcBBS users, their user number should be supplied.  But if this
  621.          is not supplied (left as zero) then 
  622.  
  623.     3A.  Deleting And Undeleting Message Areas:
  624.          =====================================
  625.          As with batches and message areas, users can be deleted and undeleted.
  626.          The rules for batches also apply to users.
  627.  
  628.  
  629. VI. Composing E-Mail And News
  630.     =========================
  631.     Clicking the 'Green Pen' icon will open the text editing window.  Through
  632.     this window public and private e-mail can be created.
  633.     
  634.     1A.  Toolbar Features:
  635.          ================
  636.          * Original/Reply - Sets whether the composition is new or a reply to
  637.                             the current message in the browser window.
  638.          * Private/Public - Sets whether the composition is private e-mail or
  639.                             a public news article.
  640.          * Quote          - Quotes any text highlighted in the browser window.
  641.          * Format         - Sets whether the quoted text is word-wrapped or not.
  642.          * Signature      - Appends the selected signature to the bottom of the
  643.                             message.
  644.          * Sig 1/Sig 2    - Sets which signature is used when the 'Signature'
  645.                             icon is clicked.
  646.          * Headers/text   - (Internet Only)  Shows the headers or the text of
  647.                             the composition.
  648.  
  649.     2A.  Menus:
  650.          =====
  651.          If a field is 'dark grey', this indicates that a menu is attached
  652.          to the field from which an option may be selected.  You may also
  653.          notice that the mouse pointer changes to indicate the presence of a
  654.          menu.
  655.          
  656.          What is listed in a menu attached to any of the 'dark grey' fields
  657.          is controlled by what is deleted/undeleted in the user and message
  658.          area windows.  All non-deleted users, UseNet newsgroups and ArcBBS
  659.          conference areas are automatically included in their associated
  660.          menus.
  661.          
  662.          There is a menu attached to the mail message fields for exporting
  663.          the text of the message as a TextFile.
  664.          
  665.     3A.  Exporting E-Mail And News:
  666.          =========================
  667.          E-mail which has been created is also stored on a database and can
  668.          be browsed, and to some degree edited.
  669.  
  670.          1B.  The Replies Browser:
  671.               ===================
  672.               The 'Replies Browser' is opened from the 'Browse replies' option
  673.               of the menu attached to the 'Utilities' icon.
  674.               
  675.               From this window, replies can be browsed, edited, deleted, or
  676.               marked as sent or not-sent.
  677.               
  678.               1C.  Deleting A Reply:
  679.                    ================
  680.                    To delete a reply simply click the 'Dustbin' icon and the
  681.                    current reply is marked as deleted.  You can view all the
  682.                    deleted replies by selecting the 'Include deleted' icon.
  683.                    
  684.               The status of a reply (whether it is sent or not) can be altered
  685.               via the menu attached to the 'Menu icon' to the right of the
  686.               'Sent' field.
  687.               
  688.               The text of the reply can also be exported as a TextFile, via
  689.               the main menu attached to the window.
  690.  
  691.          2B.  Sending Replies:
  692.               ===============
  693.               To export (save out) all the replies which are marked as 'not
  694.               sent', select the 'Send replies' option from the menu attached
  695.               to the 'Utilities' icon.
  696.               
  697.               1C.  ArcBBS:
  698.                    ======
  699.                    Selecting 'Send replies' pops up a standard 'save as'
  700.                    dialogue.  Drag the TextFile IconSprite to a Filer window,
  701.                    and the replies will be exported in a format suitable to be
  702.                    uploaded onto an ArcBBS.
  703.                    
  704.                    The path to which you dragged the IconSprite is automatically
  705.                    saved and used from then on by clicking the 'OK' icon in the
  706.                    'save as' dialogue.
  707.  
  708.               2C.  !TCPIP (KA9Q):
  709.                    =============
  710.                    If you use !TCPIP (KA9Q), then simply select the icon
  711.                    marked '!TCPIPUser' and click the 'Export' icon.  All e-mail
  712.                    /news waiting to be sent will be exported ready to be
  713.                    sent using the correct protocols.
  714.  
  715.               3C.  CIX:
  716.                    ===
  717.                    If you use CIX, then simply select the icon marked 'CIX'
  718.                    and drag the directory in which you wish the mail/news to
  719.                    be created, and click 'Export'.
  720.  
  721.                    The 'CIX' option creates two directories: 'Mail' and 'News'
  722.                    in the directory you specified in the field.  In these
  723.                    directories any news or e-mail is created, ready to be
  724.                    uploaded to your scratchpad.
  725.  
  726.               4C.  TextFile:
  727.                    ========
  728.                    This option saves out the messages batched into separate
  729.                    files, one for e-mail and one for news.
  730.                    
  731.  
  732. VII. Browsing:
  733.      ========
  734.      The last imported batch (if there is one) will be the one displayed in
  735.      the browser window.  In the ArcBBS browser window, the messages are
  736.      ordered according to conference number, subject, and date.  For Internet/
  737.      UseNet the messages are ordered according to subject and time.
  738.      
  739.      1A.  Subject List:
  740.           ============
  741.           Clicking the 'Dark Grey Text' icon (to the right of the 'Green Pen'
  742.           icon) opens the 'Subject List' window.  This window lists the subject
  743.           and it's author of each message in the currently selected batches.
  744.  
  745.           Clicking on a message in the 'Subject List' window causes that
  746.           record to be displayed in the 'Browser' window for viewing.  The
  747.           highlighted record is the one currently displayed in the 'Browser'
  748.           window.
  749.           
  750.           1B.  Auto-Read:
  751.                =========
  752.                This feature automatically selects for browsing the first
  753.                conference/newsgroup, within the currently selected group of
  754.                batches, which contain messages.  When you try to go past the
  755.                last message in that message area, the next message area which
  756.                contains messages is then selected.  You can move backwards and
  757.                forwards through the message areas via the '<<Prev' and 'Next>>'
  758.                icons.
  759.           
  760.                This feature is useful for quickly finding which message areas
  761.                have messages posted to them and listing all those messages for
  762.                browsing.
  763.           
  764.                If the 'Subject List' window is close this feature is switched
  765.                off.
  766.  
  767. VIII. Signatures:
  768.       ==========
  769.       EasyMail can also store two predefined signatures.  To open the
  770.       'Signature' window select 'Signatures' from the menu attached to the
  771.       'Utilities' icon.
  772.       
  773.       1A.  Editing Signatures:
  774.            ==================
  775.            Select which signature you wish to edit (standard or alternate)
  776.            and then create the signature.  The signature can also be created in
  777.            a text editor and imported by dragging the file onto the window.
  778.            
  779.            Once created, click the 'Save' icon and your signature will be saved.
  780.  
  781.       2A.  Using A Signature:
  782.            =================
  783.            A signature can be selected from the toolbar attached to the text-
  784.            editing window.  The 'standard' signature is selected when the
  785.            'Sig 1' icon is selected.  The 'alternate' signature is selected
  786.            when the 'Sig 2' icon is selected.  When neither of these are
  787.            selected no signature is in use.
  788.            
  789.            To append a signature click the 'Signature' icon on the text-
  790.            editing toolbar.  The selected signature will then be appended to
  791.            the end of the current text.
  792.            
  793.            If you wish the selected signature to be quoted everytime the 
  794.            text-editing window is opened then this option should be set via the
  795.            window used to add/edit a site user.  (See section I.3A.5C.)
  796.  
  797. IX.  Tags:
  798.      ====
  799.      EasyMail allows you to tag messages with tags you have defined yourself.
  800.      If for instance you wanted to tag all messages to do with a certain
  801.      aspect of the RISC PC, you could define a tag called 'RPC Info' and
  802.      then tag the relevant messages to be retrieved at a later date.
  803.      
  804.      1A.  Defining A Tag:
  805.           ==============
  806.           Select 'Maintain...' from the menu attached to the 'Tag' icon.  This
  807.           opens the 'Tags' window.  To add a tag, click the 'Add' icon, type
  808.           in the label of the tag and click the 'Save' icon.
  809.           
  810.      2A.  Tagging A Message:
  811.           =================
  812.           To tag a message, select the required tag from the menu attached to
  813.           the 'Tag' icon and the current message will be tagged with this tag.
  814.           If the message is tagged with the selected tag, then the message is
  815.           untagged.
  816.           
  817.           To check the tagging of a message, click the 'Graph' icon.  The
  818.           far right field of this information bar will display the label of
  819.           any tag applied to the current message.
  820.  
  821.           *NOTE* the '<Locked>' tag is supposed to 'lock' a message ensuring
  822.           it cannot be deleted.  However, at the present time this feature
  823.           has not yet been implemented.
  824.  
  825.      3A.  Searching For Tagged Messages:
  826.           =============================
  827.           To find all the messages tagged with a certain tag, select the
  828.           required tag from the submenu attached to the 'Select tags' option
  829.           of the menu attached to the 'Utilities' icon.
  830.           
  831.           When a tag is selected, a search is conducted of the database for
  832.           that tag, and all the message are then grouped together for browsing.
  833.           Note that a tag search only operates on messages to do with the
  834.           current BBS or Internet area.
  835.  
  836. X.   Searching:
  837.      =========
  838.      EasyMail can perform a fast search on the actual text of a message or
  839.      on the subject of a message.  The whole database is searched for 
  840.      
  841.      1A.  The Search Window:
  842.           =================
  843.           Click on the 'Magnifying Glass' icon to open the 'Search' window.
  844.           
  845.           1B.  Message Text Search:
  846.                ===================
  847.                This searches the main body of the message.  Select the 'Msg
  848.                Text' icon, and type into the associated field the text you wish
  849.                to search the database for.
  850.                
  851.           2B.  Subject Search:
  852.                ==============
  853.                This searches the 'subject' field of each message.  Select the
  854.                'Subject' icon, and type into the associated field the text you
  855.                wish to search the database for.
  856.  
  857.           When the two fields are used together is a search the relationship
  858.           between the two fields is 'OR'  In other words, "find <msg_text> or
  859.           <subject>"  In future versions of EasyMail the search facilities will
  860.           be enhanced.
  861.  
  862. XI.  Threads:
  863.      =======
  864.      Often a message is posted in response to a message from someone else.
  865.      The threads feature lets you look backward or forward through messages
  866.      which are related to each other.
  867.  
  868.      1A.  The Threads Window:
  869.           ==================
  870.           To open the 'Threads' window click on the red/green/blue connected
  871.           'Boxes' icon.  If there are any message which relate to this message
  872.           contained in the currently selected batch(s) of messages, then
  873.           these will be displayed in this window.
  874.           
  875.           1B.  Syntax:
  876.                ======
  877.                * "Parent: <sender's name>  <(subject)>" - this is the 'parent'
  878.                  message for the current message (i.e. the current message is
  879.                  a reply to the message denoted as 'Parent:').
  880.  
  881.                * "Reply:  <sender's name>  <(subject)>" - indicates any further
  882.                  messages which are replies to the current message.  (i.e.
  883.                  messages which have been posted in responce to the current
  884.                  message).
  885.  
  886.           2B.  Traversing Threads:
  887.                ==================
  888.                Clicking on one of the indicated related messages will load that
  889.                message for browsing if it is contained in the database and also
  890.                within the currently selected batches.
  891.  
  892.  
  893. XII.  Questions & Answers, How Do I Do...?
  894.       ====================================
  895.  
  896.       1A.  Questions & Answers:
  897.            ===================
  898.  
  899.            1B.  Can I run two copies of EasyMail?
  900.       
  901.                 Yes, but only if they are separate copies.  You cannot run the
  902.                 same copy twice.
  903.  
  904.            2B.  Is there any way to by-pass the 'Login' window?
  905.       
  906.                 Yes, if you select a user as the 'Default User' via the menu
  907.                 attached to the 'Login' window, then when you start a session
  908.                 with EasyMail click with the ADJUST mouse button on the
  909.                 EasyMail icon rather.  This by-passes the 'Login' window.
  910.  
  911.            3B.  EasyMail keeps producing 'Assertion Failure' errors, and then
  912.                 quits!  What can I do?
  913.                 
  914.                 Not a lot.  This means that the database has somehow become
  915.                 corrupt.  Generally, the only way to solve this problem is to
  916.                 delete the 'data' directory inside EasyMail's resources
  917.                 directory and start again.  In future versions of EasyMail
  918.                 if these kind of errors occur, EasyMail will try to fix the
  919.                 problem.  However, the current version does not do this.
  920.  
  921.                 *NOTE*  If an assertion failure error occurs having just
  922.                 rebuild the database, please contact the author, and keep your
  923.                 database.
  924.  
  925.            4B.  EasyMail will not accept my lastest AcrBBS scratchpad, it just
  926.                 gives me the message  "The areas recorded in this scratchpad do
  927.                 not match the current areas known for this BBS!?"
  928.            
  929.                 One of two things may be the problem.  Either you are trying to
  930.                 import the wrong scratchpad to the wrong BBS, or the conference
  931.                 areas recorded in the scratchpad are different from those
  932.                 defined for this BBS (ie you have joined or resigned from 1 or
  933.                 more conferences)
  934.                 
  935.                 Using a text editor, load the scratchpad and search for the
  936.                 string '::: Area'.  Then check the areas defined in the scratch-
  937.                 pad with those of the BBS, add or delete conference areas until
  938.                 they match.
  939.                 
  940.                 *NOTE* the labels of conference areas must be *exactly* as is
  941.                 described in the scratchpad, or the scratchpad will not be
  942.                 loaded.
  943.  
  944.            5B.  EasyMail produced a 'Fatal Error'.  What do I do?
  945.  
  946.                 Fatal errors are produced in response to bugs in the programming
  947.                 of EasyMail, or S-Base.  Please return to the author, the
  948.                 TextFile called 'ErrorLog' which is in EasyMail's resources
  949.                 directory.
  950.  
  951.            6B.  I want to send my e-mail to !TCPIPUser, but the appropriate
  952.                 icon on the 'Export' window is faded?
  953.                 
  954.                 This means that the 'Filer' has not 'seen' !TCPIPUser, and
  955.                 thus EasyMail will not be able to send your mail and/or news
  956.                 articles to it.  Find !TCPIPUser, and open the directory
  957.                 containing it.
  958.  
  959.            
  960.       2A.  How Do I Do...?
  961.            ===============
  962.  
  963.             1B.  How do I delete unwanted messages?
  964.       
  965.                  * Select (highlight) the batches which contain the unwanted
  966.                    messages.
  967.                  * From the menu attached to the 'Batch' window select delete.
  968.                  * From the menu attached to the 'Utilities' icon, select the
  969.                    'Rebuild' option.
  970.              
  971.             *NOTE* The rebuild option deletes records on the database which are
  972.                    marked for deletion!  This includes users, replies and
  973.                    batches, and then conpacts the database to its smallest size.
  974.                   
  975.                    It is generally a good idea to delete all batch up to the
  976.                    current batch (EasyMail will not allow you to delete the
  977.                    current batch).
  978.  
  979.                    All messages tagged with the '<Locked>' tag will not be
  980.                    deleted, not will the batch which contains this record,
  981.                    although all other records in the batch will be deleted.
  982.  
  983.             2B.  How do I completely clear the database and start again?
  984.  
  985.                  * Click the 'Tools' icon in the 'Browser' window and select
  986.                    the 'Zap database' option.  This erases the whole database.
  987.