* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * HEIDI SEEK * * Version 2.07c * * January 10, 1994 * * (C) Carl J. Hafner - ALL RIGHTS RESERVED * * * * HeidiSeek is a program/accessory which allows you to search your disks * * for ANY file whose location is not readily apparent. Wildcards are * * FULLY supported ! An extensive FILE MAINTENANCE screen allows you to * * manipulate your files in a variety of ways, including a special "STORE" * * feature which acts as a retrievable trashcan ! * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * 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. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - Using this program means that you UNDERSTAND and AGREE with the terms just explained. If you do NOT, DO NOT use this program ! - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - ----------------- TABLE OF CONTENTS ----------------- I. Installing HeidiSeek as a Desk Accessory. Running HeidiSeek as a Program. II. An Overview of the Main Panel. Black Title Box. Copyright Box. Menu Options. \File, Printer, Sound, Warnings, MultiDrive Search, Mouse Snap, Load DAT, Save DAT, Load PRO, Okay String. Drive Buttons. Normal / Hidden. Exit. III. Entering a Search String. Wildcards. Using an asterisk as a wildcard. Using a question mark as a wild card. IV. HeidiSeek Data Files. a) HEIDSEEK.DATa file. Loading/Saving HEIDSEEK.DAT. Creating templates. b) HEIDSEEK.CURsor file. c) HEIDSEEK.PROtect file. Creating a HEIDSEEK.PROtect file. Reloading HEIDSEEK.PRO. V. Status Display. Information on the 1st, 2nd and 3rd lines. Resuming or Aborting a search. VI. Repositioning HeidiSeek. Moving HeidiSeek. Centering and Recalling HeidiSeek positions. Positioning HeidiSeek as a "resident DA". HeidiSeek Resolution Options. VII. File Maintenance. Filename. Source & Destination Drives. - - - - - - - - - - - - - - - - - Read/Write - Read Only - Volume Archive - System - Hidden MultiTos - Stamp - Thrash Folder - Store - Delete FastLoad - TT M-RAM - TT P-RAM - - - - - - - - - - - - - - - - - Additional File Information. Copying & Moving Files. - - - - - - - - - - - - - - - - - Okay - Select - Return - - - - - - - - - - - - - - - - - VIII. Appendix. a) Registration/Distribution/Shareware. b) Credits. c) Version History. d) Running HeidiSeek in different screen resolutions. e) Installing HeidiSeek as an Application. f) Files which HeidiSeek will not delete or alter. g) Deleting Hidden Files. h) HeidiSeek Alerts. i) ProFile! pipeline support. j) Right mouse options k) Troubleshooting I * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * INSTALLING HEIDISEEK AS A DESK ACCESSORY * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * To install HeidiSeek as a normal Desk Accessory (DA), simply copy it to the SAME directory as that in which your other DAs are stored and reset your computer. HeidiSeek will then be accessible from GEMs "Desk" menu. Remember, GEM has a limit of 6 DAs. Any DA you wish loaded should end in ACC . Any DAs you don't wish loaded should end in ACX. HeidiSeek requires at least 108,000 bytes of free memory to run properly. ------------------------------ RUNNING HEIDISEEK AS A PROGRAM ------------------------------ To run HeidiSeek as a program, merely rename the file HEIDSEEK.ACC as HEIDSEEK.PRG and double-click on the name HEIDSEEK.PRG. II * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * OVERVIEW OF THE MAIN HEIDISEEK PANEL * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * When the Main Panel appears you will see the following... * BLACK TITLE BOX --------------- This box will generally display the title "FILE FINDING OPERATIONS", indicating the options of the current screen. As operations are performed this box will display information relevant to the task at hand. The name "ProFile!" will appear at the top of this box if the file PROFILE!.PRG is found in memory. \ COPYRIGHT BOX ------------- Double-clicking on the "black title box" will call up a screen, which, among other things, contains the current COPYRIGHT information. A notice wlll also appear at the bottom of this screen if the file PROFILE!.PRG is found in memory. Click anywhere on this screen to exit. * MENU OPTIONS ------------ Above the "Search String" box is the word "MENU". When you click on the word "MENU" a dropdown menu will appear. From this menu you may select.. \ FILE ---- Clicking on the word "FILE" calls up a panel for file operations. A section on File Maintenance is contained below. \ PRINTER ------- Clicking on the word "PRINTER" enables a printout of the search. When this item is "checked", HeidiSeek will NOT stop after each file has been found. Additionally, a "printout" of the search will list the ENTIRE file path and name (and not just the 3 lines of information which get listed in the "black-box"). You must, of course, initiate a search to get a printout. A printout will NOT occur if this item is NOT "checked". * PAUSE or ABORT PRINTING ----------------------- If you wish for HeidiSeek to pause after each filename has been printed, merely hold down the key while the search is taking place. After a file has been found an alert box will appear. You may then decide an alternate course of action. The key MUST remain pressed if you wish HeidiSeek to pause after each file. The print option is saved to HEIDSEEK.DAT. * PRINTER PORT ------------ Right-clicking on the word "Printer" toggles this menu item between "Printer" port and "Modem" port. If your printer is connected to the printer port, select printer. If your printer is connected to the modem port, select modem (aka: serial). - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - NOTE: Since I do not have access to a serial printer, I cannot guarantee that this option will work properly. If it doesn't, you need merely use the "port redirection" software which came with your printer to re-direct output to the PRINTER port. Be certain to select PRINTER port when using this software. I'd appreciate it if you'd let me know the results, one way or the other. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - The PRINTER/MODEM preference is also saved to HEIDSEEK.DAT. \ SOUND ----- When this item is "checked", HeidiSeek sounds a pleasant alarm for each file it finds. This allows you to "look elsewhere" while HeidiSeek is working. HeidiSeek is merely saying, "excuse me, I found one !" This option is saved to HEIDSEEK.DAT. \ WARNINGS -------- This option enables ALERTS which allow you to abort a destructive procedure, ie: erasing a file. It is probably best to leave this "on". If this option is "off", you will not be warned if you are about to erase (or overwrite) a file. This option is saved to HEIDSEEK.DAT. \ MULTIDRIVE SEARCH ----------------- This option allows you to search any number of drives for a match to your search string. HeidiSeek normally only allows you to select one drive at a time. With this option "on" you may select as many drives as you like. For example, you could select drives "C" and "D", and ask HeidiSeek to search both of these drives for your search string. This option is saved to HEIDSEEK.DAT. NOTE: HeidiSeek "de-selects" a drive button to show that THAT drive is currently being searched. When no further drives are selected, HeidiSeek stops the search and reselects drive "A". If more than one drive is selected when you turn MultiDrive OFF, HeidiSeek, upon exiting the MENU OPTIONS menu, will deselect ALL but the lowest SELECTED drive button. \ MOUSE SNAP ---------- This option enables a feature which memorizes the mouse position when the mouse selects a button which calls a fileselector. In some instances, the mouse position over the fileselector is also memorized. After a file is selected, the mouse cursor is returned to the button which called the fileselector. The cursor will also return to the last selected file position if the fileselector is again called by this button. This saves you the trouble of moving the mouse cursor back and forth between the button and the fileselector. \ LOAD .DAT --------- This option allows you to (re)load a HEIDSEEK.DAT file. \ SAVE .DAT --------- This option allows you to save a HEIDSEEK.DAT file. \ LOAD .PRO --------- This option allows you to (re)load a HEIDSEEK.PRO file. \ OKAY ---- This returns you to the Main Panel with all of your options intact. This item may also be selected with a RIGHT mouse button in the event a left click causes the button below it to become selected. - - - - - - - - - - - SEE ALSO: Appendix j - - - - - - - - - - - * STRING ------ This is the line on which you enter your "Search String". * DRIVE BUTTONS ------------- These are the buttons which allow you to specify which drive(s) to search. To select a DRIVE merely click on an active drive letter (one which is not "grayed out"). If the "MultiDrive" option is DISABLED you will only be able to select ONE drive at a time to search. If the MultiDrive option is ENABLED, you may select as many active drives to search as you wish. HeidiSeek will search any drive which is selected. * NORMAL ------ This button starts the search for files matching your template. Hidden files will not be listed in this search, only files which are visible to the GEM desktop or GEM fileselector. The type of files HeidiSeek considers "normal" are files which have any of the following "file bits" set. READ/WRITE - READ/WRITE/ARCHIVE READ ONLY - READ ONLY/ARCHIVE * HIDDEN ------ This button starts the search for any HIDDEN files which match your search template. "Normal" files WILL NOT appear within this search. You will also have the option of either using your OWN template or having HeidiSeek list ALL hidden files. HeidiSeek will ask you if you wish to "Use Template". If you select "No" HeidiSeek assumes the template "*.*" and searches for ALL hidden files. When HeidiSeek locates a hidden "MATCH", an alert will appear. You will then have the option of RESUMING or ABORTING the search, or "UNHIDING" the hidden file. The "Unhide" option sets the files "flag" to READ/WRITE/ ARCHIVE instead of "???/HIDDEN". The type of files HeidiSeek considers "hidden" are files which have any of the following "file bits" set. READ/WRITE/HIDDEN - READ/WRITE/ARCHIVE/HIDDEN READ/WRITE/SYSTEM - READ/WRITE/ARCHIVE/SYSTEM READ ONLY/HIDDEN - READ ONLY/ARCHIVE/HIDDEN READ ONLY/SYSTEM - READ ONLY/ARCHIVE/SYSTEM VOLUME LABEL In the case of VOLUME LABELS you will ONLY have the option of RESUMING or ABORTING the search. You may use the FILE MAINTENANCE page to alter the VOLUME LABEL. In the case of SYSTEM files, you will have the option of either RESUMING or ABORTING the search, or DELETING the SYSTEM file. It is generally NOT a good idea to delete SYSTEM files unless you are ABSOLUTELY certain of the consequences arising from its deletion. Even though the SYSTEM file may be hidden from GEM, it is NOT hidden from HeidiSeek ! You can still go to the FILE MAINTENANCE page, call up the path of the SYSTEM file, enter it's name on the fileselector line and select OKAY. HeidiSeek will then display this file and its attributes. If you wish, you can temporarily make it visible so that its contents may be viewed from the desktop. Be certain to restore it to SYSTEM status once you're done. - - - - - - - - - - - SEE ALSO: Appendix h - - - - - - - - - - - * EXIT ---- This button allows you to EXIT the HeidiSeek program. III * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * ENTERING A SEARCH STRING * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * When the HeidiSeek panel appears the first thing you will want to do is to enter a "SEARCH STRING". This is the name of the file you are trying to find. The name is entered in the same way you enter a name within the GEM fileselector. * WILDCARDS --------- If you are not sure of the entire name, or if you wish to search for several similar files you can use what are called "wildcards". A wildcard replaces either a "group" of letters OR an individual letter. HeidiSeek supports the wildcards " * " (asterisk), which specifies that blank spaces to the left and/or right of the asterisk (as well as the space occupied by the asterisk) can be ANY _GROUP_ of letters, or " ? " (question mark), which means that ANY filename character may be substituted for the ONE slot in which the question mark is contained. * USING AN ASTERISK AS A WILDCARD ------------------------------- As an example, say you wish to search for all files ending in DAT. You would therefore enter an asterisk, hit the period key, and then enter the letters DAT. The search string would then look like * .DAT . All filenames ending in DAT would then be sought out. * USING A QUESTION MARK AS A WILDCARD ----------------------------------- If you wish to search for filenames of set length, say MIDEX.DR, TIMELOCK.DR, SMPTE.DR etc... (where the extender is always 2 letters long), or filenames in which only individual characters are different, say SNAP1.NEO, SNAP2.NEO, SNAP3.NEO etc... you can use the wildcard "?" as a substitute for the INDIVIDUAL character(s). The search string *.?? would find all of the first files. If you select, say, MIDEX.* , you could end up with MIDEX.DRM, MIDEX.MIX, MIDEX.1 etc... . The search string SNAP?.NEO would find all of the "NEO" files listed above. The search string SNAP*.NEO could turn up things like SNAPSHOT.NEO, SNAPSAVE.NEO etc... . IV * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * HEIDISEEK DATA FILES * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * As HeidiSeek is loading, it looks for 3 seperate files. These files are HEIDSEEK.DAT, HEIDSEEK.CUR and HEIDSEEK.PRO. It is NOT necessary for ANY of these files to be present in order for HeidiSeek to work. If none of these files is found, HeidiSeek uses it's default settings. If you wish to use these files they _MUST_ be present in the SAME file directory as HEIDSEEK.PRG(ACC). * a) HEIDSEEK.DATa file --------------------- This file can contain up to 30 user defined SEARCH TEMPLATES, HeidiSeeks relative SCREEN POSITION at the time this file gets saved, your "MENU" preferences and the last PATH of the loaded or saved .DAT file. LOADING/SAVING HEIDSEEK.DAT --------------------------- Double-clicking on the LEFT arrow calls up a fileselector for LOADING a HEIDSEEK.DAT file. Double-clicking on the RIGHT arrow calls up a fileselector for SAVING a HEIDSEEK.DAT file. You can also select these options from the "MENU" menu. CREATING TEMPLATES ------------------ To create a list of templates, enter a search string and click on an arrow. The template (string) which was on the line when you clicked on the arrow will be assigned to that number slot. When you click on the opposite arrow you will be returned to the template you entered. All user defined slots can then be saved to HEIDSEEK.DAT. * b) HEIDSEEK.CURsor file ----------------------- The .CUR file is a special "user defined mouse CURsor" file. This file can be created with UncleMouse V.1.0a or newer. If this file is found in the SAME directory as HEIDSEEK.ACC/PRG (and is a VALID .CUR file), HeidiSeek will use the mouse cursor shape specified by this file. * c) HEIDSEEK.PROtect file ------------------------ This file you must CREATE YOURSELF using a text editor which is capable of saving in ASCII format. This file can contain the names of up to 30 files which you wish to PROtect from HeidiSeek. HeidiSeek will not alter ANY files listed in HEIDSEEK.PRO. This safety feature is intended to keep you from accidentally modifying an important file. CREATING A HEIDSEEK.PRO FILE ---------------------------- 1) Load your text editor. 2) On the FIRST line, and FLUSH with the left margin, enter the letters HSKPRO and follow it immediately with a carriage return. This line identifies this as a valid PROtect file. 3) Starting FLUSH with the LEFT hand margin on the SECOND line, enter JUST the filename (WITHOUT any drive specifications) of the file you wish protected. DO NOT insert ANY blank spaces. The filename must then be followed IMMEDIATELY by a carriage RETURN. 3) Enter anywhere from 1 to 30 filenames as described in Step 2 on the remaining lines. 4) Save the file in ASCII format. 5) If you feel uneasy or uncertain about the file format you need merely load the enclosed HEIDSEEK.PRO file as a guide. RELOADING HEIDSEEK.PRO ---------------------- This option has been moved to the "MENU" menu mentioned above. V * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * STATUS DISPLAY * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * When HeidiSeek locates a file which MATCHES your search string it will present you with an "ALERT BOX" stating that it has found one. The NAME OF THE FILE will appear within the "BLACK TITLE BOX" at the top of the panel. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - NOTE: If the "Print" option is enabled, the alert box will NOT appear unless you keep the key pressed during the search. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - * INFORMATION ON THE FIRST LINE ----------------------------- The first line in the box will generally be the "ROOT" path of the file. This can be either the drive letter, ie: C:\ , or the name of the folder IN the root drive which contains the file. If the file is an accessory, the first line could be either A:\ or C:\ . If the file is within, say, your AUTO folder, the first line could be A:\AUTO or C:\AUTO . * INFORMATION ON THE SECOND LINE ------------------------------ The second line will contain the PATH DIRECTLY PRECEEDING the file in question. If the file is in the root directory the second line could be something like C:\ . If however, the file is "NESTED" several folders deep, then the second line would be the name of the folder which DIRECTLY PRECEEDS the file being sought. * INFORMATION ON THE THIRD LINE ----------------------------- The third line will contain the NAME OF THE FILE which matches your search string. * EXAMPLE: -------- Say you enter the search string "*.DAT" (or more precisely, "* .DAT"). Say the ONLY file on drive C ending in DAT was nested 3 folders deep... C:\FOLDER1\FOLDER2\FOLDER3\FILE.DAT In this example, HeidiSeek would present you with... C:\ <------the first line. FOLDER3\ <-the second line. FILE.DAT <-the third line. * RESUMIMG or ABORTING SEARCH --------------------------- Click on the RESUME button within the alert box to continue the search or on the ABORT button to end the search. If you select ABORT during the middle of a search, your drive may "whir" for a moment. HeidiSeek is merely resetting itself so that it doesn't begin the next search of that drive at it's current position. * DELETING SEARCH MATCHES ----------------------- Selecting the DELETE button within the alert erases the displayed file. This option has the advantage of allowing you to delete a whole string of similar files. Say you wish to delete ALL backup files on a certain drive. Merely enter the string *.BAK and when the alert appears, select DELETE. VI * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * REPOSITIONING HEIDISEEK * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * MOVING HEIDISEEK ---------------- To change HeidiSeeks current screen position, simply CLICK AND HOLD DOWN the LEFT mouse button OVER the BLACK TITLE BOX. The mouse arrow will change into an "open hand" to indicate that HeidiSeek is ready to be moved. In addition, the HeidiSeek box will be surrounded by a thin outline. As you move the mouse, the "OUTLINE" of HeidiSeek will follow, indicating it's new screen position. When you are satisfied with the new position simply RELEASE the left mouse button. HeidiSeek will then redraw itself at the new screen position. * CENTERING & RECALLING HEIDISEEK POSITIONS ----------------------------------------- Clicking _ONCE_ on the HeidiSeek "parent box" (the main box containing all of HeidiSeek's features) returns the HeidiSeek box to it's saved or stored position. _DOUBLE-CLICKING_ on the same "parent box" centers HeidiSeek on the screen. * POSITIONING HEIDISEEK AS A "RESIDENT" DA. ----------------------------------------- A "Resident DA" is a desk accessory which is "resident" in memory. A normal GEM Desk Accessory is considered a "resident DA". These are desk accessories which are loaded into memory when you first start up your computer. If you are running HeidiSeek as a resident desk accessory, HeidiSeeks initial screen position will be what you specified in it's DAT file. If no DAT file exists, HeidiSeek will merely use it's defaults. When you "EXIT" HeidiSeek, it's screen position _UPON EXITING_ will become the NEW default screen position. The next time you call HeidiSeek from the GEM menu it will draw itself at this NEW position (and NOT at the position stored within HEIDSEEK.DAT). Clicking ONCE on the parent box restores HeidiSeek to this NEW position. * HEIDISEEK RESOLUTION OPTIONS ---------------------------- If you are using HeidiSeek in several different resolutions and wish HeidiSeek to remember the screen location for a particular resolution, be sure to save HEIDSEEK.DAT _IN_ that resolution. HEIDSEEK.DAT can hold the coordinates for ST Low\Medium\High resolution, TT Low\Medium\High resolution and an extra set of coordinates in case you're using a resolution other than these. You DO NOT need to enter the templates for each resolution as this information remains unchanged through resolution changes. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - SEE ALSO: Running HeidiSeek in Different Screen Resolutions - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - VII * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * FILE MAINTENANCE * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * These options work for the most part in the same way as their GEM counterpart. When you click on the word "FILE" on the "Menu" menu a new File Maintenance panel will appear. This panel allows you to modify files on your disks. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - NOTE: The HeidiSeek panel CANNOT be moved when it is in "File Maintenance" mode. The options are... - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - * SOURCE ------ When you click on "SOURCE" a menu will appear from which you can choose your "SOURCE DRIVE". This is the drive which will be used when you "SELECT", "COPY" or "MOVE" files or "LOCATE","CREATE" and "DELETE" VOLUME Labels. All inactive drives will be disabled. The Source Fileselector will open to this drive. This drive will be saved to the HEIDSEEK.DAT file. The next time you load a HEIDSEEK.DAT file the source drive will appear in place of the word "Source". * DESTINATION ----------- When you click on "DESTINATION" a menu will appear from which you can choose your destination drive. This is the destination for files when you are using the "COPY" or "MOVE" option. The Destination Fileselector will open to this drive. This drive will be saved to the HEIDSEEK.DAT file. The next time you load a HEIDSEEK.DAT file the destination drive will appear in place of the word "Destination". NOTE: Changing the source or destination drive from within the fileselector will result in the above source and/or destination drive being changed. * FILENAME -------- This is the name of the SELECTed file. Any changes made to this name will be passed on to the selected file if you click on the OKAY button. Holding down the [CONTROL] key and clicking on the "filename" line enables an option to add extended characters. The extended character will be placed on the right of any name currently being displayed. If you wish for the character to appear elsewhere in the name you will need to enter the name up to the point at which you wish the new character. After entering the extended character you may enter the remainder of the name in the normal way. Extended characters can be anything like ! @ # $ % ^ & * . You can NOT, however, enter the characters : ; " , . / \ . You can even type in [CONTROL] characters, ie: [CONTROL]-A ! * R/W --- This represents READ/WRITE. This option marks a file so that it may be read and written to by your operating system. * READ ONLY --------- This type of file can only be READ. It cannot be written to and cannot (under most circumstances) be deleted. NOTE: READ/WRITE and READ ONLY are "radio buttons", meaning that you may only choose one at a time. "Radio buttons" are comparable to the buttons on a car radio. Pressing a second button makes the first button pop out. * VOLUME ------ This option allows you to either LOCATE,CREATE or DELETE a "volume label" (commonly referred to as a "disk name"). LOCATING A VOLUME LABEL ----------------------- Select a SOURCE drive, the VOLUME button and the SELECT button to search the source drive for a volume label. If one is found, it will appear on the filename line. If none is found, the panel will be reset. CREATING A VOLUME LABEL ----------------------- Select a SOURCE drive, the VOLUME button and enter a NAME on the filename line. Click on the OKAY button to create the volume label. If you have LOCATED a volume label, you may also change its spelling and click on OKAY to rename it. DELETING A VOLUME LABEL ----------------------- First, LOCATE a volume label. Once found, backspace over the name and click on OKAY. HeidiSeek interprets a blank filename as a command to delete the volume label (when the volume button is selected). * ARCHIVE ------- This option allows you to toggle a files "archive bit". The archive bit is used by backup software to determine if a file has been modified since it was last backed up. * SYSTEM ------ This option allows you to toggle a files "system bit", which is used to determine if the file is a "system file". * HIDDEN ------ This option "HIDES" a file from GEM, or more specifically, any application which calls on GEM to display filenames (ie: A GEM window or the GEM fileselector). The file is STILL available to the operating system, it just can't be seen. - - - - - - - - - - - - - - - - - - - - - - NOTE: SYSTEM and HIDDEN are radio buttons. - - - - - - - - - - - - - - - - - - - - - - * MULTITOS -------- Below the "Archive" option you will see a "selected" button labeled either "MULTITOS" or "PRIVATE" (depending on your system). It is selected because one of these flags is ALWAYS set. Clicking on this button calls up a "sub-menu" from which you may select the following MultiTos file options. \SUPER \GLOBAL \PRIVATE \READ ONLY The "selected" button will be changed to reflect the name of the option you have chosen. Selecting the OKAY button on the "File" panel will set this bit. These options are ONLY available for executable files. The MultiTos "Read Only" option IS NOT the same as the one mentioned previously. It WILL NOT set a files bit to the normal "Read Only" status. These options must ALSO be selected with the RIGHT mouse button. - - - - - - - - - - - SEE ALSO: Appendix j - - - - - - - - - - - * STAMP ----- This option sets a files TIME-STAMP (time and date) to the current time and date (or to whatever time and date your clock is set). * THRASH ------ This option completely ZEROES out A FILES CONTENTS before DELETING it. Files erased in this manner CANNOT be recovered. HeidiSeek WILL thrash files even if they are "Read Only". NOTE: HeidiSeek zeroes out EVERY single byte within the file. Therefore, the size of the file will have a direct relationship over the amount of time it takes to thrash a file. In other words, the larger the file, the longer it will take to "zero". - - - - - - - - - - - - - - - - - - - - - - - - - SEE ALSO: Files which HeidiSeek will not delete. SEE ALSO: HEIDSEEK.PRO - - - - - - - - - - - - - - - - - - - - - - - - - * FOLDER ------ Clicking on "FOLDER" calls up a dropdown menu from which you may choose... \INSTALL: Allows you to create a NEW folder. A fileselector will appear. Enter the NEW folder name and click on Okay in the fileselector. A new folder will be created. \DELETE: Allows you to delete an EMPTY folder. A fileselector will appear. Enter the name of an EMPTY folder and click on Okay in the fileselector to delete it. \RENAME: Allows you to rename a folder. This option is only available on machines with TOS 1.4 or newer, which have this capability. A fileselector will appear. Enter the name of the folder which you wish to rename and click on Okay in the fileselector. A second selector will appear. Enter the new name for this folder and click on Okay in the selector to rename it. \CANCEL: Exit this menu with no changes. These items may also be selected with the RIGHT mouse button in the event "left clicking" causes the button below the menu item to become selected. NOTE: Holding down the [CONTROL] key when selecting the "folder" option allows the "filename" (on the top of the panel) to be passed on to the fileselectors used with the folder options. This allows you to create, delete and rename folders using the extended characters mentioned above ! - - - - - - - - - - - SEE ALSO: Appendix j - - - - - - - - - - - * STORE ----- Clicking on "STORE" calls up a dropdown menu from which you can choose... \STORE: Allows you to store a file for later recovery. A fileselector will appear. Select a file to store. HeidiSeek will first HIDE that file. It will then create a folder named HEIDHOLD and place a copy of that FILENAME within the HEIDHOLD folder. The copy will only contain the LOCATION of the STORED file, so it will be very small. \RESTORE: Allows you to RECOVER stored files. A fileselector will appear. Open the HEIDHOLD folder and select the file you wish to recover. HeidiSeek will then "UNHIDE" the original file and DELETE the appropriate "COPY" in the HEIDHOLD folder. \DELETE: Allows you to DELETE STORED FILES and stored file indexes in one fell swoop. A fileselector will appear. Open the HEIDHOLD folder and select the file you wish to DELETE. HeidiSeek will then DELETE the STORED FILE and the stored files INDEX within the HEIDHOLD folder. \CANCEL: EXIT this menu with no changes. These items may also be selected with the RIGHT mouse button. If the storage folder HEIDHOLD contains no files, it will be deleted. - - - - - - - - - - - SEE ALSO: Appendix j - - - - - - - - - - - CAUTION: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - If you delete or modify ANY "stored" files or modify ANY HEIDHOLD copies of the file, HeidiSeek will be UNABLE to recover it. Renaming the HEIDHOLD folder will also result in HeidiSeek not being able to perform it's "storage options" properly. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - * DELETE ------ This option allows you to DELETE a file. This is the same as dragging a file to the GEM trashcan. HeidiSeek WILL delete files, even if they are "Read Only". - - - - - - - - - - - - - - - - - - - - - - - - - SEE ALSO: Files which HeidiSeek will not Delete. SEE ALSO: HEIDSEEK.PRO - - - - - - - - - - - - - - - - - - - - - - - - - * FASTLOAD -------- This option sets an executable files "FASTBIT" (ie: a file ending in PRG, APP, TOS, TTP etc...). This bit ONLY works on machines with TOS 1.4 or newer (since these are the only machines which recognize this option). When this button is selected, the files FastBit, if it is not on already, is turned on. Likewise, it is turned off if this button is NOT selected. If the file is NOT an executable file, this option will be disabled. * TT M-RAM -------- The button "TT MEM" sets an executable files bit so that TT RAM will be allocated whenever this file is run on a TT. * TT P-RAM -------- The button "TT PRG" sets an executable files bit so that the file will be loaded into TT RAM (here again, it only works with a TT). * ADDITIONAL FILE INFORMATION --------------------------- When HeidiSeek loads a file, it reads the first few bytes of the file. If the information at the head of that file matches a pattern which is familiar to HeidiSeek, the name or type of that file will be listed on the top line of the black "title box". * COPY FILE --------- When you select "COPY FILE", a "SOURCE" fileselector will appear from which you will choose the FILE TO COPY. A second "DESTINATION" selector will appear allowing you to set the destination of the file. The file will then be COPIED from Source to Destination. The SOURCE file will then have its "archive bit" turned OFF (since, technically, the copy IS a backup file). The "archive bit" is used to indicate if a file has been backed up since it was last modified. Every time a file is modified, the "archive bit" is turned ON. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - NOTE: This feature will not work unless you have chosen a Source and Destination drive (as described above). - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - * MOVE FILE --------- This option is identical to "COPY FILE" with the exception that the SOURCE FILE will be DELETED after it has been COPIED. The Source file will ONLY be deleted if a successful copy has been made, and the file is NOT listed in HEIDSEEK.PRO . - - - - - - - - - - - - - - - - - - - - - - - - - SEE ALSO: Files which HeidiSeek will not delete. SEE ALSO: HEIDSEEK.PRO - - - - - - - - - - - - - - - - - - - - - - - - - * OKAY ---- Selecting this button EXECUTES any settings made to any SELECTED files. * SELECT ------ Select a SOURCE drive and click on the "SELECT" button. A fileselector will appear from which you may SELECT your FILE. If you select CANCEL within the fileselector, the panel DISPLAY will be CLEARED. * RETURN ------ Click on "RETURN" to return to the Main HeidiSeek Panel. VIII * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * APPENDIX * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * a) REGISTRATION ------------ The following registration terms and fees are subject to change without notice. Any materials which cannot be processed WILL be returned. See the file OTHERTTL.TXT for instructions on obtaining current prices. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - o The suggested registration fee for HeidiSeek is only $15.00 (fifteen U.S. Dollars) plus $3.50* for materials,shipping and handling ($18.50 total). o If you wish, you may include with your registration a floppy disk, a floppy disk mailer and SUFFICIENT U.S. Postage in lieu of the $3.50 materials/shipping/handling fee. o You may register by using the enclosed registration form, or by filling out the necessary information on a piece of paper and sending it to... - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - Carl J. Hafner RR 2, Box 184C Hawley, PA. 18428 U.S.A. ATTN: HeidiSeek - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - SORRY, NO PERSONAL CHECKS ON ORDERS OUTSIDE THE U.S. PLEASE CONVERT FOREIGN CURRENCY TO U.S.DOLLARS BEFORE SENDING. ALL CHECKS WITHIN THE U.S. MUST BE DRAWN ON A U.S. BANK - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - * ORDERS OUTSIDE OF THE U.S. AND CANADA PLEASE ENCLOSE AN EXTRA $1.00 FOR POSTAGE AND HANDLING. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - TERMS OF REGISTRATION --------------------- As a registered user you are required to ensure that NO copies of your licensed version are distributed beyond the realm of yourself or family members. Distributing licensed versions not only cheats the author out of the time and effort put into the development of the program, but also cheats YOU out of the money you have spent to become a licensed owner. Violation of this registration agreement will result in the immediate cancellation of ANY and ALL program registration agreements you may have made with the author. You WILL NOT be eligible for ANY future support or registrations. HeidiSeek is also governed by any and all additional terms mentioned within the file NEWTERMS.TXT. DISTRIBUTION ------------ You are free to copy and distribute the HeidiSeek DEMO as long as the files... HEIDDEMO.PRG - The program/accessory HEIDSEEK.TXT - This text file HEIDIREG.TXT - Registration form HEIDI_UD.TXT - Update form READ_1ST.TXT - Additional program information HEIDSEEK.CUR - HeidiSeek mouse CURsor file HEIDSEEK.PRO - HeidiSeek PROtection file OTHERTTL.TXT - Latest versions NEWTERMS.TXT - Registration terms are included, are NOT modified in ANY way, and NO FEE of any type is incurred upon the recipient for these files _themselves_. SHAREWARE --------- SHAREWARE software is NOT free. Shareware authors retain ALL rights to their software under the FEDERAL COPYRIGHT LAWS and allow distribution of their programs with minimum restrictions. With Shareware software you are given the opportunity to try out the software before you decide whether or not to purchase it. If you DO decide to keep and use the program, you are asked to send in a modest contribution and\or register your copy. You are on your HONOUR not to steal (pirate) the software, (continue using it without paying the author for it). If you receive a SHAREWARE program from a Public Domain or Shareware distributor (or a BBS or similar) you are ONLY paying for their service. You ARE NOT paying for the program itself. The author does not (DOES NOT) receive ANY money from these distributors. I'd also like to take this opportunity to thank the HONEST people out there who have supported the Shareware concept. You have not been forgotten and your support and encouragement is GREATLY appreciated ! b) CREDITS ------- Special thanks to Larry D. Duke for TT compatibility, merging of RSC files and a plethora of other good deeds. ProFile!, Ocultar and HeidiSeek (C)Carl J. Hafner NeoDesk,TRASHCAN.DAT,NeoDesk Recoverable Trashcan (C)Gribnif Software GEM is a trademark of Digital Research MultiDesk & Warp 9 (C)CodeHead Software PINHEAD (C)Little Green Footballs TOS, MultiTos (C) Atari Corporation c) VERSION HISTORY --------------- 2.07c - Extended filename characters. Passing of names from filename line to folder options. "Extra clicks" should no longer occur during mouse snaps. 2.07b - Aesthetic enhancements, HEIDHOLD folder now deleted if empty. 2.07a - Now checks for available memory before installing as an accessory (see the READ ME file). 2.07 - Added TT RAM options, MultiTos support. Moved load/save options on main panel into the menu. Belef compatibility. 2.06b - Added a "work around" to a bug in TOS 1.2. 2.06a - Increased file copy/move speed by 125% ! Removed NEODESK.DAT & TRASHCAN.DAT from internal protection. Added ability to DELETE files within a search. 2.06 - Adds mouse snap feature and file maintenance enhancements. Fixes rare incompatibility problem which would sometimes prevent the "hidden" search from looking beyond the root directory. Search routine completely re-written for greater speed and accuracy. 2.05c - Adds ability to communicate with ProFile! through the GEM pipeline. 2.05b - Aesthetic changes 2.05a - Adds User Mouse and Protect options. Fixes "reload position" positioning. 2.05 - Adds MultiDrive, Print, Warning, File Maintenance options and Install Application. FormDoIt! compatibility. 2.01 - Added call to allow desktop windows to redraw, eliminated "shotgun" sfx. Sound prefs, DAT path and screen position saved to DAT file. 2.0 - Alert boxes now follow the main panel. Extra status displays added to "title box". 30 User definable\savable\loadable templates. Memorization of last screen position. Scrollable templates. Eliminated .RSC file. Rare memory fragmentation bug eliminated. User definable "hidden" templates. TT compatibility. 1.5 - Ability to reposition on screen. Files displayed in panel. 1.0 - Deletion of hidden files. 0.9 - Original version. d) RUNNING HEIDISEEK IN DIFFERENT SCREEN RESOLUTIONS ------------------------------------------------- HeidiSeek checks the current screen resolution against the actual WIDTH and HEIGHT of the screen. If they match, the screen coordinates for that resolution are saved to the appropriate slot. If they DO NOT match, HeidiSeek assumes you are using a large screen emulator and saves the screen coordinates to THAT slot. VALID SCREEN RESOLUTIONS ------------------------ Screen Resolution Width Height ----------------- ----- ------ 0 - ST Low resolution 320 200 1 - ST Medium resolution 640 200 2 - ST High resolution 640 400 3 - not used - 4 - TT Medium resolution 640 480 5 - not used - 6 - TT High resolution 1280 960 7 - TT Low resolution 320 480 HeidiSeek uses the "Line A variables" to determine screen size. It has come to my attention that Atari has neglected to include these on some of the newer machines. I understand that there is a "patch" program available which fixes this problem. If HeidiSeek moves off the screen, won't redraw properly and you have a newer machine, you may need this patch program. e) INSTALLING HEIDISEEK AS AN APPLICATION -------------------------------------- When HeidiSeek is installed as an application, any filename passed to it will be automatically "stored". This includes NeoDesks "Active Icons" option. Please refer to your Atari owners manual for instructions on how to activate the "install application" feature. f) FILES WHICH HEIDISEEK WILL NOT DELETE OR ALTER ---------------------------------------------- The following files will NOT be altered by HeidiSeek due to their sensitive nature. \HEIDHOLD\*.* -> Files in the HEIDHOLD folder can only be RESTORED or "Store deleted". \HEIDHOLD -> The HEIDHOLD folder. HEIDSEEK.PRO -> Files listed in HEIDSEEK.PRO. \FOLDER\*.* -> Any folder which contains files cannot be deleted. g) DELETING HIDDEN FILES --------------------- DO NOT delete ANY hidden files unless you are CAUTION !!! ABSOLUTELY CERTAIN of what you are deleting. Certain programs create hidden files which should ONLY be deleted by the program which created it. ie: NeoDesk (C)Gribnif Software TRASHCAN.DAT files should ONLY be deleted using the NeoDesk Recoverable Trashcan ! Consult any programs documentation for conditions governing the deletion of any such file. ALSO: (and this really has nothing to do with HeidiSeek, but... ) DO NOT reorganize a disk drive without DELETING ALL HIDDEN FILES FIRST ! If you do, then the remaining files may appear as "lost clusters" or "clusters not in files". In most cases they will become inaccessible and will only assist in fragmenting your disk (drive). The obvious solution to this of course is to reformat your disk, not much fun if you have a hard disk. h) HEIDISEEK ALERTS ---------------- HeidiSeek uses special commands to allow it's alert boxes to appear over the HeidiSeek panel. This saves you the trouble of moving the mouse to the center of the screen to respond to an alert. However... Some alerts are called by GEM in response to operating system requests. Alerts like "Drive A is not responding" or "The disk in Drive A is Write Protected" are typical examples. These alerts are called by the operating system (TOS) and not by HeidiSeek. Therefore, these alerts will appear in the center of the screen. I have no control over them. These alerts will only appear if your operating system detects a situation in which you must interact directly with TOS (and not with HeidiSeek). i) PROFILE! PIPELINE SUPPORT ------------------------- HeidiSeek now has the ability to communicate with ProFile! through the special GEM message pipeline. In order for this communication to occur, HeidiSeek MUST BE named HEIDSEEK.ACC , ProFile! MUST BE named PROFILE!.PRG , and BOTH files must be present in memory at the SAME time. If contact HAS been made, the name "ProFile!" will appear on the HeidiSeek "black title box". There will also be a message confirming linkage, on the copyright page. Any messages that are passed will be duly noted under the appropriate heading within this text file. j) RIGHT MOUSE OPTIONS ------------------- To assist in preventing you from inadvertently clicking on an item below a menu option, most menu items are now selectable with the RIGHT mouse button. If a menu item has either more than one option or is only "right-click" selectable, the mouse cursor will become a pointing hand. Another reason for this option is to help compensate for the TOS mouse-doubling bug. If you are using the snap feature you could find the mouse erroneously clicking an additional time, resulting in an unintended selection. Right-mouse clicking ensures that if the mouse DOES click an additional time, it will be a right-click, to which the main buttons will not respond. k) TROUBLESHOOTING --------------- Let's start with the way HeidiSeek works. When HeidiSeek is FIRST run, it takes a "snapshot" of certain memory values within your system. HeidiSeek then restores these values when exited. This allows for shells and accessory stuffers to resume where they left off (in the event they forget to check this information upon exiting the application they called). It is HIGHLY unlikely that HeidiSeek will initiate a crash. In a worst case scenerio, a situation from which HeidiSeek cannot recover, it will simply end. HeidiSeek uses VERY strict error checking. This does NOT, however, guarantee that your system will NEVER crash when using HeidiSeek. It does, however, suggest that something else has caused your system to crash. The most likely culprits are Terminate and Stay Resident (TSR) programs. TSR programs, technically, are supposed to monitor everything they affect when installed. Some programmers take "shortcuts" and only monitor the function they perform, without regard to how their actions affect another program. If a TSR program fails to recognize, adjust to, and/or restore system values, a crash will occur. In the unlikely event that you are experiencing problems with HeidiSeek, 1) Try disabling AUTO programs and then desk accessories to see if there is a conflict. As a shortcut, you can place JUST HeidiSeek on a floppy along with a DESKTOP/NEWDESK.INF file and reboot your system using JUST the floppy. Try to recreate the problem. If you can't, return it to your normal environment and try the procedure mentioned in the first sentence. 2) Check HEIDSEEK.TXT to make sure that you are trying to do something which is documented. 3) If you CAN consistently recreate the problem, note the EXACT conditions and setup under which the problem occurs and let me know. COMMON PROBLEMS --------------- Q) HeidiSeek crashes when installed as an accessory. A) Turn HeidiSeeks fastbit OFF. Remember, the LAST program in your AUTO folder and the FIRST desk accessory to load must ALWAYS have their fastbit turned OFF. This is because TOS expects the memory past where the program load ends to be absolutely clear. If you are using Warp 9s fastload option, place the line HEIDSEEK.ACC F0 within your WARP9.DAT file (to turn the fastload off). If you are using PINHEAD, simply place the name HEIDSEEK.ACC in the PINHEAD.DAT file. HeidiSeek comes with the fastbit turned OFF. It has also been reported that Warp 9 Vs.3.73, 3.74 and 3.75 contain a bug which causes a variety of fastload problems. The recommended fix is to disable fastload completely within Warp 9 and use PINHEAD instead. The problems appear to be most prevalent on machines with TOS 1.0, 1.6 and 1.62. PINHEAD.PRG must also be run AFTER Warp 9 in the AUTO folder. Q) HeidiSeek crashes when run as an MDX from within MultiDesk. A) This is generally caused by an ill-behaved TSR program. Selecting "reload MDXs" from within MultiDesk allows MultiDesk to restore system values so that any MDXs will have accurate information.