home *** CD-ROM | disk | FTP | other *** search
/ PDA Software Library / pdasoftwarelib.iso / PSION / 1997 / 987.ZIP / MANUAL.TXT < prev    next >
Encoding:
Text File  |  1997-03-31  |  6.3 KB  |  144 lines
  1.   ========================================================================
  2.     (c) Martin N Dunstan  (mnd@dcs.st-andrews.ac.uk)  March 30th, 1997
  3.   ========================================================================
  4.  
  5.  
  6.    The input file consists of either blank lines (lines which nothing or
  7.    just spaces and tabs), untimed event lines or timed event lines.
  8.  
  9.  
  10. Untimed Events:
  11.    An untimed event line is the simplest - it consists of the date of the
  12.    event followed by white space (one or more spaces and/or tabs) and then
  13.    the description of the event. An example using dd/mm/yyyy format is:
  14.  
  15.       25/12/1997 Christmas day in 1997!
  16.  
  17.    To make the program more useful the year can be abbreviated:
  18.  
  19.       25/12/07 Christmas day in 2007!
  20.  
  21.    and even left off:
  22.  
  23.       25/12 Christmas day this year.
  24.  
  25.    If the year is abbreviated to two digits then years 70-99 correspond to
  26.    the years 1970 to 1999 while 00-69 corresponds to the years 2000 to 2069.
  27.    If the year is not given as in the last example above then the current
  28.    year is assumed. Indeed, if the month is missing as well then the current
  29.    month is used. Thus if today is 23/5/2016 then the following entries
  30.    represent the same day:
  31.  
  32.       23        Today!
  33.       23/5      Today!
  34.       23/5/16   Today!
  35.       23/5/2016 Today!
  36.  
  37.  
  38. Timed events:
  39.    If the start of the event description appears to be a time or a duration
  40.    (two times separated by a dash) then the program produces a timed day
  41.    entry for the event. If the time or duration contains mistakes then the
  42.    program assumes it is part of the event description and an untimed event
  43.    is produced as described in the previous section.
  44.  
  45.    Timed events can use a mixture of 12 hour and 24 hour clock formats although
  46.    only the colon (":") can be used as the separator. If the 12 hour clock is
  47.    used then the time should end with "am" or "pm" (capitals or lower-case) and
  48.    the minutes can be omitted (provided the time separator is also omitted).
  49.    If the 24 hour clock is used then both the hour and the minutes must be
  50.    provided.
  51.  
  52.    Durations consist of two times separated by a dash and each can be in
  53.    either time format. If the second time is earlier than the first one the
  54.    program assumes that the even crosses midnight. Due to a bug in Agenda
  55.    this program will consider the event to stop at midnight. If the second
  56.    time is omittted the program assumes the event continues until midnight
  57.    the same day.
  58.  
  59.    If there should be any error in the time format the program assumes that
  60.    the time is actually part of the event description and an untimed event
  61.    is produced.
  62.  
  63.    Some examples of timed entries are:
  64.  
  65.       1/4/97 8.30 Leave for work (invalid time format).
  66.       2/4/97 9am-1pm Morning at work.
  67.       2/4/97 13:00-2pm Lunch break
  68.       2/4/97 10pm- Sleeping!
  69.       3/4/97 9pm-3am Overnight party!
  70.  
  71.  
  72.    Note that the first one contains an invalid time separator and will
  73.    be entered as an untimed entry.
  74.  
  75.  
  76. Hints:
  77.    * Make sure the program always has logging turned on if you are converting
  78.      files in "ignore" or "auto-fix" mode and check the logfile afterwards to
  79.      see what happened if any errors occurred.
  80.  
  81.    * Run in "ask user" mode - usually there would be no errors and thus no
  82.      need for user intervention. If any errors do appear then it is probably
  83.      quicker to fix them during conversion rather than do it later in Agenda.
  84.  
  85.    * If you already have a \TXT directory which you use to keep other text
  86.      files in try using the "Create new list" option from the "Special" menu
  87.      on the system screen. Refer to the Psion User Guide for details.
  88.  
  89.  
  90. Frequently asked questions:
  91.    Q) How can I control the settings of the Agenda files produced by Txt2Agn
  92.       (e.g. diamond list, printing)?
  93.    A) Use Agenda to load \APP\TXT2AGN\TXT2AGN.AGN and change any settings you
  94.       want. Make sure the file is saved and quit Agenda. The next time you
  95.       use Txt2Agn the new settings will be used.
  96.  
  97.       An alternative method is to open an Agenda file which has already been
  98.       configured and use the "Merge" option in Agenda.
  99.  
  100.    Q) Why can't I enter dates after the year 2069 or before 1970?
  101.    A) This is due to limits imposed by the Psion OS. Dates outside this range
  102.       will be considered to be an error.
  103.  
  104.    Q) Why doesn't auto-fix mode work very well?
  105.    A) It is extremely difficult (impossible generally!) to correctly guess
  106.       what date the user actually meant. Thus the program simply works back
  107.       to find the first valid date prior to the illegal one. Hence 12/13/98
  108.       is guessed as being 12/12/98 and 31/09/04 is guessed as 30/09/04.
  109.  
  110.    Q) Can I use four figure years such as 1997 instead of 97?
  111.    A) Yes but you are only allowed years between 1970 and 2069.
  112.  
  113.    Q) How can I change the date separator from "?"?
  114.    A) You can't - perhaps in a later version!
  115.  
  116.    Q) How can I change the time separator from ":"?
  117.    A) You can't - perhaps in a later version!
  118.  
  119.    Q) Why does an event begins one day and ends the next appear to stop
  120.       at midnight?
  121.    A) There is a bug in the Agenda program which prevents entries
  122.       spanning midnight (try creating one in Agenda yourself). A future
  123.       release of this program might create two entries, one ending at
  124.       midnight on the first day and the other starting at midnight the
  125.       and continuing into the next day.
  126.  
  127.    Q) How can I quit from the program once it has started?
  128.    A) From the main dialogs you can leave the program by pressing the Escape
  129.       key. If the program is actually creating the Agenda file or processing
  130.       the input file Escape will pause the program and give you the chance to
  131.       quit.
  132.  
  133.       If you really need to stop the program urgently hold down the Psion key
  134.       and press Escape. If this fails choose "Kill Application" from the
  135.       "Apps" menu on the system screen. If you use any of these emergency
  136.       exits you should remove the Agenda file that was being created as it
  137.       will be corrupted and might crash the Agenda program if you try to use
  138.       it inadvertently.
  139.  
  140.   ========================================================================
  141.     (c) Martin N Dunstan  (mnd@dcs.st-andrews.ac.uk)  March 30th, 1997
  142.   ========================================================================
  143.  
  144.