@database 080fe9d0-0 @master fitter.guide @$VER: 2.11 @author "Joseph Thomas" @(c) "1995" @help "Main" @remark Created with Heddley v1.1 (c) Edd Dumbill 1994 @node "Main" "Welcome to Fitter" @next "Fitter_Intro" Welcome to __________________________________________ / \ / ____ \ | ( __) _ _ _ | | ( (__ (_) _( )_ _( )_ _____ ____ | | ( __) _ (__ __) (__ __) ( ___ ) ( ___) | | ( ) ( ) ( ) ( ) ( ___) ( ) | | ( ) ( ) ( ) ( ) ( )___ ( ) | | (_) (_) (_) (_) (_____) (_) | \ / \__________________________________________/ Version 2.11 by Joe Thomas See @{"History" link "History" 0} for features/fixes new in this version ! @{u}Introduction@{uu} @{"What is Fitter, and why do I need it?" link "Fitter_Intro" 0} @{"Shareware notice" link "Shareware" 0} @{"Installation" link "Installation" 0} @{"Getting help while online" link "GetStart" 0} @{"Getting Started" link "GetStart" 0} @{u}Using Fitter@{uu} @{b}HOW TO:@{ub} Access all of Fitter's functions. . . . . . . .@{"The Main window" link "MainWin" 0} Set your Fitter preferences . . . . . . . . . .@{"Preferences" link "Prefs" 0} Copy (move) new files to disks. . . . . . . . .@{"Add Files" link "AddFiles" 0} Put your disks (with files already on them) in the catalog. . . . . . . . . . . . . .@{"Add Disks" link "AddDisks" 0} View your catalog, find files in it, and make deletions to it. . . . . . . . . . . .@{"Search & Deletion" link "FilesWin" 0} @{u}Other stuff@{uu} @{"History" link "History" 0} @{"Bugs and contacting the author" link "Bugs" 0} @endnode @node "Fitter_Intro" "What is Fitter, and why do I need it?" @next "Installation" @{b}WHAT IS FITTER?@{ub} Fitter is a program that copies files from one source, most likely your hard drive, to disks, in most likely, your floppy drives. Fitter does this in an automated, optimizing fashion. It also maintains a catalog of the copying you've done, automatically. The rest is fluff (but really good, improved fluff) @{b}WELL, WHY DO I NEED IT?@{ub} Do you browse the net, and in your travels collect loads of music files, pictures, programs, etc., on a regular basis? Do you save FAQs, ASCII manuals, and other textual goodies? If the answer is yes to any of these, you'll need a place to keep them, and unless you have gigs of hard drive space kicking around, eventually you'll need to move the files to disks, where they can be stored for easy, quick retrieval. That's what Fitter will do for you. Why not just use a directory utility, like Directory Opus to accomplish this task? Well, at one time, that's what I was doing, and it was getting monotonous, because: - Copying files one by one to disks never quite worked; there was always wasted space at the end of each disk. - "Now which of these 11 disks did I put that great GIF on? ... Grrr" - It doesn't make sense to use a backup program, because the backup software has to be loaded to extract the file desired from a disk. Also, if the disks are being shared with other users, as in a user group, it can't be assumed that everyone has the same backup software. @endnode @node "Shareware" "Shareware Notice" @next "GetStart" @prev "Installation" @{b}SHAREWARE NOTICE@{ub} @{u}COPYRIGHT@{uu} Copyright "Fitter" and this manual are copyright 1993, 1995 by Joe Thomas. All Rights Reserved. As part of the Fitter V2.11 release, this manual may be used in electronic or printed form along with the Fitter program. Fitter is shareware; you may use, copy, and distribute this archive as you wish as long as the archive remains intact and unchanged. It may not be sold in any form, though a reasonable copying and handling charge is acceptable. @{u}SHAREWARE INFO@{uu} This distribution of Fitter is complete and uncrippled. This means that you may continue to use the same distribuition if you decide to send the required shareware fee. Many, many hours of work were put into developing, fixing, and enhancing Fitter. If you find Fitter useful, and continue to use it, please show your support and appreciation by registering; send $7 (US) to: Joe Thomas 512 Adams St. Apt. 3N Hoboken, NJ 07030 USA Postal money order, cash, or cashier's check is fine (no personal checks, please). Of course, I certainly wouldn't object to a larger fee if you think it's worth it. I beleive this is a more than reasonable fee, considering the current costs of most shareware programs coming out these days, and the conveniences, features and practicality built into Fitter. I'm sure you'll agree that this fee is more than modest after using Fitter a few times. You will also be inspiring me to further enhance Fitter. I simply won't put any effort into improving Fitter if I don't receive any registration fees. Your input of course, is also welcome, good or bad. Besides, now that the Amiga Bankruptcy saga is over, perhaps Escom will give you an incentive to continue using your Amiga, getting more software from the net, and hence need a storage mechanism for it :) @{u}CREDITS@{uu} GUI sources done using GadToolsBox 2.0 GadToolsBox 2.0 is copyright © 1991-93 Jaba Development Fitter icon taken from the MagicWB 2.0 distribution. MagicWB is copyright © 1992-94 Martin Huttenloher. Fitter documentation was written using Heddley. Heddley is copyright © 1992-94 Edd Dumbill. @{u}DISCLAIMER@{uu} The information and the Fitter program are provided "as is" without warranty of any kind, either expressed or implied. Use this program at your own risk. Joe Thomas does not warrant, guarantee, or make any representations regarding the use of, or the results of the use of, the information or the Fitter program in terms of correctness, accuracy, reliability, currentness, or otherwise. In no event will Joe Thomas be liable for direct, indirect, incidental, or consequential damages resulting from any defect in the information or the Fitter program even if he has been advised of the possibility of such damages. @endnode @node "Installation" "Installation" @next "Shareware" @prev "Fitter_Intro" @{b}INSTALLATION@{ub} Although I'm a big advocate for installation standards, like Commodore's Installer program, it's overkill for Fitter. To install, just copy the program, and it's documentation to the directory you wish to run it from. Do this by using the COPY command for each of the files in this archive, or dragging the program and documentation icons to the desired drawer. When you start using Fitter, it will create certain files as they're needed (all in ASCII format): - The Fitter Preferences file - Fitter catalog files. There can be as many of these as you desire; you specify a specific one for use by changing the catalog file @{"preferences" link "PrefsCatname" 0} setting. A Fitter catalog contains the contents (files) of the disks in your catalog, as added using Fitter. Although a Fitter catalog is in an easily readable ASCII format, it is highly recommended that you do not manually modify this file, as Fitter depends on its format. - Add Files session log - Delete Files session log @endnode @node "GetStart" "Getting Started" @next "Main" @prev "Shareware" @{b}GETTING STARTED@{ub} @{u}TO RUN FITTER FROM THE SHELL:@{uu} Just go to the directory you copied it to, and run it by typing "Fitter" . Fitter does not accept any command line arguments. @{u}TO RUN FITTER FROM WORKBENCH:@{uu} Just double click its icon. Fitter currently uses no ToolTypes. @{u}ONLINE AMIGAGUIDE HELP:@{uu} Fitter's amigaguide documentation is now available on line, from the main window, Add Files window, Preferences window, and Search and Deletion window. To use it, you must have Commodore's amiagauide library installed on your machine. To get help on a particular gadget or button, just position the mouse pointer over it, and hit the @{i}Help@{ui} key. @endnode @node "MainWin" "" @next "PathGad" @prev "Main" @{b}MAIN WINDOW@{ub} This is the window that comes up when you first run Fitter. All of Fitter's major functions are initiated from the main window. The main window contains the following gadgets: @{"Source directory path" link "PathGad" 0} @{"Prefs" link "Prefs" 0} @{"List box" link "ListBox" 0} @{"Comment box" link "CommentBox" 0} @{"Add Files buttons" link "AddFiles" 0} @{"Add Disks buttons" link "AddDisks" 0} @{"Search & Deletion" link "SearchDel" 0} @endnode @node "PathGad" "Source directory path gadget" @next "Prefs" @prev "Main" @{b}Source directory path@{ub} gadget This gadget is located above the upper left corner of the large @{"list box" link "ListBox" 0} in the center of the window. Click this gadget to open a file requester, from which you will select the @{i}source directory@{ui} for the files to be "fitted" to disks during an @{"Add Files" link "AddFiles" 0} session. The initial directory the requester starts with is the one specified by the "Default source dir:" setting in your @{"preferences" link "Prefs" 0}. Once this is done, the file list box fills up with a list of the @{i}files@{ui} in that directory. The blank box to the right of the path gadget gets filled in with the path to the directory you selected. @endnode @node "Prefs" "Prefs" @next "ListBox" @prev "PathGad" @{b}Prefs@{ub} The @{i}Prefs@{ui} button opens the Fitter preferences window, where you can customize your setup, and enable or disable different features of Fitter. You can customize settings for the following preferences in Fitter: @{"Catalog name" link "PrefsCatname" 0} @{"Default source directory" link "PrefsSourcedir" 0} @{"Devices" link "PrefsDevices" 0} @{"File system format" link "AddFFilesys" 0} @{"File deletion" link "AddFDel" 0} @{"Disk usage options" link "PrefsDiskUsage" 0} @{"Copy program" link "AddFCopy" 0} @{"Catalog dump options" link "PrefsDump" 0} @endnode @node "ListBox" "List Box" @next "CommentBox" @prev "Prefs" @{b}List box@{ub} This is the large box in the main window. It contains the filenames of the files within the @{i}source directory@{ui} you selected with the @{"source directory path" link "PathGad" 0} @{"gadget" link "PathGad" 0}. Note that you can use the cursor keys to scroll through the list box, in addition to using the mouse. The @{i}up arrow@{ui} and @{i}down arrow@{ui} keys scroll the list up and down, respectively. If you hold down @{i}right shift key@{ui} while using the up and down arrow keys, the list will jump up or down a few items at a time. Note that you must use only the right shift key to do this, because the left shift key, along with just about all other keys on the keyboard, will activate the @{"comment box" link "CommentBox" 0}. @endnode @node "CommentBox" "Comment Box" @next "AddFiles" @prev "ListBox" @{b}Comment box@{ub} This is the text entry box below the @{"list box" link "ListBox" 0}. As you scroll through the files in the list box, each file's AmigaDOS comment appears in the comment box. If you'd like to change the comment for a file, or add a new one, simply make sure the file is selected within the list box, and either click in the Comment box, or hit any key except the cursor keys, right shift key, or help. Press @{i}return@{ui} to permanently make the change to the file. The comment box accepts all cursor movement and text modification keys available at an AmigaDOS prompt (i.e. @{i}Ctrl-K@{ui}=erase to end of line, @{i}Ctrl-E@{ui}=move to end of line, etc.) @endnode @node "AddFiles" "Add Files buttons" @next "AddDisks" @prev "CommentBox" @{b}Add Files@{ub} and @{b}Add Files (new)@{ub} Starts the Fitter @{"Add Files" link "AddFWin" 0} function. This is the part of Fitter that does the file "fitting". The files in the directory you selected in the @{"list box" link "ListBox" 0} will be copied to the disks in your catalog, and to any new disks needed. @{i}Add Files (new)@{ui} performs the same function as @{i}Add Files@{ui}, except that it will create a new Fitter catalog if it's the first time you're using Fitter, or overwrite the current catalog (with your confirmation) if you already have a catalog. Neither of these buttons are available until a directory containing files has been selected with the @{"source directory path" link "PathGad" 0} gadget, and the Add Files@{ui} button isn't avaliable unless you already have a catalog. If you opt to use disks already existing in your catalog to copy new files to, The Add Files procedure will only use disks that are currently marked as writeable (see documentation on the @{"Write enable flag" link "FilesWriteable" 0} in the Files & Deletion window). @endnode @node "AddDisks" "Add Disks buttons" @next "SearchDel" @prev "AddFiles" @{b}Add Disks@{ub} and @{b}Add Disks (new)@{ub} Starts the Fitter @{"disk adding function" link "AddDDesc" 0}. Use this when you have disks that contained files prior to your using Fitter, and you'd like to make them part of your Fitter catalog. @{i}Add Disks (new)@{ui} performs the same function as @{i}Add Disks@{ui}, except that it will create a new Fitter catalog if it's the first time you're using Fitter, or overwrite the current catalog (with your confirmation) if you already have a catalog. @endnode @node "SearchDel" "Search & Deletion" @prev "AddDisks" @{b}Search & Deletion@{ub} This opens the @{"Search & Deletion" link "FilesWin" 0} window. From here you can: - Interactively scan the contents of your catalog - Use the search function to find out which disks certain files are on - Delete files and/or disks from your catalog - Scan the contents of your disks, and automatically verify whether or not the contents are consistent with your catalog. @endnode @node "PrefsCatname" "Catalog name" @next "PrefsSourcedir" @{b}Catalog name@{ub} Specify here the name of your Fitter catalog. What you enter here is also used as a prefix for: - The @{"Add Files" link "AddFDesc" 0} progress log filename - The @{"Delete Files" link "FilesDelete" 0} progress log filename - The volume labels written to disks you add to your catalog The catalog file and progress log files are created and accessed in the same directory Fitter was run from. The path gadget to the right of this text box can optionally be used to select an existing Fitter catalog by opening a file requester. @endnode @node "PrefsSourcedir" "Default source directory" @next "PrefsDevices" @prev "PrefsCatname" @{b}Default source dir@{ub} Click here and enter the full path to the directory you'd like to specify as the initial directory in the file requester that pops up by using the @{"Source" link "PathGad" 0} @{"dir path" link "PathGad" 0} gadget in the @{"Main window" link "MainWin" 0}. If you have one directory that you will be fitting files from on a regular basis, here's where you specify it. Mine, for instance, is "Work:downloads". @endnode @node "PrefsDevices" "Fitter devices" @next "PrefsSave" @prev "PrefsUseDisks" @{b}Drive devices@{ub} It's possible for you to specify up to four devices you'd like Fitter to use for its disk functionality. These default to DF0: through DF3:. A check in the box next to them indicates that Fitter is allowed to use the device. To change the device names, click in the device boxes, and edit in the name of a different device. @endnode @node "PrefsDiskUsage" "Disk usage preferences" @next "PrefsDump" @prev "PrefsDevices" @{b}Disk Usage Options@{ub} The disk usage gadget is used to tell Fitter how you want the @{"Add Files" link "AddFiles" 0} procedure to ask for disks: @{u}No new disks@{uu} This setting tells Fitter that Add Files should only try to use the space available on the disks currently in your catlog. Since this space may be very limited, it's very likely that the Add Files session will end without having copied all files from the source directory. The most obvious use for this setting is when you don't have any spare disks handy to format and copy new files to. @{u}New disks only@{uu} This setting tells Fitter that Add Files should not ask you to insert any disks already in your catalog, to copy more files to. This option is useful in a situation where you don't have your catalog disks handy, but do have new disks you can format. @{u}Old & New disks@{uu} If this option is being used, Add Files will try utilizing all space available on writeable disks in your catalog, and when no more space is available, you will be prompted for new disks to format and copy files to as needed. This is the most common disk usage setting. @endnode @node "PrefsDump" "Catalog Dump Options" @next "PrefsSave" @prev "PrefsDiskUsage" @{b}Dump Catalog / Dump preferences@{ub} Fitter has a catalog dumping feature, which allows you to generate an ASCII dump of your catalog contents. To use this feature, you must select the Dump option from the @{i}Project menu@{ui}, available only from the Fitter @{i}Main window@{ui}. A requester will pop up, asking you to give the path and name of the file you want to dump to. That's all there is to it. The dump will be appear different, depending on how your catalog dump options are set, in your preferences. You may select a dump sorted by name (alphabetical), disk (similar to but simpler than your catalog file), or file size (size order). You can control whether or not each file's comment is displayed along with the file by checking or unchecking comment flag. NOTE: This option is selectable only via the main menu. @endnode @node "PrefsSave" "Use, save, or cancel" @prev "PrefsDevices" @{b}Use / Save / Cancel@{ub} As with standard Amiga Prefs programs, these buttons imply that you wish to @{i}Use@{ui} your current preferences for this Fitter session, @{i}Save@{ui} your preferences to disk while also using them for this Fitter session, or @{i}Cancel@{ui} any changes you made to your preferences while in the preferences window. @endnode @node "AddFWin" "The Add Files Window" @next "AddFDriveSel" @{b}ADD FILES@{ub} The @{i}Add Files@{ui} function is the heart of Fitter. All "fitting" of new files to disks in your Fitter catalog is done here. Before the @{i}Add Files@{ui} window appears, you will get a warning requester, alerting you to remove any disks that might be in the drives you selected in your @{"preferences" link "PrefsDevices" 0} for use, as a precaution to prevent against erasing information on a disk that may be in one of these drives. All you need to do at this point is follow the instructions that Fitter gives you. All progress during an @{i}Add Files@{ui} session is recorded in a file called @{i}.log@{ui}, in the directory that Fitter is being run from. It's a good idea to be familiar with how Fitter copies files to new disks, and disks already in your catalog. This procedure has been greatly enhanced from earlier versions of Fitter. Following is a description of the way that Fitter uses the disks in your selected drives (your selected drives are the drives you have specified to be used in your preferences, i.e. DF0: - DF3:). For each disk, whether being formatted new, or already part of your catalog, Fitter uses your selected drives in the order that they exist in your preference settings, for up to four drives. A "cycle" consists of each selected drive being used in turn, until the last drive is used. Then a new cycle begins. For example, if your selected drives are DF0:, DF2:, and DF3:, a cycle consists of using DF0:, then DF2:, then DF3:. Depending on which of the three @{i}disk usage option@{ui}s you have selected in your preferences, Fitter will ask you to either insert disks already in your catalog for the new files, ask for new disks to format, or end the Add Files session without having copied all files from the source directory. See the section on @{"disk usage options" link "PrefsDiskUsage" 0} in preferences for an explanation. As of V2.1, Fitter allows you to give your disks any volume label you wish, @{i}after@{ui} disk added to your catalog. Since a disk that is about to be formatted usually doesn't have a meaningful label, Add Files always gives the disk a default label when formatting a new disk, in the form . For instance, the 43rd disk to be formatted for the catalog named my_catalog would be given the disk label my_catalog43. Fitter will always try to copy as many files as possible to a disk already in one of your drives before going to another one. As a convenience, Fitter will use the disks in each drive in a cycle automatically, when formatting new disks. In the example, this would allow you to insert new disks in drives DF0:, DF2:, and DF3:. Fitter would automatically format each disk and copy files to it, without needing your interaction, for the whole @{i}cycle@{ui}. While this is a convenience, it is potentially dangerous if you did not heed the instructions given before the Add Files session started (@{i}remove disks from selected drives@{ui}); Fitter will indiscriminantly format a disk in the current drive, unless the disk in the drive is a member of your catalog. The Add Files procedure in Fitter has undergone a complete overhaul from V1.1, and works much more conveniently and efficiently now. Fitter will always try to use catalog disks that are already in a drive when trying to fit files, to eliminate needless disk swapping. NOTE: During a file copy, if an error occurs, you have the option of Formatting a new disk, or aborting the Add Files session. If you choose to format a new disk, the files copied to the disk up until the error occured will be re-copied to the next disk, unless the @{i}Delete files when finished@{ui} @{"flag" link "FilesDelete" 0} is set, in which case the files will already have been deleted from the source directory. This is an important shortcoming to keep in mind if you choose to utilize the convenience of automatic file deletetion. Currently, there is no safegaurd against this; Fitter will try to copy files that were on the error disk again, and complain that it can't find them in the source directory. @endnode @node "AddFDriveSel" "Add Files Drive selection" @next "AddFInDrives" @prev "AddFWin" @{b}Drive Enabled checkboxes@{ub} Use these checkboxes to enable or disable a drive within the @{i}Add Files@{ui} drive cycle. A checked box means the corresponding drive can be used by Fitter during the AddFiles session. As with all usable gadgets in the Add Files window, this checkbox can be toggled on the fly, but it will not come into effect until Fitter is done with the current disk. This enabling/disabling of drives can be a great convenience if you're running Fitter while using another application that needs to use one or more of your floppy drives. Just toggle those drive(s) off in Fitter while the other app needs them, and then back on when the app is done. @endnode @node "AddFInDrives" "Add Files " @next "AddFCopy" @prev "AddFDriveSel" @{b}Disk number boxes@{ub} The boxes to the right of the boxes containing the drives to be used by Fitter contain the number of the catalog disk each drive. If no catalog disk or a non Fitter catalog disk is in a drive, the number box for that drive will be blank. These boxes are strictly informational. @endnode @node "AddFCopy" "Add Files Copy program" @next "AddFFilesys" @prev "AddFInDrives" @{b}Copy Method@{ub} Use the @{i}Copy Method@{ui} preferences setting, or the @{i}Copy Method@{ui} gadget in the @{i}Add Files@{ui} window on the fly to choose between using AmigaDOS' COPY command to copy files to disks, or the copying routine built into Fitter. Fitter is set to use Fitter's copy by default. There is no significant advantage using AmigaDOS copy, but this option was left in for the sake of any compatibility issue that may arise for different devices, which couldn't be tested by the author. Here are the advantages for using Fitter's copy: - A copy @{"progress indicatior" link "AddFSys" 0}, in the form of % completed. - The ability to @{"abort" link "AddFAbort" 0} at any time; using AmigaDOS copy, you must wait until the current copy is finished. - @{i}Add Files@{ui} settings can be changed on the fly during a copy - @{"Amigaguide online help" link "GetStart" 0} is always available (via the Help key), rather than only being available when an entire file copy is finished. - During testing, AmigaDOS copy occasionally encountered errors during copying, which oddly gave a meaningless AmigaDOS error code of 20. Such have never occured when testing with Fitter's copy. @endnode @node "AddFFilesys" "File system format" @next "AddFDel" @prev "AddFCopy" @{b}File System (FFS/OFS)@{ub} This setting, whose default you can specify in @{"preferences" link "Prefs" 0}, or on the fly during an @{i}Add Files@{ui} session simply specifies what kind of file system Fitter should expect to see when a catalog disk is inserted, and what kind of file system to format a new disk with. @endnode @node "AddFDel" "Delete files when finished setting" @next "AddFDisk" @prev "AddFFilesys" @{b}File Deletion@{ub} This setting appears as @{i}File deletion@{ui} in preferences, and as and as @{i}Delete files when finished@{ui} during an @{i}Add Files@{ui} session. If the box is checked for this setting, Fitter will delete each file from the source directory after it has been successfully copied to a disk. When enabled, this feature eliminates the manual task of having to keep track of and manually delete files you've fitted to disks. The overall effect is "moving" files to disks. @endnode @node "AddFDisk" "Disk number box" @next "AddFSys" @prev "AddFDel" @{b}Disk box@{ub} The AddFiles disk box simply contains the number of the disk it is currently formatting or copying files to. @endnode @node "AddFSys" "Progress status line" @next "AddFAbort" @prev "AddFDisk" @{b}System status line@{ub} This status line reports what's currently going on in the @{i}Add File@{ui}s session. The status line also contains the % completed progress indicator, when the @{"Fitter copy setting" link "AddFCopy" 0} is being used. @endnode @node "AddFAbort" "Abort Add Files" @prev "AddFSys" @{b}Abort Add Files@{ub} As the name implies, you can use this button to interrupt an @{i}Add Files@{ui} session, and abort it. When aborting, you have three options: 1. @{i}Update and abort@{ui}: This option implies that Fitter should rewrite your catalog, reflecting all the new files that were copied so far during the Add Files session, keeping the catalog in sync with your disks. 2. @{i}Pretend this session didn't happen@{ui}: As it implies, this instructs Fitter to leave your catalog alone, acting as if any files copied to disks never happened. If you decide later that you want these changes reflected in your catalog, you can do this by using the @{"Add Disks" link "AddFDisk" 0} function for new disks, and Rescan (in the @{"Files & Deletion" link "FilesWin" 0} window) for disks in your catalog that had new files copied to them. 3. @{i}Cancel Abort@{ui}: Continue as if you didn't hit the Abort button. @endnode @node "AddDWin" "The Add Disks WIndow" @next "AddDDesc" @{b}The Add Disks Window@{ub} The Add Disks window appears simply for disk labeling purposes. In the "Last" section, for each drive, is displayed the volume label given to the disk in that drive, AFTER the disk was read and added to your catalog. When you remove a disk from a drive, look at the entry for that drive in the "Last" section to determine what to label to physically write on the disk. In the "Next" section, for each drive, is what the disk's label will be changed to once you have inserted a disk, and the disk's directory is read. @endnode @node "AddDDesc" "The Add Disks Procedure" @prev "AddDWin" @{b}THE ADD DISKS WINDOW@{ub} General operation When either of the two @{i}Add Disks@{ui} options are selected from the @{"Main window" link "MainWin" 0}, the Add Disks window will open, along with the Add Disks requester. This is the part of Fitter that adds the contents (file list) of disks you have that have not yet been introduced to Fitter. Your interaction during the Add Disks function is strictly using one requester, with three options: @{u}Finished@{uu}: Select this button when you are finished adding disks to the catalog. Upon selecting this button, the current catalog will be updated with all the disks you have added. @{u}OK@{uu}: Select this button when the disk you wish to be catalogued is in the drive that the requester specifies. You will not likely need to use this button, because Fitter will detect when you have inserted the disk to catalog, and immediately start reading it. As of V2.1, Fitter no longer needs to relabel your disks as you add them. You may leave them write protected. Fitter will record the volume name on the disk, and refer to it when asks you to insert it in other parts of Fitter. @{u}Abort@{uu}: Use this button if you decide that you would like to cancel all the disks you have added since selecting the Add Disks function from the @{i}Main window@{ui}. The catalog will not be updated with the new disks. @{u}Use of floppy drives during the Add Disks function@{uu} The drives that are used during the Add Disks function are those that are selected in @{"preferences" link "PrefsDevices" 0}. The floppy drives you wish to use must be set in the Preferences window before using Add Disks (select either @{i}Use@{ui} or @{i}Save@{ui} from the Preferences Window). As a convenience, the ability to use multiple drives is provided. This means that for every "cycle" of disks to be catalogued, the disks may be inserted in the drives in sequence so that Fitter reads them automatically without your having to respond when going to the next selected drive. In fact, be aware that this WILL happen for every disk already in a selected drive for each cycle. For example, let's say that you have DF0:, DF2:, and DF3: selected in the Preferences window. When you first start the Add Disks function, Fitter will ask you to insert a disk in drive DF0: to be catalogued. Fitter will wait until you either put a disk in drive DF0: (and only DF0:), or select @{i}OK@{ui} when there is already a disk in that drive. After reading that disk, Fitter will automatically read the disks in drives DF2: and DF3:, in that order, without bringing up the requester, if there are already disks in those drives. If a drive does not have a disk in it, Fitter will ask you to insert one in that drive. The requester will ALWAYS come up for each first drive in the "round", which in this example is DF0:. @endnode @node "FilesWin" "The Search & Deletion Window" @next "FilesSelec" @{b}Files & Deletion Window@{ub} From this window, you can: - Interactively examine the contents of your disk catalog. - Search for files in your catalog. - Delete files from your disks. - Delete disks from your catalog. - Rescan individual disks to check for inconsistencies with your catalog. This window contains the following gadgets: @{"Disk navigation gadgets" link "FilesDiskNav" 0} @{"File selection buttons" link "FilesSelec" 0} @{"Selection scope" link "FilesScope" 0} @{"Disk contents box" link "FilesDisk" 0} @{"Rescan" link "FileDiscrep" 0} @{"Delete Now" link "FilesDelete" 0} @{"Space left" link "FilesSpace" 0} @{"Files Find string" link "FilesFind" 0} @{"Search gadgets" link "FilesFind" 0} @{"Mark pattern" link "FilesMarkPat" 0} @{"Volume label" link "FilesVolume" 0} @{"Disk writaeatble flag" link "FilesVolume" 0} @endnode @node "FilesSelec" "File selection gadgets" @next "FilesScope" @prev "FilesWin" @{b}File selection buttons@{ub} Below the @{i}disk navigation gadgets@{ui} are the @{i}file selection buttons@{ui}. These gadgets are used to select and unselect files on disks to be deleted. Whether or not the buttons affect the current displayed disk, or the whole catalog depends on the @{"selection scope" link "FilesScope" 0}. @{i}All@{ui} - Select all files on the current disk for deletion (thereby deleting the disk itself), or all the files in the whole catalog. @{i}None@{ui} - Unselect all files on the current disk that are selected for deletion or all the files in the whole catalog. @{i}Invert@{ui} - Select all files on the current disk (or the whole catalog) that are currently unselected, and vice versa. @endnode @node "FilesScope" "Selection scope gadget" @next "FilesDiskNav" @prev "FilesSelec" @{b}Selection scope@{ub} Near the lower left corner of the @{i}Files & deletion@{ui} window is the @{i}selection scope@{ui} gadget. The setting for this gadget affects the scope of the file @{"selection buttons" link "FilesSelec" 0}; it causes those buttons to either affect either the current disk displayed, or the whole catalog of disks. @endnode @node "FilesDiskNav" "The disk navigation gadgets" @next "FilesDelete" @prev "FilesScope" @{b}Disk Navigation Gadgets@{ub} The cluster of gadgets: Number box, + and - buttons, and slider gadget in the upper left corner of the @{i}Files & Deletion Window@{ui} make up the @{i}disk navigation gadget@{ui}s. Use these gadgets to select a disk whose contents will appear in the @{"disk" link "FilesDisk" 0} @{"contents box" link "FilesDisk" 0}. The number box contains the number of the catalog disk you're looking at, and can be used to change the disk number by clicking in the box, and typing the number in. The + and - buttons increment and decrement the disk number by 1, respectively. These are best used to fine adjust the number. The slider gadget is a coarse adjustment for the disk number. Note that the @{"cursor keys" link "FilesDisk" 0} can be used to navigate through the disks and their contents. @endnode @node "FilesDelete" "Delete now button" @next "FilesDisk" @prev "FilesDiskNav" @{b}Delete now@{ub} This button is the "go ahead" button for the @{i}files deletion@{ui} process. When you click it, the @{"disk contents box" link "FilesDisk" 0} is filled with all the disks numbers and file names on them that you selected for deletion by clicking in the disk contents box, using the @{"file selection gadgets" link "FilesSelec" 0}, or by using the @{"Mark pattern button" link "FilesMarkPat" 0}. After confirming your decision to start the deletion by answering the requester that appears, Fitter prompts you for the disks to insert, after which it will delete the files you selected, both from the disk, and your catalog. Obviously, the disks must be un-write protected. If you selected all the files on any one disk to be deleted, Fitter will not ask you to insert the disk; it will just remove the disk from the catalog. Note that a @{"disk rescanning" link "FileDiscrep" 0} is done automatically when Fitter is finished deleting all the selected files on a disk, to make sure that what's in your catalog reflects the disk's contents. @endnode @node "FilesDisk" "The disk contents box" @next "FilesSpace" @prev "FilesDelete" @{b}Disk contents@{ub} The box in the center of the @{i}Files & deletion@{ui} window is the @{i}disk contents box@{ui}. It is here that the contents of the current disk are displayed. Each file is displayed, along with its last modification date, size in bytes, and file comment, if it exists. You can select files that will be deleted by the @{"Delete now" link "FilesDelete" 0} @{"button" link "FilesDelete" 0} simply clicking on them. Unselect a file by clicking on it again. A selected file has an asterisk (*) just left of it. Along with the slider at the right side of the box, the cursor keys can be used to navigate through the currently displayed disk in the disk contents box: @{i}Cursor Left/Right@{ui} goes ahead to the next disk in the catalog, or back to the last disk in the catalog. @{i}Cursor Up/Dow@{ui}n moves the highlight (file selected) within the disk contents box. Holding down the @{i}Right Shift key@{ui} while using @{i}cursor Up/Down@{ui} moves within the disk contents box a few items at a time. You can also use the spacebar to toggle the selection of the current file within the disk contents box. Any other key (except the @{i}Help key@{ui}) activates the @{"Find string box" link "FilesFind" 0}. @endnode @node "FilesSpace" "Disk space available box" @next "FilesFind" @prev "FilesDisk" @{b}Space left@{ub} This line tells you how many @{i}blocks@{ui} are left on the disk currently displayed. Blocks are used here, rather than bytes, because the way Fitter determines space availability during an Add Files session is by extracting the blocks available on an inserted disk. @endnode @node "FilesFind" "The Files Find string" @next "FilesMarkPat" @prev "FilesSpace" @{b}Search gadgets@{ub} With the box at the bottom of the screen, you can specify a @{i}search string@{ui} to find the location of files within your catalog. To do this, simply click in the box (or type any key except the @{i}cursor@{ui}, @{i}space@{ui}, @{i}Help@{ui} and @{i}right shift@{ui} keys), and enter your search string. The setting of the @{i}Name@{ui}, @{i}Date@{ui}, and/or @{i}Comment@{ui} checkboxes, if checked means that a search will include those respective parts of the file information to match against for your search. For instance, if you have the @{i}Date@{ui} and @{i}Comment@{ui} boxes checked, but the @{i}Name@{ui} box unchecked, Fitter will try to match what you typed in the Find box against file comments and date strings, but not file names. @{i}Match case@{ui}, when checked, simply means that the text you typed as a search string must match against file information, and the case of the letters must match too. Unchecked, this box means that every search is case insensitive. When a match is found, the disk containing the matching file becomes the current disk, and it's contents are displayed in the disk contents box, with the matching file highlighted. When there are at least two matches in the catalog matching your search criterion, you can use the next and previous match buttons (+/-) next to the search string. Use + to go to the next file matching your criterion, and - to a match that is earlier in the catalog. The search will "wrap around" the catalog if there are no more matches until the end, or beginning of the catalog. @endnode @node "FilesMarkPat" "Mark pattern" @next "FileDiscrep" @prev "FilesFind" @{b}Mark pattern@{ub} The @{i}Mark pattern@{ui} button is used in conjunction with the @{"search gadgets" link "FilesFind" 0}, and @{"scope gadget" link "FilesScope" 0} to select files for deletion, if their information matches the pattern given in the @{"Find box" link "FilesFind" 0}. The rules for pattern matching are the same rules used to find a file using the @{i}search gadgets@{ui}. There are no special characters in the Find box that have a special meaning. After clicking the @{i}Mark pattern@{ui} button, all the files on the current disk, or files on any disks in the catalog that have information matching your search criterion are marked for deletion. This feature can be useful to get rid of certain kinds of files on the disks in your catalog. For instance, if you wanted to free a lot of disk space on your disks by getting rid of all the large DMS files on them, you could specify ".dms" in your search string, and have only the @{"Name checkbox gadget" link "FilesFind" 0} checked.@{i} A word of caution:@{ui} Since a search pattern matches against @{i}any@{ui} part of the information it's being compared against, attention must be paid to the pattern specified. In the above example, files ending in .dms would be matched, but filenames containing ".dms" would also be matched, as in something like "my_appication.dmsetting". @endnode @node "FileDiscrep" "Catalog descrepancy checking feature" @next "FilesWriteable" @prev "FilesMarkPat" @{b}Catalog Discrepancy Checking@{ub} Fitter has a feature that checks the listing of files on one of your catalogued disks against your catalog. This feature is activated by using the @{i}Rescan Disk@{ui} feature in the @{"Files and Deletion window" link "FilesWin" 0}, and it also happens automatically during an Add Files session. In the Files & deletion window, @{i}Rescan disk@{ui} operates on the current disk displayed in the @{"disk contents box" link "FilesDisk" 0}. Its purpose is to notify you when the listing of files on a disk, and the list in your catalog do not match. When this happens, Fitter will report both the Files that exist on your disk that are not listed in your catalog, and vice versa. This feature is useful in that it will always let you know if any new files were copied, or files were deleted from a catalog disk, outside of Fitter. After the discrepancy has been reported, your catalog is always updated to reflect the contents of the disk. @endnode @node "FilesWriteable" "Make disk writeable flag" @next "Volume" @prev "FileDiscrep" @{b}Disk writeable flag@{ub} This flag is in the form of a check box, and correlates to the disk currently being displayed in the @{"disk contents box" link "FilesDisk" 0}. This means that each disk your catalog will have its own setting for this flag. When the box is checked for any given disk, it signifies that Add Files can use the disk for copying new files to, as it needs. If the box is not checked, Add Files will never ask for this disk. This flag, new in V2.1, allows you the flexiblity of selecting which disks Fitter can write to. This is most useful when you've added write protected disks in an Add Disks session, just for the sake of recording their contents, and you don't want them touched. @endnode @node "FilesVolume" "Volume label gadget" @prev "FilesWriteable" @{b}Volume label / Rename Gadget@{ub} The text box at the top of the Search & Deletion window is the @{i}volume label gadget@{ui}. The name in this box is the disk volume label of the disk currently being displayed in the @{"disk contents box" link "FilesDisk" 0}. It changes as the disk in the disk contents box changes. It can also be used to physically rename any given disk's volume label. To do this, simply select the disk desired using the disk navigation gadgets, and click in the volume label gadget. Type in the new label you want to use. You will then be prompted to insert the given disk into any available drive to physically relabel the disk. You may cancel at this point, if you wish. When finished, this change is reflected both on the disk and in your catalog. @endnode @node "History" "History / New Features" @{b}HISTORY@{ub} Major versions: 8-2-95 : V2.11 (Maintenance release) @{u}BUG FIXES:@{uu} -Disk numbering in catalog dumps was off by one in all output execpt for "by disk" listings. This has been fixed. -Fitter now accepts disk labels from *really* old FitterV1.x catalogs, where disks were always named "Archives_Disk_##", whenever a catalog disk is requested. -For filenames listed in the Main Window list box, and for disk catalog dumps, names are now sorted in their proper lexicographic order. Before, the sorts were ASCII sorts, causing the list to be split in two different groups (all upper case followed by all lower case) 5-31-95 : V2.10 @{u}NEW FEATURES:@{uu} -@{"Disk usage options" link "PrefsDiskUsage" 0} (in Preferences): This controls how fitter decides to use new and existing catalog disks during an Add Files session. -@{"Disk writeable flag" link "FilesWriteable" 0} (in Files & Deletion): This is a flag that can be toggled for each disk in a catalog. It determines whether a disk can be written to (copied to) or not during an Add Files session. -Menus available from the main window. This gives the user access to all the high level functions available in Fitter, and provides standard menu keyboard shortcuts for these. -Free form disk lableling and @{"disk renaming function" link "FilesVolume" 0}. Fitter no longer needs to rename disks in order to add them to the catalog. It will keep an internal disk number, along with a volume label, for each disk. This allows a user to add a write protected disk to the catalog using the Add Disks function. -@{"Catalog dumping" link "PrefsDump" 0} to ASCII feature (from Main window menu): An ASCII dump of the current Fitter catalog can be generated, sorting by filename, filesize, or by disk, optionally with each file's comment. -File deletions now happen at the end of each disk, rather than after each copy, thereby eliminating the possibility of deleting files from the source directory before a problem occurs while copying files to a disk. -Informational enhancements @{u}BUG FIXES:@{uu} -Now properly reads V1.X Fitter catalogs. -Amigaguide help request routines rewritten properly. This eliminates the Enforcer hits found in V2.0. -Now handles absolute paths properly (for catalog files, dump files, etc.) 3-4-95 : V2.00 -Add Files routine completely rewritten. Fitting now happens on the fly, instead of creating a fitting list before the session starts. Files "fitted" dynamically. Many aspects of Add Files were enhanced for better usability and reliability. -A copy program was written for Fitter internally. A choice between using this one and AmigaDOS COPY is always available. Fitter's copy has a % completed indicator, and can be interrupted at any time. -An Add Files progress log is maintained for Add Files sessions. -Many parts of the Add Files routine enhanced for better convenience and reliability. -Disk formatting now spawns a CON: window showing the progress of the format. -Fitter preferences modified according to the new changes in Fitter. -Gadgets now properly ghosted where appropriate in the Main window. -Entire new window/feature: the Search and Deletion window (this also replaces the search function). -Disk scanning feature that compares disk contents to catalog contents. -Online Amigaguide help added. 2-20-94 : V1.01 Minor improvements: -Comment gadget now refreshes (clears) after an Add Files session. -Drives not available now ghosted out in Preferences and Add Files windows -Path is now remembered for each subsequent use of the path gadget. -Small (one second) delay is now used between the time between a disk is inserted and when it is accessed during the Add Files session. This *MAY* fix a problem reported by some people wherein Fitter looked at every disk as if it was unformatted. 12-18-93 : V1.00 Fitter V1.0 has been developed on a 68030 based Amiga 1200, and tested mainly on the same machine. Throughout this testing, no Enforcer hits were found. -Since near the beginning of this project, there has been a gadget refresh problem that I suspect happens on WB 3.x based systems. The path text gadget and size information gadget do not get "wiped clean" when new information is displayed in them, like the other gadgets. After much frustration, and questions to many people, an answer could not be found for this problem. The program was developed on an A1200 using D.I.C.E., and so the author is one of those who will be living with this annoyance, until an answer is found. @endnode @node "Bugs" "Bug reports" @{b}BUGS@{ub} It's simple: I cant fix them if I don't know about them. In the past, I only found out about bugs by explicitly asking users if they'd been seeing any. During the author's testing, no enforcer hits were found. Extra note: Fitter V2.X does not support Amigaguide V39.X on Workbench 2.X machines. If you wish to use Amigaguide help on such a machine (and avoid crashes), you must obtain amigaguide.library V34.X. This is available on Aminet, in the Amigaguide development package archive. If you discover a bug while using Fitter, please contact me via internet email at: benjamin@ritz.mordor.com or via the postal service: Joe Thomas 512 Adams St. Apt. 3N Hoboken, NJ 07030 USA Please feel free to contact me also if you have any suggestions to enhance Fitter further. @endnode