LoGG 1.2 QUICK HELP Copyright (c) 1991-94 A. G. Kartsatos 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, ENDCLI, EXECUTE, LoGG.file, RUN, STACK Some of these files might be built-in for AmigaDos 2.0 for the 3000. LoGG looks for the file "LoGG.file" in your "c" directory as well as as your current 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, EXECUTE, LHARC, LoGG.file, PAK, RUN, STACK, WARP, ZOO Some of these files might already be built-in with the Amigados 2.0 of the Amiga 3000. You must name these files exactly as above. For example, EDIT is your favourite editor program. The files CD, ENDCLI, RUN and STACK are your usual Workbench files. 3) To make one of the two windows on your front panel the SOURCE window, just click into its vertical gadget or anywhere into it. Then the other window will automatically become the DESTINATION window. 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 a pathname in it, just enter the desired pathname into the "D" or "S" gadget and press . 5) Configure LoGG so that it carries your own 4 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 into LoGG's RUN gadget. Change any of the 4 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, just 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, just choose the CONFIGURE item of the first menu to get LoGG to adjust itself to the change. 6) Study the file LoGG.file so that you can create up to 48 gadgets with your own titles and your own commands. The titles of the gadgets should be at most 8 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 - 24 in your LoGG.file) can accommodate up to 7 different command lines each. Only the first of these commands can contain the token "CD" in it and a symbol for the CLI as described below. Only the first token of the first command line of a MACRO can be "CD". The PARMS (Entries 25 - 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) (SMALL)", "HELLO %s HERMES %s JULIE (R) (TINY)", "EDITOR %s (FULL)" 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 that you enter in the file requestor. 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 para- meter. 2) If there is no selected file, LoGG will bring the requester out for you to enter a string for this parameter. The symbols (TINY), (SMALL) and (FULL) are the sizes of the CLI windows that you can open with your command. They are always at the very end of your command and at least one space away from the previous command token. Naturally, you can only use one such symbol per command. The symbol "(R)" here means that 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 before any CLI symbol. "(R)" must again be at least one space away from from adjacent command token. 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, just 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. Just 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 copy files from one of the display windows into another path not currently on display in the opposite window, you can just enter that path in the DESTINATION BUFFER "D" and click into the COPY gadget. When copying is finished, LoGG will list that destination path. The same remark applies to the MOVE operation. 10) Pressing QUIT while FORMATTING/DISKCOPYING might corrupt the desti- nation disk. Do not use QUIT (on the FORMAT/DISKCOPY requester) unless it is absolutely necessary. 11) READ: This is a fully operational file reader. It will list the selected file and will scroll through it very fast. It has 8 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 into the upper or lower half of the reader screen. (1) GO TO LINE: You can choose this menu item, or just press RIGHT_AMIGA-G instead. As soon as you do that, the GOTO-gadget clears up. Just go ahead and type in the line number you want to see. Then press . The program will then try to exhibit that line as the top line of the page. Another way of doing this: Just click into 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 . 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 just press RIGHT_AMIGA-F instead. As soon as you do that, the FILE-gadget clears up. Just go ahead and type in the string that you want to see. Then press . The program will then try to exhibit that string at the top line of the page. Another way of doing this: Just click into 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 . The program will do nothing if the string that you have entered does not exist from the current line on. (3) SEARCH AGAIN: Well, now that you have found the string, just choose this menu item or press RIGHT_AMIGA-S to try to find the string again. The program will try 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 secong line of your page down to the end of the file. 12) 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. 13) 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 a little patient. 14) If you get a little confused about the exact name of a file which is not completely listed, just select the file and click into 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. 15) 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 that you have this command included in your "c" directory. 16) 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. 17) When a directory has a lot of subdirectories, you may get a list- ing in one of the panel windows consisting only of directories. Thus, you do not see the files which follow below. If any of these files have been highlighted and you click into DELETE, you might delete the files without even ever seeing them. So, please exercise caution with gadgets like DELETE and MOVE. It is good practice to click into the CLEAR gadget from time to time in order to avoid cases like this. 18) If the disk you have just inserted (or a path on it) is listed in one of your front panel windows, you should refresh that window's listing by using the SOURCE or DESTINATION gadgets, or by clicking into one of your drive gadgets. To see why you need to do this, suppose that you have listed "DF1:" in your DESTINATION gadget. Now, suppose that you insert a new disk in "DF1:" (not the one you have just removed). Then if you do not refresh the DESTINATION window, LoGG will think that the current listing there is the listing of the disk that you have just inserted. Although no damage can result from this, you can get a confusing listing of files and directories in that window if, e.g., you try to copy files there. LoGG will notify you to refresh your window(s) whenever disks have been inserted or modified (via FORMAT, DISKCOPY, etc.). 19) Please avoid using names of directories and files that contain empty spaces in them. You can always replace, for exampe, "HELLO JOHN" by "HELLO_JOHN". Certain archiving programs (among others) do not work right with such names. Although LoGG will do its best to work with such names (in the first 48 built-in gadgets), there is still some overhead in trying to do so.