======================================================================== (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 ========================================================================