4]---------------------------- 3]QUICK HELP FILE FOR LoGG 1.0 3]By A. G. Kartsatos 4]---------------------------- 1) To run the program with most of the basic functions working, you will need at least these files in your current C directory: CD, LoGG.file, ENDCLI, STACK and RUN. LoGG looks for the file "LoGG.file" in your current directory as well as your C directory. The program will abort if it does not locate this file. This is the file that contains the names of your drives, the 4 colors and the 48 user-definable gadgets. 2) For a fully operational LoGG you will need the following files in your current C directory: ARC, CD, EDIT, ENDCLI, LHARC, LoGG.file, PAK, RUN, STACK, WARP and ZOO. You must name these files exactly as above. For example, EDIT is your favorite editor program. The files CD, ENDCLI, RUN and STACK are your usual Workbench files. 3) Click on a vertical gadget to make the corresponding window the SOURCE window. When SOURCE and DESTINATION are the same, do not try to copy from one to the other because you cannot copy a file to itself. 4) Click fast twice on the name of a directory in order to attach to it. If a DRIVE is not listed in your list of 14 drives and you want to see it, enter the desired pathname into the "D" or "S" gadget and press Return. 5) Configure LoGG so it carries your own four colors and your own 14 drives. Attach to a place where you can find your palette. Run the palette by selecting it first and then clicking on LoGG's RUN gadget. Change any of the four colors on the palette (you get 3 HEX numbers for each color) and then place those 12 numbers in the third line of your LoGG.file. To place your own drives in LoGG, enter 14 drive names into the first two lines of your LoGG.file. You may repeat drive names of course. After you have made any change to your LoGG.file while you are running LoGG, choose the CONFIGURE item of the first menu to get LoGG to adjust itself to the change. 6) Study the file LoGG.file so you can create up to 48 gadgets with your own titles and your own commands. The titles of the gadgets should be at most eight characters long. The corresponding title entries in the file LoGG.file should be exactly 10 characters long, like "DPAINT *", "CONTOURA *", etc. You should not include the quotes in your LoGG.file. The MACROS (entries 1 to 24 in your LoGG.file) can each accommodate up to seven different command lines. Only the first token of the first command line of a MACRO can be "CD". The PARMS (Entries 25 to 48 in your LoGG.file) can only carry one command line. This command line can have up to 5 tokens and at most 2 para- meters. For example, "FIXOBJ %s %s (R)", "HELLO %s HERMES %s JULIE (R)", "EDITOR %s" . . . are acceptable PARMS command lines. If there are two parameters (%s) in a PARMS command, the first one is a highlighted file and the second is a string you enter in the file requester. If there is only one parameter in your command line, there are two possibilities: 1) If there is a file selected (highlighted), LoGG will pick the name of that file for this parameter. 2) If there is no selected file, LoGG will bring the requester out for you to enter a string for this parameter. The symbol "(R)" here means you want to have the file listing refreshed after the execution of this command. The symbol "(R)" must be placed at the end of your command and at least one space away from the last word/symbol in your command. After you have made any change to your LoGG.file while you are running LoGG, just choose the CONFIGURE item of the first menu to get LoGG to adjust itself to the change. 7) Sometimes your LoGG.file gets funny with some possibly invisible characters in it. To correct it, run the file FIX_FILE. This file will attempt to correct your LoGG.file and put the corrected contents in a file called LoGG.file1. Rename LoGG.file1 as LoGG.file and continue as usual. 8) IMPORTANT! Do not forget that you can stop the SEARCHING OF FILES AND STRINGS, CATALOGING, COPYING AND MOVING OF FILES, etc., by just clicking into the STOP BUTTON on your front panel. 9) To make one of the two windows on your front panel the SOURCE window, click on its vertical gadget or anywhere into it. Then the other window will automatically become the DESTINATION window. 10) To copy files from one of the display windows into another path not currently on display in the opposite window, enter that path in the DESTINATION BUFFER "D" and click on the COPY gadget. When copying is finished, LoGG will list that destination path. The same remark applies to the MOVE operation. 11) Pressing QUIT while FORMATTING/DISKCOPYING might corrupt the destination disk. Do not use QUIT (on the FORMAT/DISKCOPY requester) unless it is absolutely necessary. 12) READ: This is a fully operational file reader. It will list the selected file and will scroll through it very fast. It has eight menu items. We will only elaborate on the items that need some explanation. Just remember that you can scroll the text up and down by using the respective arrow keys or by clicking on the upper or lower half of the reader screen. (1) GO TO LINE: You can choose this menu item or press RIGHT_AMIGA-G instead. As soon as you do that, the GOTO-gadget clears up. Go ahead and type in the line number you want to see. Then press Return. The program will then try to exhibit that line as the top line of the page. Another way of doing this: Click on the GOTO-gadget, clear it up by using the BACKSPACE key (or pressing RIGHT_AMIGA-X), enter the line number that you wish to exhibit, and then press Return. The program will do nothing if the line number that you have entered does not exist. (2) FIND STRING: You can choose this menu item, or press RIGHT_AMIGA-F instead. As soon as you do that, the FILE-gadget clears up. Go ahead and type in the string that you want to see. Then press Return. The program will then try to exhibit that string at the top line of the page. Another way of doing this: Just click on the FILE-gadget, clear it up by using the BACKSPACE key (or pressing RIGHT_AMIGA-X), enter the string that you wish to exhibit, and then press Return. The program will do nothing if the string that you have entered does not exist from the current line on. (3) SEARCH AGAIN: Now that you have found the string, choose this menu item or press RIGHT_AMIGA-S to try to find the string again. The program will attempt to locate the string and exhibit it at the top line of the page. Again, the program tries to locate the given string starting from the second line of your page down to the end of the file. 13) You should change to HIRES (clicking into the RESOL gadget) if you have more than 800 files in the same directory listing. Otherwise you will get a partial listing of these files. If you are using the MEDIUM re- solution mode and LoGG finds out that there are more than 800 files in your directory, LoGG will inform you that you should change into the HIRES mode. 14) The STOP button does stop a file from being printed to your printer, but it takes some time before the Amiga responds to the signal to stop. So be patient. 15) If you get a little confused about the exact name of a file which is not completely listed, select the file and click on the FILEINFO gadget. The FILEINFO gadget contains the entire name of the file and information on the file's Protection Bits, Comment and Date of creation. 16) Whenever a CLI appears in the execution of a command or in an archiving process, you should close it by pressing EndCLI. It is important you have this command included in your C directory. 17) If you change your LoGG icon (this is the program icon, not the disk icon), please remember to enter the data in the TOOL TYPES gadget in the new icon as they appear in the original one. The icon that LoGG comes with opens a 1-pixel window on your WorkBench just in case LoGG needs to put some output somewhere. If you do not take care of this, LoGG may crash your machine when it tries to write an error statement into a nonexistent window.