Address Keeper V2.6 - (c) 1996, D.YOINGCO and J.WHITE. -------------------------------------------------------- A.K V2.6 was written on a 2Mb A600 (KS V37.300 - Roms 2.0) using Amiga `E' V3.2e (Registered User). What is it? ----------- A.K is an Address program that is meant for people, like me, who only need an address program for Keeping address details. For example, I mostly only use A.K when I need to look up a Forgotten address or want to Edit an address (I.e a Friend has changed their Address details), etc. About A.K... ------------ * It is Small-ish? Less than 56Kb. * It only needs the A.K .Config files/drawers - No other Files, Libraries, etc are needed - running on a PAL Amiga with KS V37 or Higher, to work. * When you need an address file you simply type in its Filename - A.K then looks for your File in the A.K-Files drawer. The advantages of this are: 1) No need to time waste, by looking in/at other Directories/Files that are not needed, simply type in your friends (File) name. Thus, your file is loaded straight away without the above mentioned time wasting. 2) Only One File is in memory at any one time. Thus, all files are not loaded into memory. By this I mean, some address programs load all files into memory so that all files are "Instantly Available to View". To me, the speed of loading and viewing a file compared with an "Instantly Available to View" memory stored file is very tiny, thus, Why be careless with memory? * In this updated version (V2.6) I have put more Icons into the program (for Mouse Mode functions), changed the Search and Load .Configs functions, cleaned up the code (by making most Variables LOCAL and making most, if not all, Memory/Strings Dynamic), put my own requesters in the program, etc. Functions --------- Note: Most, if not all, of these functions can only be switched Off/On when entering some text. In this case you will see an `e' beside the function key. An `m' means a function is only available in Mouse Mode. An `e/m' means a function is available when entering some text and/or in mouse mode (See MOUSE Mode, below). Note: A.K does not display what key(s) do what on the screen simply because when writing A.K I did not want the screen to be filled - I wanted a clear screen as much as possible. Also, I did not want everyone who uses my computer to know what A.K's keys were in a flash. In the future I will probably make a KEY.Config file so that the keys may be changed. Function Key Function ------------ -------- Left-Amiga `e' Switch Off MOUSE Mode. Right-Amiga `e' Switch On MOUSE Mode. Mouse Mode On will only be activated when you've finished typing your current line. The Mouse will appear, letting you know it's waiting to be activated when the above conditions happen. The mouse is not activated straight away simply because A.K gives you the chance to cancel mouse mode (with Left-Amiga). Once the mouse is activated you simply select/click on the entry box (like: Name, Address, etc) you want and start typing, as opposed to going by the entry box order. Mouse mode was put into A.K for those who are lazy (those who have never experienced the hard life with a 48k Spectrum!). Left-Alt `e/m' Create the next (selected) line. This allows you to Create the next selected line (if it's blank) or Edit the contents of the next selected line (once it's been created or if it's already been created). Right-Alt `e/m' Clear and Create the next (selected) line. Same as above, but the next selected line will be Cleared before it can be created. Editing is as above once the line has been cleared and created. Left-Blank `e' Keep the Cursor on the Current Line once `Enter' has been pressed. Depending on your LINE Mode (Create/ Clear and Create) the current line may be cleared on the next key-press (after `Enter') before editing is allowed. Right-Blank `e' Make the Cursor go to the Next (selected) Line once `Enter' has been pressed. LINE Mode, as above, applies. \ `e/m' Clear the Current Line. [ `e' Switch SAVE Mode Off. ] `e' Switch SAVE Mode On. With Save Mode On A.K will automatically Save your details when you have typed in a Fax Number and pressed Enter (with the Next Line cursor function ON). After pressing Enter you will be asked for a Password (press Enter if you do not want a Password) and then a Filename (pressing Enter for a filename will save your file as `Void'). Once your file has been saved the cursor will go back to the Name entry box - This only apples if you have MOUSE Mode OFF. If mouse mode is On you will have to select an entry box. ~ `e/m' A Panic Button! Clears everything from the screen just in case someone, who you do not want seeing your details, enters your room. The cursor is put back to the Name entry box. < `e/m' Select a DEVICE (Like: Ram: DF0: etc) to Load from/ Save to. = `m' Save the AKSettings.Config file. > `m' Load a Pointers (Configuration) file. ? `m' Load a Characters (Configuration) file. { `m' Search Mode (see `Search Mode', below). Cursor Up `e/m' Decrease the next entry box (Line) Pointer. This pointer allows you to assign any one of the nine entry boxes as the next entry box to go to. The cursor will go straight to your assigned entry box, after pressing Enter on your current entry box, if you are in `e' mode (MOUSE Mode OFF). This function is most useful if you have Save ON and you do not want to Save anything (perhaps you made a mistake), thus, the next entry box does not have to be the Password box. Cursor Down `e/m' Same as above, except it Increases the Pointer. ESC `m' Quit A.K. Help `m' Load a File. If the file does not exist or you enter the wrong password the file will not be displayed. LMB/F1-F10 `m' Select an entry box (Line) with either one of the specified F-Keys or with the Left Mouse Button. Editing Keys ------------ Left-Cursor Move Left One character. If the current character is a blank (Cursor) character and you use the Left-Cursor, this will put the new current character in insert mode. I.e Your next key-pressed character will be inserted in between the Left character and the current character. Right Cursor Move Right One Character. If the current character is in insert mode, as above, keep pressing the Right-Cursor until it makes the current character a blank (Cursor) character, if it is possible, thus restoring A.K back to its normal character mode. Delete Delete the Current Character, if it's not a blank (Cursor) character, and then drag everything from the right of the just deleted character Left one character space. If the current character is a blank (Cursor) character the Delete function does not work. Thick Left Arrow Delete the character to the Left of the cursor character and then drag everything from the right of the cursor character, including the cursor character, Left one character space. If the cursor character is a blank (Cursor) character the Thick-Left-Arrow function does not work. Please Note - I have tried my best to keep the cursor Workbench-Like. However, in some instances the cursor may not give you a blank (Cursor) character simply because A.K's cursor system follows the True Length of a line (String) rather than the true length plus a blank (cursor) character. How Safe? --------- A.K uses Pointers to disguise your Details. These pointers are in ASCII (Text) format so that it is easy to change them, in case anyone finds out what your pointers look like, and also so that you can easily remember what your pointers look like. A.K Pointers work like so (This is an example only).... The letter `A' represents the first letter of the alphabet, `B' the second letter, etc. Inside A.K it is the same. With this representation you also have two Configuration files (Characters and Pointers) which, when loaded, all work together to create your own unique encryption system. The Pointers.Config file holds a set of Pointers pointing to places in your Characters.Config file. The Characters.Config file holds the actual (normal) Characters (Text). So, if in the above example you typed `B' (The beginning of the name Bill Jones) A.K would represent 2 (the second letter of the alphabet) and the following would then happen.... 1) A.K would look at the Pointers.Config file, Position 2, and take position 2's value as its new representation. So, if position 2's value (pointer) was 78 A.K would then represent 78. 2) When your address file is saved A.K puts the value 78 in that file for every letter `B' it comes across. When you load an address file and A.K bumps into the value 78 it does the following.... 3) Now representing the value 78 A.K looks at position 78 of the Characters .Config file and takes that character value as its new representation. So, if position 78 of the characters.config file has a character value of 66 A.K would now represent the letter `B'. Thus, it will print the letter `B' onto the screen. That's it! Anyone looking at your Saved address file will only see 78. They will not know 78 is pointing to the letter `B' unless they have your .Config files or you tell them. Not content with the above, I also allowed each file to have a Password, using the above method. If the Password entered is incorrect the file does not get displayed. In the future I may give the owner the choice of quiting A.K if a password is incorrect, thus, the nosey parkers will be in the creek! If you do not want a password in your file simply press ENTER when asked for a password. The Character Layout -------------------- A to Z represents 1 to 26 a to z represents 27 to 52 Space 53 ! 54 " 55 # 56 $ 57 % 58 & 59 ' Back Apostrophe 60 ( 61 ) 62 * 63 + 64 , Comma 65 - Minus 66 . Full Stop 67 / 68 0 69 1 70 2 71 3 72 4 73 5 74 6 75 7 76 8 77 9 78 Take a look at the .Config files with a Text Editor for the layout. Your layouts must be the same as these files because A.K only reads these files in that format (it is possibly the quickest way for A.K - Not many Checks, etc). Before I forget. The @ Character is not in A.K (EMail Users, etc) so you will have to use another key for this character - put the actual @ character in your Characters.Config file. The Settings.Config file... --------------------------- The Settings.Config file is in ASCII (Text) format, with the following settings... Setting OFF Setting ON =========== ========== DEVICE - RAM: DF0: DF1: DF2: DF3: DH0: DH1: CURSOR - Same Line Next Line LINE - Keep/Edit Clear/New SAVE - Off On MOUSE MODE - Off On The OFF settings are what A.K looks for and what A.K defaults to if it does not find a suitable setting. The ON settings are ignored (I.e If you put MOUSE MODE - On, A.K will take this setting to be ON, because it could not find the OFF setting for MOUSE MODE which is: Off). The ON settings are just there to make the settings more understandable to the User, but are technically ignored. Search Mode... -------------- I will give an example of Search Mode rather than explain it, it is easier that way I think... 1) Make the Box function point to your desired Entry Box. I.e If you want to search for a Name then make the box function point to number one. If you want to search for a Street Number/Name make the box function point to number two and so on... 2) Press the { key. 3) Type in the String (Text) to search for (I.e John Williams for a Name or 77 Park Street for a Street Number/Name, etc). When you have entered a Search String A.K will search all files in the A.K- Files drawer for that String. For example, if you enter a Name to search for (with the Box function set to number one) A.K will search all the files, looking at each file's Name position for your name String. If your string is found you will be told which file to Load - The file will not be Loaded simply because you may be a nosey parker! and/or not know that file's password (if it has a password), etc. IMPORTANT!... ------------- On this disk is the FULL Shareware Version - It has NOT been disabled in any way, shape or form. The Shareware Fee for A.K 2.6 is £2.00 - When you Register your copy of A.K 2.6 you will be sent a Registration Certificate. All updates, if there are any, will cost you £1.50. To Register your copy of A.K 2.6 send your UN-Crossed Postal Order(s) - NO Cheque(s)/Cash, Please - to... John White 91 Comber House Comber Grove Camberwell London SE5 OLL Please make your (UN-Crossed) Postal Order(s) payable to: John White The reason for requesting UN-Crossed Postal Orders is simply because I do not wish to look silly going into the bank with a £2.00 payment! I grew up when £1 was like £50, but those days have gone, thus me depositing a £2.00 payment nowadays is like depositing 1p in the eyes of some banks. Finally... ---------- Note: Because I cannot trap every error, I will not take any responsibility for the loss or damage of any data, etc caused by any of the programs on this disk. Note: I will not take any responsibility for any damage of Hardware or Software, etc caused by any of the programs on this disk.