CARL-FSEL --------- (C)Carl J. Hafner ALL RIGHTS RESERVED September 26,1993 Carl-Fsel is designed to allow you to view disk directories by accessing the GEM fileselector from within any environment containing a GEM menu- bar. Access to specific directories and masks are ALL user definable ! DISCLAIMER ---------- The author cannot be responsible for any damage to your equipment, other software or hardware products, or physical or mental well being caused by the use, misuse, abuse or inability to use this program. The author also makes no guarantee as to the compatibility of this program with other software or hardware products. By using this program you are stating that you completely understand AND agree with these terms and are agreeing to accept FULL responsibility for ANY and ALL circumstances arising from its implementation. If you do not understand AND agree, DO NOT use this program ! NAMING IT --------- CARL-FSEL was designed to run as an ACCessory, although it CAN also be run as a program. Rename it CARLFSEL.ACC and place it with your other accessories in order to have it RUN as an accessory. Be sure to reboot your system to load it. Name it CARLFSEL.PRG and double-click on it from the desktop to have it run as a normal GEM program. THE PANEL --------- o EXITING ------- CARL-FSEL works in a similar way to a GEM window. The little box in the upper left hand corner exits CARL-FSEL without any changes, just like closing a window. If you hold down either a [SHIFT], [ALTERNATE] or [CONTROL] key while exiting, an alert will appear. This alert will allow you the option of issuing a FORM_DIAL (basically a screen redraw command) of 1280 x 1280. This allows you to "clean up" after messy accessories which punch holes in the screen. o MOVING ------ You can grab CARL-FSEL by the top "title bar" and move it about the screen, just like you would a GEM window. Clicking once on the "parent" panel centers the box on the screen. o SELECTING A DRIVE ----------------- Below the title bar are buttons representing your floppy and hard disk drives. Merely click on one to select it. Inactive drives will be disabled. The fileselector will open to the drive which is selected. If a "path" has been previously set for that drive, the fileselector will open to that path (until you change it or until CarlFsel is removed from memory). Otherwise it will open to the root directory of that drive. o EXTENDERS --------- To the right are 16 lines on which you can enter filename extensions. These are the last 3 letters in a filename. When one of these lines is "selected" (click on it), it becomes the filename extension (or "search mask") for the fileselector. The first part of the fileselector mask is always an asterisk, * , meaning ALL files. This allows specification of displayed directories. o PATHS ----- Below the drives and extenders are 10 lines on which you may enter a specific fileselector path. Merely move the cursor to one of these lines and enter a path using the correct file hierarchical format. ie: C:\AUTO\*.PR? or C:\*.* CLICKing on a blank line will open the fileselector to the currently selected drive and mask (just like selecting the CALL button). Selecting OKAY in the fileselector will enter that path and mask on the current line. Clicking on a line on which a path exists will open a fileselector to the path specified ON that line. ANY selected drive and mask WILL be ignored ! If you wish to change the mask you will need to do so manually. Paths in excess of 32 characters will be trimmed down. The FULL path will, in this scenerio, NOT be saved. Only what appears "on screen" is saved. o CALL ---- When you select the "CALL" button (or hit the key) a fileselector will appear. It will be set to the specified DRIVE and MASK. For example: Select drive button A . Enter the mask ACC on one of the mask lines and click on it (to select it). Select the "CALL" button. A fileselector will open to drive A and display all files ending with the letters ACC . o SAVE ---- Click on the SAVE button. A fileselector will appear, allowing you to locate CARLFSEL.PRG/ACC . Select the proper file and click on OKAY in the fileselector. Your 16 "masks" and 10 "paths" will then be written directly to the program. DO NOT "squish" or "pack" CARLFSEL.PRG/ACC or it will destroy itself when you try to write to it ! o CFSEL_II.PRG ------------ This program/accessory does nothing EXCEPT call the fileselector. I included it in case you were merely interested in calling the fileselector and wanted to save memory. o UNCLEMOUSE SUPPORT ------------------ The file DEFMOUS0.CUR is a custom mouse cursor which can be created with UncleMouse v.1.0a or newer. Rename this file CARLFSEL.CUR and place it in the SAME directory as CARLFSEL.PRG/ACC. As the program is loading it will look for this file. If found, a custom mouse cursor will be loaded and used by the program. Otherwise the program will use its default cursor shape. DEFMOUS0.CUR is a standard GEM arrow. o FREEWARE -------- This program is FREEWARE ! It is NOT public domain. This means that it is still the property of the author. There is, however, no fee to use it. o PECULIARITIES ------------- GEM/TOS doesn't always wait long enough for accessories to initialize. If Carl-Fsel fails to show up in a menu slot, try SHOWing a file from the desktop. This usually allows it to be fully initialized. It runs perfectly with NeoDesk (which allows for the accessory pause) and with MultiDesk (resident or non-resident). If you have a version of TOS with the mouse-doubling bug, an extra click may show up within the fileselector. Whatever was beneath the mouse during the second (bug) click may become selected. For instance, a folder may mysteriously open ! Moving the Carl-Fsel panel out of the fileselectors way will resolve this. o CREDITS ------- Special thanks to Larry D. Duke for a multitude of invaluable assistance over the years ! NeoDesk (C)Gribnif Software CARL-FSEL (C)Carl J. Hafner MultiDesk (C)Codehead Software GEM is (was?) a registered trademark of Digital Research Inc. o DISTRIBUTION ------------ You are free to copy and distribute this program as long as the files... CARLFSEL.PRG / CFSEL_II.PRG / CARLFSEL.TXT / DEFMOUS0.CUR / OTHERTTL.TXT NEWTERMS.TXT are included, are NOT modified in ANY way and NO FEE of ANY type is incurred upon the recipient for the files _themselves_. o HISTORY ------- 1.03 - Calls FSEL from blank line. Adds form_dial. 1.02 - Adds "path" lines. 1.01 - Adds UncleMouse support. Memorizes drive paths. 1.0 - Original version.