  ========================================================================
    (c) Martin N Dunstan  (mnd@dcs.st-andrews.ac.uk)  March 30th, 1997
  ========================================================================

   This file briefly describes the use of Txt2Agn on the demo file
   DEMO.TXT that accompanies the distribution. It assumes you have
   installed the application as described in the previous section and copied
   the DEMO.TXT file in a \TXT directory. Note that this file has a number of
   faulty entries for the purposes of example.

   1) From the system screen highlight the DEMO file listed under the Txt2Agn
      icon (try pressing the System button if it can't be seen). Press ENTER
      to start the application.

   2) A title screen will appear followed by a window asking you to register.
      Try pressing the Help key - this will normally bring up context
      sensitive help at other dialogs. If you have been sent your
      registration code press R otherwise press C to continue.

   3) Having pressed C an "annoying window" will appear - this will not be
      present in registered versions. After a brief pause the preferences
      dialog will appear. The settings here are stored ready for the next
      time you use the program.

   4) Use the up and down arrow keys to move between the options and the left
      and right arrow keys to cycle through the choices for each option. To
      leave the program at this point press Escape. Dealing with each of the
      options in turn:

      a) Errors: this controls how the program behaves when an error is found
         in the input file (an illegal date).

         Ignore:   any illegal entries will be skipped.
         Auto-fix: the program will try and guess what date you really meant
                   when an illegal entry is found.
         Ask user: Illegal entries will be displayed in a dialog box for the
                   user to correct or skip over.

         I will assume "Ask user" is selected.

      b) Dates: choose the date format used in the input file. This may be
         either dd/mm/yy or mm/dd/yy.

      c) Logfile: if set to "On" then any errors will be written to the
         logfile specified on the next two lines.

   5) Press M to get more options and another dialog box will appear. The two
      choices are:

      a) Partial dates: assuming we are using the dd/mm/yy date format then a
         partial date is one which has the year or even the month missing. If
         partial dates are allowed then the program uses the current year and
         month to fill in the missing information. Thus if today is January
         22nd, 1997 then 25/4 stands for April 25th 1997 and 28 stands for
         January 28th 1997. If partial dates are not allowed then they are
         considered to be an error and the program will act accordingly
         (ignore them, fix them or ask the user).

      b) Logfile: use this setting to control what happens if logging is
         turned on and the logfile already exists. If "always overwrite" is
         selected then the logfile will be deleted without asking or telling
         the user.

      Press Enter when you've set things up the way you want and you will be
      returned to the previous dialog. Press Enter to move on to the next
      dialog. If the logfile already exists and you haven't chosen the
      "always overwrite" mode you will be asked if you want to overwrite it.
      Pressing N will return you to the preferences dialog so that you can
      you can choose another filename.

   6) At this dialog you are requested to provide the name of the Agenda file
      you want to create. The program will supply a default name based on the
      name of the input file. Thus converting DEMO.TXT will mean DEMO.AGN is
      the default Agenda filename. Either type in a new name or press TAB and
      use the Psion file selector to overwrite an existing file. Press Escape
      to quit the program.

   7) Press ENTER when you have selected a file - if it already exists you
      will be asked if you wish to overwrite it. Pressing N will return you
      to the file selection dialog; Escape will quit the program.

   8) A progress indicator (sliderbar) will appear on the screen with the
      title "Creating Agenda file". There will be an initial pause of about 7
      seconds while the indicator is 1/3 filled and then it will quickly
      reach the filled state. Pressing Escape will pause the program and you
      will be asked if you want to quit. Pressing N will allow the conversion
      to continue while Y will stop the program. Note that the program will
      be slow to react to the key press so you should press Escape firmly
      once and then wait for a second or two.

   9) The first indicator will be replaced by a second which shows how much
      of the input file has been processed. I you are converting the demo
      file with error mode set to "Ask user" then about 3/4 of the way
      through the input file a dialog box will appear asking you to fix the
      mistake.

      Press Escape to skip the entry otherwise correct it by using the arrow
      keys to select the faulty date and typing the correct one in it's
      place. Part of the line that was causing the problem is shown for
      reference at the top of the window. Press Enter when you are satisfied
      with the entry.

  10) Another faulty entry will appear (assuming "ask user" mode which should
      be dealt with as before.

  11) Once the whole file has been processed the program checks to see if any
      errors were noted in the logfile (i.e. error logging was on and at
      least one error occurred). If so a window will appear informing the
      user of this.

  12) Finally, if the program is unregistered you will be given the
      opportunity to do so!

  13) If errors were found you should check the logfile for details. This
      file is plain text and can be examined using the Word application or
      any other text reader.


Hints:
   * Make sure the program always has logging turned on if you are converting
     files in "ignore" or "auto-fix" mode and check the logfile afterwards to
     see what happened if any errors occurred.

   * Run in "ask user" mode - usually there would be no errors and thus no
     need for user intervention. If any errors do appear then it is probably
     quicker to fix them during conversion rather than do it later in Agenda.

   * If you already have a \TXT directory which you use to keep other text
     files in try using the "Create new list" option from the "Special" menu
     on the system screen. Refer to the Psion User Guide for details.

  ========================================================================
    (c) Martin N Dunstan  (mnd@dcs.st-andrews.ac.uk)  March 30th, 1997
  ========================================================================

