home *** CD-ROM | disk | FTP | other *** search
/ PDA Software Library / pdasoftwarelib.iso / PSION / 1997 / 987.ZIP / TUTORIAL.TXT < prev    next >
Encoding:
Text File  |  1997-03-31  |  6.9 KB  |  136 lines
  1.   ========================================================================
  2.     (c) Martin N Dunstan  (mnd@dcs.st-andrews.ac.uk)  March 30th, 1997
  3.   ========================================================================
  4.  
  5.    This file briefly describes the use of Txt2Agn on the demo file
  6.    DEMO.TXT that accompanies the distribution. It assumes you have
  7.    installed the application as described in the previous section and copied
  8.    the DEMO.TXT file in a \TXT directory. Note that this file has a number of
  9.    faulty entries for the purposes of example.
  10.  
  11.    1) From the system screen highlight the DEMO file listed under the Txt2Agn
  12.       icon (try pressing the System button if it can't be seen). Press ENTER
  13.       to start the application.
  14.  
  15.    2) A title screen will appear followed by a window asking you to register.
  16.       Try pressing the Help key - this will normally bring up context
  17.       sensitive help at other dialogs. If you have been sent your
  18.       registration code press R otherwise press C to continue.
  19.  
  20.    3) Having pressed C an "annoying window" will appear - this will not be
  21.       present in registered versions. After a brief pause the preferences
  22.       dialog will appear. The settings here are stored ready for the next
  23.       time you use the program.
  24.  
  25.    4) Use the up and down arrow keys to move between the options and the left
  26.       and right arrow keys to cycle through the choices for each option. To
  27.       leave the program at this point press Escape. Dealing with each of the
  28.       options in turn:
  29.  
  30.       a) Errors: this controls how the program behaves when an error is found
  31.          in the input file (an illegal date).
  32.  
  33.          Ignore:   any illegal entries will be skipped.
  34.          Auto-fix: the program will try and guess what date you really meant
  35.                    when an illegal entry is found.
  36.          Ask user: Illegal entries will be displayed in a dialog box for the
  37.                    user to correct or skip over.
  38.  
  39.          I will assume "Ask user" is selected.
  40.  
  41.       b) Dates: choose the date format used in the input file. This may be
  42.          either dd/mm/yy or mm/dd/yy.
  43.  
  44.       c) Logfile: if set to "On" then any errors will be written to the
  45.          logfile specified on the next two lines.
  46.  
  47.    5) Press M to get more options and another dialog box will appear. The two
  48.       choices are:
  49.  
  50.       a) Partial dates: assuming we are using the dd/mm/yy date format then a
  51.          partial date is one which has the year or even the month missing. If
  52.          partial dates are allowed then the program uses the current year and
  53.          month to fill in the missing information. Thus if today is January
  54.          22nd, 1997 then 25/4 stands for April 25th 1997 and 28 stands for
  55.          January 28th 1997. If partial dates are not allowed then they are
  56.          considered to be an error and the program will act accordingly
  57.          (ignore them, fix them or ask the user).
  58.  
  59.       b) Logfile: use this setting to control what happens if logging is
  60.          turned on and the logfile already exists. If "always overwrite" is
  61.          selected then the logfile will be deleted without asking or telling
  62.          the user.
  63.  
  64.       Press Enter when you've set things up the way you want and you will be
  65.       returned to the previous dialog. Press Enter to move on to the next
  66.       dialog. If the logfile already exists and you haven't chosen the
  67.       "always overwrite" mode you will be asked if you want to overwrite it.
  68.       Pressing N will return you to the preferences dialog so that you can
  69.       you can choose another filename.
  70.  
  71.    6) At this dialog you are requested to provide the name of the Agenda file
  72.       you want to create. The program will supply a default name based on the
  73.       name of the input file. Thus converting DEMO.TXT will mean DEMO.AGN is
  74.       the default Agenda filename. Either type in a new name or press TAB and
  75.       use the Psion file selector to overwrite an existing file. Press Escape
  76.       to quit the program.
  77.  
  78.    7) Press ENTER when you have selected a file - if it already exists you
  79.       will be asked if you wish to overwrite it. Pressing N will return you
  80.       to the file selection dialog; Escape will quit the program.
  81.  
  82.    8) A progress indicator (sliderbar) will appear on the screen with the
  83.       title "Creating Agenda file". There will be an initial pause of about 7
  84.       seconds while the indicator is 1/3 filled and then it will quickly
  85.       reach the filled state. Pressing Escape will pause the program and you
  86.       will be asked if you want to quit. Pressing N will allow the conversion
  87.       to continue while Y will stop the program. Note that the program will
  88.       be slow to react to the key press so you should press Escape firmly
  89.       once and then wait for a second or two.
  90.  
  91.    9) The first indicator will be replaced by a second which shows how much
  92.       of the input file has been processed. I you are converting the demo
  93.       file with error mode set to "Ask user" then about 3/4 of the way
  94.       through the input file a dialog box will appear asking you to fix the
  95.       mistake.
  96.  
  97.       Press Escape to skip the entry otherwise correct it by using the arrow
  98.       keys to select the faulty date and typing the correct one in it's
  99.       place. Part of the line that was causing the problem is shown for
  100.       reference at the top of the window. Press Enter when you are satisfied
  101.       with the entry.
  102.  
  103.   10) Another faulty entry will appear (assuming "ask user" mode which should
  104.       be dealt with as before.
  105.  
  106.   11) Once the whole file has been processed the program checks to see if any
  107.       errors were noted in the logfile (i.e. error logging was on and at
  108.       least one error occurred). If so a window will appear informing the
  109.       user of this.
  110.  
  111.   12) Finally, if the program is unregistered you will be given the
  112.       opportunity to do so!
  113.  
  114.   13) If errors were found you should check the logfile for details. This
  115.       file is plain text and can be examined using the Word application or
  116.       any other text reader.
  117.  
  118.  
  119. Hints:
  120.    * Make sure the program always has logging turned on if you are converting
  121.      files in "ignore" or "auto-fix" mode and check the logfile afterwards to
  122.      see what happened if any errors occurred.
  123.  
  124.    * Run in "ask user" mode - usually there would be no errors and thus no
  125.      need for user intervention. If any errors do appear then it is probably
  126.      quicker to fix them during conversion rather than do it later in Agenda.
  127.  
  128.    * If you already have a \TXT directory which you use to keep other text
  129.      files in try using the "Create new list" option from the "Special" menu
  130.      on the system screen. Refer to the Psion User Guide for details.
  131.  
  132.   ========================================================================
  133.     (c) Martin N Dunstan  (mnd@dcs.st-andrews.ac.uk)  March 30th, 1997
  134.   ========================================================================
  135.  
  136.