Kosovo Orphans' Appeal Charity CD

home *** CD-ROM | disk | FTP | other *** search

/ Kosovo Orphans' Appeal Charity CD / KosovoOrphansAppeal.iso / archimedesworld_cd2 / desktop / organiser / _organizer / _help < prev next >

Wrap

Text File | 1998-03-16 | 27KB | 642 lines

>> !Help file for !Organizer written by Chris Morison ⌐ 1997 ~~~~~~~~~~~~~~~~~~~~~~~~~ To obtain an Index: with !Zap : Do a search to buffer for '>>' with !StrongEd: Do a ListOfFound for '>>' >> Loading !Organizer ~~~~~~~~~~~~~~~~~~ To load Organizer: Double click on the !Organizer icon in the filer window. This will install an icon (either a clock or the !Organizer icon) on the icon bar. Click on the icon bar to open the MAIN WINDOW. If you already have an Organizer data file saved, then to load it into Organizer you must make sure the !Organizer application has been 'seen' by the filer, and then double-click on the data file. This will load Organizer, and then automatically load the data file into it. An alternative method of automatically loading your data into Organizer, is to set the system variable <Organiser$DefaultFile> to the path of your data file, and then run !Organizer in the normal manner. This can be done in the !Organizer.!Run file. >> Upgrading from !Organiser ~~~~~~~~~~~~~~~~~~~~~~~~~ To upgrade from any version of Organiser (the name for Organizer before version 1.31), simply run Organizer, and then drag your old Organiser application onto the Organizer icon bar clock. This will load all your old data into Organizer. One you have imported your data, you should save it into a new data file by selecting 'Save' from the icon bar menu and dragging the icon into a directory viewer. >> Icon bar ~~~~~~~~ The icon bar is either a Å Digital clock (see Set-up) Å Analogue clock Å !Organizer sprite Å A display of free memory Clicking with the middle (menu) button will open the MAIN MENU Clicking with the left (select) button will open the MAIN WINDOW Clicking with the right (adjust) button will open the SET ALARM WINDOW Clicking SELECT while holding down SHIFT will open the SET-UP WINDOW Clicking SELECT while holding down ALT will turn the icon into the free memory display for a few seconds. >> Main window ~~~~~~~~~~~ The main window consists of two pages connected by rings, with vertical, coloured TABS on the left and right of the pages. Clicking on the tabs opens the relevant SECTION. Clicking the middle mouse button in the main window will open the relevant SECTION MENU. >> Calendar section ~~~~~~~~~~~~~~~~ The calendar section is just a simple calendar, with either one year per page, or one year spread over two pages. Depending on the choices (see Set-up below) clicking with Select/Adjust will either open the diary at the selected date or open the SET ALARM WINDOW with the selected date. >> Diary section ~~~~~~~~~~~~~ The diary can be displayed in three formats : Å Two weeks in view (see Set-up) Å One week in view Å Two days in view Clicking within a day will open the SET ALARM WINDOW with the selected date. Clicking on an alarm with SELECT will edit the selected alarm. Clicking on an alarm with ADJUST will copy the selected alarm. >> Anniversary section ~~~~~~~~~~~~~~~~~~~ The anniversary section is used to store peoples birthdays and anniversaries. To add an anniversary, click in one of the months, enter the date of birth/marriage, and enter the description. The description can contain wildcards, so that they can tell you how old the person is, whether an anniversary is gold, silver etc. The wildcards are: %n number of years since date entered %t either Éstæ Éndæ Érdæ or Éthæ depending on the value of %n %T as above but upper-case %y either Éyearæ or Éyearsæ depending on %n %Y as above but upper-case %c name of anniversary, eg Ésilveræ Égoldenæ etc. Here are some examples: öChrisæs %n%t birthdayò could produce: Chrisæs 1st birthday Chrisæs 20th birthday, etc öParentæs %n%t%c anniversaryò results in: Parentæs 27th anniversary or: Parentæs 50th (golden) anniversary The message is automatically displayed in the Diary section, so seperate repeating alarms donæt need to be set. The actual message depends on the date of origin and the current date (or the date being viewed in the Diary). The age/anniversary shown in the Anniversary section is as at the next birthday/anniversary. Clicking on anniversaries in the Diary section has the same effect as clicking on them in the anniversary section. Clicking with SELECT will edit the alarm, and clicking with ADJUST will copy the alarm >> Address-book section ~~~~~~~~~~~~~~~~~~~~ The address-book section contains 3 different types of page: >> Important numbers page This page can be used to store up to 16 important numbers. To enter (or edit an existing) important number, just click on the line in which you want the number to appear. >> Address entry page This page is used to add new addresses, or to edit existing ones. To add a new address, type in the information, then click on ACCEPT (or press the INSERT key). >> Addresses pages These pages are found by clicking on the capital letters down the right-hand side of the Address-book. The number of address per page can be altered from the Set-up window. Clicking on an address will move it to the Address entry page, so that it can be editted or deleted. The ADDRESS-BOOK menu can also be used to edit, copy or delete the address that the menu was opened over. The menu can also be used to paste the address details to the cursor within another application. >> Pasting address details To paste some address details into another (target) application (eg !Edit or Impression): 1) Position the caret in the target window (this can be done later) 2) Open the ADDRESS-BOOK menu over the required address by clicking the MIDDLE mouse button 3) either: Å click on ÉPaste at cursoræ to paste the default fields Å click on one of the ÉPaste at cursoræ sub-menu options to paste specific fields 4) If you havenæt done so already, position the caret in the target window >> Importing Addresses from other databases If you already have an address database, and would like to import all the addresses into Organsier quickly, then follow these steps: 1) In the other database, save the data in CSV (Comma Separated Values) format, either to disc, or straight onto Organizer. If you have saved it to disc, then drag the CSV file onto any Organizer window or icon. This will cause Organizer to open to the Address Entry Page and to open the Import window. 2) The Import window contains a list of the fields used for addresses within Organizer, and against each field is a column number. This column number is the column in the CSV file which will be used for the corresponding field. Change these column numbers until the data in the Address Entry Page is all in the correct place. In some circumstances, the other database may save a persons name in one field, eg öChris Neil Morisonò. If this is the case, then select both ÉSurnameæ and ÉFirst Namesæ fields to be taken from the same column, and give the ÉSurnameæ field the ÉAfter last spaceæ special treatment, and give the ÉFirst Namesæ field the ÉBefore last spaceæ special treatment. This will ensure the ÉSurnameæ becomes öMorisonò, and that the ÉFirst Namesæ becomes öChris Neilò. Some databases store an address in a single column, with each line separated by É\næ, eg ö4 Arley Close\nMacclesfield\nCheshireò. If this is the case, then you can split the address over several fields by mapping each field to the same column, selecting the ÉLine separatoræ option, and typing in the separator into the writable icon. Example: If a line of the CSV file was: ~~~~~~~ "Chris Morison","4 Arley Close\nMacclesfield\nCheshire\nSK11 8QP"... Then you would map the ÉFirst namesæ and ÉSurnameæ fields to column 1, giving the ÉFirst namesæ field the ÉBefore last spaceæ special treatment, and the ÉSurnameæ field the ÉAfter last spaceæ special treatment. Then you would map the address fields to column 2, select the ÉLine separatoræ option, and enter ö\nò into the writable icon. 3) When the data is all in the correct place, select ÉAcceptæ either from the Import window. This will add the address that was in the Address Entry Page, and load the next line from the CSV file. 4) If you are confident that all addresses from the other database will be in the same format, then you can click on ÉAccept allæ, which will add the current address, and all the rest from the CSV file. However, if you have given the ÉSurnameæ and ÉFirst namesæ fields the above special treatments, and some of your addresses are for businesses with names like ÉAcme Computers Ltdæ, then ÉLtdæ will be chosen as the surname, and the address will be stored under ÉLæ. If this may be the case, then you should accept the addresses one at a time, making sure they are all mapped correctly first. 5) Once all the addresses have been added, either close the Import window, or click on ÉCancelæ within the Import window. >> Finding text within an address If you are trying to find who a particular phone number belongs to, or you are looking for Jimæs address, but you canæt remember his surname, then you can use the Find facility. To do this click MENU anywhere in the address book, and open the ÉFindæ sub-menu. The first menu item is writable, so write the text you are looking for in the first menu item (case is ignored), and press RETURN. If the text is found anywhere within an address, then the Organizer will be opened at itæs page. To find the next occurrence of the text, either click on the ÉNextæ menu option in the ÉFindæ submenu, or click on ÉFindæ in the address-book menu. To find the previous occurrence of the text, select the ÉPreviousæ menu option in the ÉFindæ submenu. >> Exporting addresses into a CSV file To transport the whole address data-base to another application, it can be saved as a CSV file which can then be loaded into the other application. A CSV file contains each address-book entry in a single line, with each field separated by a comma. To create a CSV file, select the 'Export CSV' menu option from the address-book menu, this will open a window containing four options. The 'Include headings' option will add a line containing the name of each field to the beginning of the CSV file, so that the fields can be mapped more easily into other programs. The 'Use quote' option simply places each field between a pair of quotes ("), which may be necessary for some programs. The 'Use full names' option saves names in their natural format (eg 'Chris Neil Morison') instead of surname followed by other names (eg 'Morison,Chris Neil'). The 'Put address in a single line' option causes the whole address for an entry to be stored as a single column, with a separator between each line of the address. Some data-bases require addresses to be imported in a format like '4 Arley Close\nMacclesfield\nCheshire\nSK11 8QP', in which case the single line option should be selected, and '\n' should be entered into the separator writable icon. When the options are selected as required, save the CSV file as normal by dragging the CSV file icon into a directory display, or enter the path name for the file into the writable icon and press RETURN (or click on OK). >> Alarm system ~~~~~~~~~~~~ >> Importing !Alarm files To import alarms from your Alarm data-base, simply drag the Alarm file into anything belonging to Organizer, and the alarms will be added to the diary. If an alarm is found which repeats annually, then you will be asked if you want the alarm to be placed in the Anniversary section instead of the diary. If this is the case, then select the 'Treat it as an Anniversary' option, enter the year of origin and the message into the writable icons, and click on 'OK'. If you want the alarm to be treated as an alarm, then select the 'Treat it as a normal alarm' option and click on 'OK'. >> Adding an alarm To add an alarm, either: Å click on the Organizer icon with the right mouse button Å click on the required date in the Diary Å click on the required date in the Calendar Å select the ÉSet alarm...æ menu option in the MAIN MENU To change the date of the alarm, click on the date text near the top of the SET-ALARM WINDOW. >> Editing an alarm To edit an alarm, click on the alarm (in the Diary section) with the left mouse button (select). >> Copying an alarm To copy an alarm, click on the alarm (in the Diary section) with the right mouse button (adjust). >> Deleting an alarm To delete an alarm, edit the alarm as above, and either: Å Click on the ÉDeleteæ icon in the Edit-Alarm window Å Press Ctrl-X or Ctrl-D >> Task Alarms Task alarms are alarms whose Émessageæ is executed just as if it was typed in at the command line. These alarms can be very useful for doing certain tasks at regular intervals, such as automatically scanning hard discs for viruses once a week, backing up certain files once a month, etc. To create a task alarm, you must open the Set Alarm Window first (see Adding an alarm), then you can either: Å Drag the file/application that you want to be run into the Set Alarm Window. This will select the ÉTaskæ option and insert the full path of the object into the message. Å Manually select the ÉTaskæ option and type the *command or path into the message writeable icons. If you run out of space in one icon, then continue typing in the next icon. NB A É*æ is not needed before the command. It often doesnæt look very nice if the *command or filename is displayed in the diary. For example, if you wanted to run a virus scanner and itæs path was ÉADFS::HardDisc4.$.Apps.Virus.Scanners.!VirusKillæ, then it wouldnæt make much sense for this path to be displayed in the diary. Therefore task alarms can be given descriptions. To give a task alarm a description, prefix the message with (eg) ö=Check for viruses*ò, so that the complete message would be: ö=Check for viruses*ADFS::HardDisc4.$.Apps.Virus.Scanners.!VirusKillò. If this format is used then anything between the É=æ and the first É*æ is displayed in the diary, and only text after the first É*æ is executed as a command. An easy way to execute a list of commands with only one alarm is to create an ÉObeyæ file (file type &FEB) containing all the commands you want to be executed, and then run this Obey file from the task alarm. If the task is a file or an application, then Organizer will try to interpret how to run it. If the object is a file, and no ÉFiler_Runæ or ÉRunæ precedes it, then Organizer will ÉFiler_Runæ the file. However, this will cause an error if you are trying to pass parameters to the file (ÉFiler_Runæ cannot take paramters). In this case you should prefix the filename with ÉRun æ. >> Choices window ~~~~~~~~~~~~~~ The chioces window can be used to configure Organizer to your preferred settings. Some of the settings are explained: >> Auto save Organizer can be forced to save your data, as soon as you make alterations. This is useful incase your computer crashes for any reason, or you are in the habit of just switching it off without doing a proper shutdown. >> Use fonts in icons This option should only be selected if you have donæt have RiscOS 3.5 or higher. If you do have RiscOS 3.5, alternative fonts in ÉOKæ icons can cause the desktop font to be forgotten. >> Quick boot up This option forces the data to be loaded in the background, so that if Organizer is automatically loaded in your Boot up sequence, it will wait until everything else has loaded before the data is loaded. You can even do stuff while the data is loading. >> Allow <CTRL-S> case switching For compatibility with some other programs, I have allowed the case of the character just entered to be changed by pressing <CTRL-S>. Incase this interferes with another hot-key on your system, this feature can be disabled. >> Switch between BST and GMT automatically When selected, Organizer will monitor the time and date, and if it discovers that the computeræs clock should be in Daylight Saving Time (called British Summer Time in the UK), when it isnæt (or vice-versa), it will alter the clock as necessary. The dates for the switching to and from Daylight Saving Time have been confirmed for the European Union upto the year 2001 as being: DST start: last Sunday in March at 1am GMT DST end: last Sunday in October at 1am GMT (2am DST) If these dates are incorrect for your country (or it is past 2001), then you can contact the author for current dates, or if you happen to know the dates, you can edit the Messages file (the format is explained within the file). >> Auto Open This option will cause the main window to be opened automatically EVERY time Organizer is run. By using the radio buttons adjacent to the auto open option, it can be made to open either in the centre of the screen or at its current position. The current position will be remembered when the OK button is pressed in the choices window. If the option is left un-selected, then the ÉCentreæ and ÉUse current positionæ radio buttons determine the main windowæs position for when it is opened via a click on Organizeræs Icon-Bar Icon. >> Interactive Help This option lets you choose whether or not to support interactive help. If you are new to Organizer, then using interactive help is a good way to learn about its powerful features, however, if you know what you are doing then you can disable the feature and save about 17k of memory. >> Fix Window Size When this option is selected, Organizeræs main window size is fixed. If you use a small screen mode, or would like a larger main window, then you can un-select this option, and resize it to your liking. >> Rings This option allows the fussy among you to change the number and spacing of the rings connecting the left and right hand pages. The text entered should consist of only É0æ and É1æ. The total number of characters will be the total number of possible rings, and any of them can be turned on or off. Eg, É111000111æ draws three rings near the top and bottom of the page, and É10100æ draws one ring near the bottom and one ring near the middle of the page. >> Quiet hours Organsier can be forced not to beep (when alarms or anniversaries are actioned) either all the time, or between certain hours. The hours during which is can beep should be selected using the up/down arrows. >> User Definable Digital Clock The digital clock can be defined by the user by typing in a string of field names in to the writable icon. The field names available are: Name Value Example %cs Centi-seconds 99 %se Secnds 59 %mi Minutes 05 %12 Hours in 12 hour format 07 %24 Hours in 24 hour format 23 %am Éamæ or Épmæ PM %pm Éamæ or Épmæ AM %we Weekday, in full Thursday %w3 Weekday, in three characters Thu %wn Weekday, as a number (Sunday=1) 5 %dy Day of the month 01 %st Éstæ, Éndæ, Érdæ or Éthæ st %mo Month name, in full September %m3 Month name, in three characers Sep %mn Month as a number 09 %ce Century 19 %yr Year within century 87 %wk Week of the year, Mon to Sun 52 %dn Day of the year 364 %% Insert a É%æ % Case is ignored, and inserting a Ézæ between the É%æ and the field name will cause leading zeros to be omitted. An example is: É%z12:%mi:%se %am. %sy/%mn/%yræ => É9:53:56 am. 26/10/97æ >> Auto Quit If your computer doesn't have much spare memory, then there is a method of forcing Organizer to quit as soon as it is run if there are no alarms set for the day. This option is not available from the choices window, but has to be set in the '!Organizer.!Run' file (if the option were to be set from the choices window, there would be no way of turning the option off). To use this option, the last line of the '!Organizer.!Run' file should be ammended to: Run <Organizer$Dir>.!RunImage -auto_quit %*0 >> Get Date Window ~~~~~~~~~~~~~~~ The Get Date Window is used in a variety of places: Å To ÉGo-Toæ a particular date in the Diary Å To set the date of an alarm Å To set the current date. To change the Month, click any mouse button on the date at the top of the window. To change the date, click on the icon containing the date required, or double click to select the date and close the window. To change the year click on the up/down arrows either side of the year, or hold down SHIFT while you click to change the year in steps of 50. >> Tips on increasing page drawing speed ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Tips On Increasing Redraw Speed #Parent !Root #FH2:Tips On Increasing Redraw Speed Organsier makes use of outline fonts in it's main window so that it looks nicer, however this can make turning through it's pages a little slow at times. The most obvious way to speed this up, is to turn off the page turning animation. However, if you have more memory than you know what to do with there is another way, and that is to save the font cache. To do this you must set the font cache big enough to store most, if not all, of the fonts Organizer uses (I use a 360K font cache). Then you must make sure all the necessary fonts are cached by scrolling up and down the address book at least twice (it sould appear faster the second time), if you have a RiscPC you may want to open a few directory viewers and scroll through the task manager a few times to ensure your Desktop Font is cached too. Then press F12 and type: *SaveFontCache MyCache This will save the fontcache to the file MyCache in the Currently Selected Directory, probably the root directory of your hard disk. This file then needs to be run somewhere near the beginning of your Boot sequence. If you have a RiscPC, simply move the file into the !Boot.Choices.Boot.PreDesk directory, otherwise move the file somewhere more convenient and then use the command: *LoadFontCache <Pathname>.MyCache somewhere in your !Boot file >> Hot-Keys ~~~~~~~~ s=<SHIFT> c=<CTRL> Main window : F1 Load the help file (this file) F2 Open the Set-up window F3 Save sF1 Open the Calendar section sF2 Open the Diary section sF3 Open the Anniversary section sF4 Open the Addressbook section cQ Quit Organizer PgUp Turn back a page PgDn Turn over a page Calender : HOME Goto the current year Diary : HOME Goto the current date F4 Open the GET DATE WINDOW F5 Find the first diary entry F6 Find the diary entry before to the current page F7 Find the diary entry after to the current page F8 Find the last diary entry cX Will delete the alarm being editted cD Will delete the alarm being editted Anniversary : cX Will delete the anniversary being editted cD Will delete the anniversary being editted Address-book: INS Will go to the Address entry page, unless editing/creating an address, in which case INS has the effect of clicking on ÉAcceptæ >> About the Author ~~~~~~~~~~~~~~~~ !Organizer was written by me, Chris Morison This program is supplied öas isò. No warranty, express or implied, of the merchantability of this program or its fitness for any particular purpose is given. In no circumstances shall the author, or any provider or distributor of this program, be liable for any damage, loss of profits, or any indirect or consequential loss arising out of the use of this program. The program is Share-Ware, but may be distributed freely provided that no changes are made to any part of the program (including Help files, Sprites, Templates, excluding data), and that this file accompanies any copy made. See below for registration details. If you have any suggestions for future versions, or have come across any bugs, the please contact me: Chris Morison 4 Arley Close Macclesfield Cheshire SK11 8QP email: mme4cnm6@bham.ac.uk (may change after June 1998) If no response try: chrismorison@btinternet.com www: http://www.arcsite.de/hp/chrismorison/ >> Latest Version ~~~~~~~~~~~~~~ My web-site above will always contain the latest version of !Organizer (and any of my software I deem fit enough for distribution), However if you contact me now, I will keep you informed of new releases (preferrably by e-mail). >> Registration ~~~~~~~~~~~~ The application ÉOrganizeræ is Share-Ware. You are free to use Organizer for a period of one month, after which time you must either stop using it, or register your copy with the Author. The registration fee is 5 pounds sterling, which must be sent to the Author at the address above in the form of a cheque, postal order or international money order made payable to ÉChris Morisonæ and in pounds sterling. If you cannot purchase an International Money Order for less than the equivalent of 5 pounds, then you may send the equivalent of 10 pounds cash in your own currency (you may round to the nearest note). The registration fee must be accompanied by a letter containing the following information: Family name: First name(s): Address: Country: Telephone number: Fax number: E-Mail address: Preference for receiving new versions: Post/E-mail/Internet download Your registration WILL be confirmed by post or e-mail. A greatly improved version of Organizer is being worked on, and will eventually be released as a commercial product. Registration now will ensure a discount of 10 pounds sterling off the price of the commercial version.