home *** CD-ROM | disk | FTP | other *** search
/ Meeting Pearls 3 / Meeting_Pearls_III.iso / Pearls / disk / Misc / Fitter / Fitter.doc < prev    next >
Text File  |  1995-08-02  |  44KB  |  1,254 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.                                  080fe9d0-0
  7.  
  8.  
  9.                                    Version
  10.                                     2.11
  11.  
  12.  
  13.  
  14.  
  15.                                 Joseph Thomas
  16.  
  17.  
  18.  
  19.                                     1995
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.                          Generated with Heddley v1.1
  37.                       Heddley v1.1 (C) Edd Dumbill 1994
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76.                                  - Page 1 -
  77.  
  78.  
  79.  
  80. 1.    Welcome to Fitter
  81.  
  82.                    Welcome to
  83.  
  84.        __________________________________________
  85.       /                                          \
  86.      /   ____                                     \
  87.      |  (  __)  _     _       _                   |
  88.      |  ( (__  (_)  _( )_   _( )_   _____   ____  |
  89.      |  (  __)  _  (__ __) (__ __) ( ___ ) ( ___) |
  90.      |  ( )    ( )   ( )     ( )   (  ___) ( )    |
  91.      |  ( )    ( )   ( )     ( )   ( )___  ( )    |
  92.      |  (_)    (_)   (_)     (_)   (_____) (_)    |
  93.      \                                            /
  94.       \__________________________________________/
  95.  
  96.                             Version 2.11
  97.  
  98.                                  by Joe Thomas
  99.  
  100.  
  101.         See History for features/fixes new in this version !
  102.  
  103.  
  104. Introduction
  105.         What is Fitter, and why do I need it?
  106.         Shareware notice
  107.         Installation
  108.         Getting help while online
  109.         Getting Started
  110.  
  111.  
  112. Using Fitter                                  
  113.                     HOW TO:
  114.         Access all of Fitter's functions. . . . . . . .The Main window
  115.  
  116.         Set your Fitter preferences . . . . . . . . . .Preferences
  117.  
  118.         Copy (move) new files to disks. . . . . . . . .Add Files
  119.  
  120.         Put your disks (with files already on
  121.         them) in the catalog. . . . . . . . . . . . . .Add Disks
  122.  
  123.         View your catalog, find files in it,
  124.         and make deletions to it. . . . . . . . . . . .Search & Deletion
  125.  
  126. Other stuff
  127.         History
  128.         Bugs and contacting the author
  129.  
  130. 2.    What is Fitter, and why do I need it?
  131.  
  132. WHAT IS FITTER?
  133.  
  134. Fitter is a program that copies files from one source, most likely your hard
  135. drive, to disks, in most likely, your floppy drives.  Fitter does this in an
  136. automated, optimizing fashion.  It also maintains a catalog of the copying
  137. you've done, automatically.
  138.  
  139. The rest is fluff (but really good, improved fluff)
  140.  
  141.  
  142. WELL, WHY DO I NEED IT?
  143.  
  144. Do you browse the net, and in your travels collect loads of music files,
  145. pictures, programs,  etc., on a regular basis?  Do you save FAQs, ASCII
  146.  
  147.                                  - Page 2 -
  148. 2.    What is Fitter, and why do I need it?
  149.  
  150. manuals, and other textual goodies?  If the answer is yes to any of these,
  151. you'll need a place to keep them, and unless you have gigs of hard drive
  152. space kicking around, eventually you'll need to move the files to disks,
  153. where they can be stored for easy, quick retrieval.  That's what Fitter will
  154. do for you.
  155.  
  156. Why not just use a directory utility, like Directory Opus to accomplish this
  157. task?  Well, at one time, that's what I was doing, and it was getting
  158. monotonous, because:
  159.  
  160. - Copying files one by one to disks never quite worked; there was always
  161. wasted space at the end of each disk.
  162.  
  163. - "Now which of these 11 disks did I put that great GIF on? ... Grrr"
  164.  
  165. - It doesn't make sense to use a backup program, because the backup software
  166. has to be loaded to extract the file desired from a disk.  Also, if the disks
  167. are being shared with other users, as in a user group, it can't be assumed
  168. that everyone has the same backup software.
  169.  
  170. 3.    Shareware Notice
  171.  
  172. SHAREWARE NOTICE
  173.  
  174.  
  175. COPYRIGHT
  176.  
  177. Copyright "Fitter" and this manual  are copyright 1993, 1995 by Joe Thomas.
  178. All Rights Reserved.  As part of the Fitter V2.11 release, this manual may be
  179. used in electronic or printed  form  along  with the Fitter program.
  180.  
  181. Fitter is shareware; you may use, copy, and distribute this archive as you
  182. wish as long as the archive remains intact and unchanged. It may not be sold
  183. in any form, though a reasonable copying and handling charge is acceptable.
  184.  
  185. SHAREWARE INFO
  186.  
  187. This distribution of Fitter is complete and uncrippled.  This means that you
  188. may continue to use the same distribuition if you decide to send the required
  189. shareware fee.  
  190.  
  191. Many, many hours of work were put into developing, fixing, and enhancing
  192. Fitter.  If you find Fitter useful, and continue to use it, please show your
  193. support and appreciation by registering; send $7 (US) to:
  194.  
  195.         Joe Thomas
  196.         512 Adams St. Apt. 3N
  197.         Hoboken, NJ 07030
  198.         USA
  199.  
  200. Postal money order, cash, or cashier's check  is fine (no personal checks,
  201. please).  Of course, I certainly wouldn't object to a larger fee if you think
  202. it's worth it.
  203.  
  204. I beleive this is a more than reasonable fee, considering the current costs
  205. of most shareware programs coming out these days, and the conveniences,
  206. features and practicality built into Fitter.  I'm sure you'll agree that this
  207. fee is more than modest after using Fitter a few times.
  208.  
  209. You will also be inspiring me to further enhance Fitter.  I simply won't put
  210. any effort into improving Fitter if I don't receive any registration fees.
  211. Your input of course, is also welcome, good or bad.
  212.  
  213. Besides, now that the Amiga Bankruptcy saga is over, perhaps Escom will give
  214. you an incentive to continue using your Amiga, getting more software from the
  215. net, and hence need a storage mechanism for it :)
  216.  
  217.  
  218.                                  - Page 3 -
  219. 3.    Shareware Notice
  220.  
  221. CREDITS
  222.  
  223.         GUI sources done using GadToolsBox 2.0
  224.         GadToolsBox 2.0 is copyright © 1991-93 Jaba Development
  225.  
  226.         Fitter icon taken from the MagicWB 2.0 distribution.
  227.         MagicWB is copyright © 1992-94 Martin Huttenloher.
  228.  
  229.         Fitter documentation was written using Heddley.
  230.         Heddley is copyright © 1992-94 Edd Dumbill.
  231.  
  232.  
  233. DISCLAIMER 
  234.  
  235. The information and the Fitter program are provided "as is" without warranty
  236. of  any  kind, either expressed or implied.  Use this program at your own
  237. risk.  Joe Thomas does not warrant, guarantee, or make any representations
  238. regarding the use of, or the results of the use of, the information or the
  239. Fitter program  in terms of correctness, accuracy, reliability, currentness,
  240. or otherwise.  In no event will Joe Thomas be liable for direct, indirect,
  241. incidental, or consequential damages resulting from any defect in the
  242. information or the Fitter program even if he has been advised of the
  243. possibility of such damages.
  244.  
  245. 4.    Installation
  246.  
  247. INSTALLATION
  248.  
  249. Although I'm a big advocate for installation standards, like Commodore's
  250. Installer program, it's overkill for Fitter.
  251.  
  252. To install, just copy the program, and it's documentation to the directory
  253. you wish to run it from.
  254.  
  255. Do this by using the COPY command for each of the files in this archive, or
  256. dragging the program and documentation icons to the desired drawer.
  257.  
  258.  
  259. When you start using Fitter, it will create certain files as they're needed
  260. (all in ASCII format):
  261.  
  262. - The Fitter Preferences file
  263.  
  264. - Fitter catalog files.  There can be as many of these as you desire; you
  265. specify a specific one for use by changing the catalog file preferences
  266. setting.  A Fitter catalog contains the contents (files) of the disks in your
  267. catalog, as added using Fitter.  Although a Fitter catalog is in an easily
  268. readable ASCII format, it is highly recommended that you do not manually
  269. modify this file, as Fitter depends on its format.
  270.  
  271. - Add Files session log
  272.  
  273. - Delete Files session log
  274.  
  275. 5.    Getting Started
  276.  
  277. GETTING STARTED
  278.  
  279. TO RUN FITTER FROM THE SHELL:
  280.  
  281. Just go to the directory you copied it to, and run it by typing "Fitter"
  282. <enter>.  Fitter does not accept any command line arguments.
  283.  
  284.  
  285. TO RUN FITTER FROM WORKBENCH:
  286.  
  287. Just double click its icon.  Fitter currently uses no ToolTypes.
  288.  
  289.                                  - Page 4 -
  290. 5.    Getting Started
  291.  
  292.  
  293.  
  294.  
  295. ONLINE AMIGAGUIDE HELP:
  296.  
  297. Fitter's amigaguide documentation is now available on line, from the main
  298. window,  Add Files window, Preferences window, and Search and Deletion
  299. window.  To use it, you must have Commodore's amiagauide library installed on
  300. your machine.
  301.  
  302. To get help on a particular gadget or button, just position the mouse pointer
  303. over it, and hit the Help key.
  304.  
  305. 6.    
  306.  
  307. MAIN WINDOW
  308.  
  309. This is the window that comes up when you first run Fitter.  All of Fitter's
  310. major functions are initiated from the main window.
  311.  
  312. The main window contains the following gadgets:
  313.  
  314.         Source directory path
  315.         Prefs
  316.         List box
  317.         Comment box
  318.         Add Files buttons
  319.         Add Disks buttons
  320.         Search & Deletion
  321.  
  322. 7.    Source directory path gadget
  323.  
  324. Source directory path gadget
  325.  
  326. This gadget is located above the upper left corner of the large list box in
  327. the center of the window.  Click this gadget to open a file requester, from
  328. which you will select the source directory for the files to be "fitted" to
  329. disks during an Add Files session. The initial directory the requester starts
  330. with is the one specified by the "Default source dir:" setting in your
  331. preferences.  Once this is done, the file list box fills up with a list of
  332. the files in that directory.  The blank box to the right of the path gadget
  333. gets filled in with the path to the directory you selected.
  334.  
  335. 8.    Prefs
  336.  
  337. Prefs
  338.  
  339. The Prefs button opens the Fitter preferences window, where you can customize
  340. your setup, and enable or disable different features of Fitter.
  341.  
  342. You can customize settings for the following preferences in Fitter:
  343.  
  344.         Catalog name
  345.         Default source directory
  346.         Devices
  347.         File system format
  348.         File deletion
  349.         Disk usage options
  350.         Copy program
  351.         Catalog dump options
  352.  
  353. 9.    List Box
  354.  
  355. List box
  356.  
  357. This is the large box in the main window.  It contains the filenames of the
  358. files within the source directory you selected with the source directory path
  359.  
  360.                                  - Page 5 -
  361. 9.    List Box
  362.  
  363. gadget.
  364.  
  365. Note that you can use the cursor keys to scroll through the list box, in
  366. addition to using the mouse.  The up arrow and down arrow keys scroll the
  367. list up and down, respectively.  If you hold down right shift key while using
  368. the up and down arrow keys, the list will jump up or down a few items at a
  369. time.  Note that you must use only the right shift key to do this, because
  370. the left shift key, along with just about all other keys on the keyboard,
  371. will activate the comment box.
  372.  
  373. 10.    Comment Box
  374.  
  375. Comment box
  376.  
  377. This is the text entry box below the list box.  As you scroll through the
  378. files in the list box, each file's AmigaDOS comment appears in the comment
  379. box.  If you'd like to change the comment for a file, or add a new one,
  380. simply make sure the file is selected within the list box, and either click
  381. in the Comment box, or hit any key except the cursor keys, right shift key,
  382. or help. 
  383.  
  384. Press return to permanently make the change to the file.  The comment box
  385. accepts all cursor movement and text modification keys available at an
  386. AmigaDOS prompt (i.e. Ctrl-K=erase to end of line, Ctrl-E=move to end of
  387. line, etc.)
  388.  
  389. 11.    Add Files buttons
  390.  
  391. Add Files and Add Files (new)
  392.  
  393. Starts the Fitter Add Files function.  This is the part of Fitter that does
  394. the file "fitting".  The files in the directory you selected in the list box
  395. will be copied to the disks in your catalog, and to any new disks needed.
  396.  
  397.  
  398. Add Files (new) performs the same function as Add Files, except that it will
  399. create a new Fitter catalog if it's the first time you're using Fitter, or
  400. overwrite the current catalog (with your confirmation) if you already have a
  401. catalog. Neither of these buttons are available until a directory containing
  402. files has been selected with the source directory path gadget, and the Add
  403. Files button isn't avaliable unless you already have a catalog.
  404.  
  405. If you opt to use disks already existing in your catalog to copy new files
  406. to, The Add Files procedure will only use disks that are currently marked as
  407. writeable (see documentation on the Write enable flag in the Files & Deletion
  408. window).
  409.  
  410. 12.    Add Disks buttons
  411.  
  412. Add Disks and Add Disks (new)
  413.  
  414. Starts the Fitter disk adding function.  Use this when you have disks that
  415. contained files prior to your using Fitter, and you'd like to make them part
  416. of your Fitter catalog.
  417.  
  418. Add Disks (new) performs the same function as Add Disks, except that it will
  419. create a new Fitter catalog if it's the first time you're using Fitter, or
  420. overwrite the current catalog (with your confirmation) if you already have a
  421. catalog.
  422.  
  423. 13.    Search & Deletion
  424.  
  425. Search & Deletion
  426.  
  427. This opens the Search & Deletion window. From here you can:
  428.  
  429.         - Interactively scan the contents of your catalog
  430.  
  431.                                  - Page 6 -
  432. 13.    Search & Deletion
  433.  
  434.  
  435.         - Use the search function to find out which disks
  436.           certain files are on
  437.  
  438.         - Delete files and/or disks from your catalog
  439.  
  440.         - Scan the contents of your disks, and automatically
  441.           verify whether or not the contents are consistent
  442.           with your catalog.
  443.  
  444. 14.    Catalog name
  445.  
  446. Catalog name
  447.  
  448. Specify here the name of your Fitter catalog.  What you enter here is also
  449. used as a prefix for:
  450.  
  451. - The Add Files progress log filename 
  452.  
  453. - The Delete Files progress log filename 
  454.  
  455. - The volume labels written to disks you add to your catalog
  456.  
  457. The catalog file and progress log files are created and accessed in the same
  458. directory Fitter was run from.
  459.  
  460. The path gadget to the right of this text box can optionally be used to
  461. select an existing Fitter catalog by opening a file requester.
  462.  
  463. 15.    Default source directory
  464.  
  465. Default source dir
  466.  
  467. Click here and enter the full path to the directory you'd like to specify as
  468. the initial directory in the file requester that pops up by using the Source
  469. dir path gadget in the Main window.
  470.  
  471. If you have one directory that you will be fitting files from on a regular
  472. basis, here's where you specify it.  Mine, for instance, is "Work:downloads".
  473.  
  474. 16.    Fitter devices
  475.  
  476. Drive devices
  477.  
  478. It's possible for you to specify up to four devices you'd like Fitter to use
  479. for its disk functionality.  These default to DF0: through DF3:.
  480.  
  481. A check in the box next to them indicates that Fitter is allowed to use the
  482. device.
  483.  
  484. To change the device names, click in the device boxes, and edit in the name
  485. of a different device.
  486.  
  487. 17.    Disk usage preferences
  488.  
  489. Disk Usage Options
  490.  
  491. The disk usage gadget is used to tell Fitter how you want the Add Files
  492. procedure to ask for disks:
  493.  
  494.  
  495. No new disks
  496.  
  497. This setting tells Fitter that Add Files should only try to use the space
  498. available on the disks currently in your catlog.  Since this space may be
  499. very limited, it's very likely that the Add Files session will end without
  500. having copied all files from the source directory. The most obvious use for
  501.  
  502.                                  - Page 7 -
  503. 17.    Disk usage preferences
  504.  
  505. this setting is when you don't have any spare disks handy to format and copy
  506. new files to.
  507.  
  508. New disks only
  509.  
  510. This setting tells Fitter that Add Files should not ask you to insert any
  511. disks already in your catalog, to copy more files to.  This option is useful
  512. in a situation where you don't have your catalog disks handy, but do have new
  513. disks you can format.
  514.  
  515. Old & New disks
  516.  
  517. If this option is being used, Add Files will try utilizing all space
  518. available on writeable disks in your catalog, and when no more space is
  519. available, you will be prompted for new disks to format and copy files to as
  520. needed.  This is the most common disk usage setting.
  521.  
  522. 18.    Catalog Dump Options
  523.  
  524. Dump Catalog / Dump preferences
  525.  
  526. Fitter has a catalog dumping feature, which allows you to generate an ASCII
  527. dump of your catalog contents.
  528.  
  529. To use this feature, you must select the Dump option from the Project menu,
  530. available only from the Fitter Main window.  A requester will pop up, asking
  531. you to give the path and name of the file you want to dump to.  That's all
  532. there is to it.
  533.  
  534. The dump will be appear different, depending on how your catalog dump options
  535. are set, in your preferences.  You may select a dump sorted by name
  536. (alphabetical), disk (similar to but simpler than your catalog file), or file
  537. size (size order).
  538.  
  539. You can control whether or not each file's comment is displayed along with
  540. the file by checking or unchecking comment flag.
  541.  
  542. NOTE: This option is selectable only via the main menu.
  543.  
  544. 19.    Use, save, or cancel
  545.  
  546. Use / Save / Cancel
  547.  
  548. As with standard Amiga Prefs programs, these buttons imply that you wish to
  549. Use your current preferences for this Fitter session, Save your preferences
  550. to disk while also using them for this Fitter session, or Cancel any changes
  551. you made to your preferences while in the preferences window.
  552.  
  553. 20.    The Add Files Window
  554.  
  555. ADD FILES
  556.  
  557. The Add Files function is the heart of Fitter.  All "fitting" of new files to
  558. disks in your Fitter catalog is done here.  Before the Add Files window
  559. appears, you will get a warning requester, alerting you to remove any disks
  560. that might be in the drives you selected in your preferences for use, as a
  561. precaution to prevent against erasing information on a disk that may be in
  562. one of these drives.
  563.  
  564. All you need to do at this point is follow the instructions that Fitter gives
  565. you.
  566.  
  567. All progress during an Add Files session is recorded in a file called <your
  568. catalog name>.log, in the directory that Fitter is being run from.
  569.  
  570. It's a good idea to be familiar with how Fitter copies files to new disks,
  571. and disks already in your catalog.  This procedure has been greatly enhanced
  572.  
  573.                                  - Page 8 -
  574. 20.    The Add Files Window
  575.  
  576. from earlier versions of Fitter.
  577.  
  578. Following is a description of the way that Fitter uses the disks in your
  579. selected drives (your selected drives are the drives you have specified to be
  580. used in your preferences, i.e. DF0: - DF3:).
  581.  
  582.  
  583. For each disk, whether being formatted new, or already part of your catalog,
  584. Fitter uses your selected drives in the order that they exist in your
  585. preference settings, for up to four drives.  A "cycle" consists of each
  586. selected drive being used in turn, until the last drive is used.  Then a new
  587. cycle begins.  For example, if your selected drives are DF0:, DF2:, and DF3:,
  588. a cycle consists of using DF0:, then DF2:, then DF3:.
  589.  
  590. Depending on which of the three disk usage options you have selected in your
  591. preferences, Fitter will ask you to either insert disks already in your
  592. catalog for the new files, ask for new disks to format, or end the Add Files
  593. session without having copied all files from the source directory.  See the
  594. section on disk usage options in preferences for an explanation.
  595.  
  596. As of V2.1, Fitter allows you to give your disks any volume label you wish,
  597. after disk added to your catalog.  Since a disk that is about to be formatted
  598. usually doesn't have a meaningful label, Add Files always gives the disk a
  599. default label when formatting a  new disk, in the form <catalog name><catalog
  600. disk number>.  For instance, the 43rd disk to be formatted for the catalog
  601. named my_catalog would be given the disk label my_catalog43.
  602.  
  603. Fitter will always try to copy as many files as possible to a disk already in
  604. one of your drives before going to another one.
  605.  
  606. As a convenience, Fitter will use the disks in each drive in a cycle
  607. automatically, when formatting new disks.  In the example, this would allow
  608. you to insert new disks in drives DF0:, DF2:, and DF3:.  Fitter would
  609. automatically format each disk and copy files to it, without needing your
  610. interaction, for the whole cycle.
  611.  
  612. While this is a convenience, it is potentially dangerous if you did not heed
  613. the instructions given before the Add Files session started (remove disks
  614. from selected drives); Fitter will indiscriminantly format a disk in the
  615. current drive, unless the disk in the drive is a member of your catalog.
  616.  
  617. The Add Files procedure in Fitter has undergone a complete overhaul from
  618. V1.1, and works much more conveniently and efficiently now. Fitter will
  619. always try to use catalog disks that are already in a drive when trying to
  620. fit files, to eliminate needless disk swapping.
  621.  
  622. NOTE: During a file copy, if an error occurs, you have the option of
  623. Formatting a new disk, or aborting the Add Files session.  If you choose to
  624. format a new disk, the files copied to the disk up until the error occured
  625. will be re-copied to the next disk, unless the Delete files when finished
  626. flag is set, in which case the files will already have been deleted from the
  627. source directory.  This is an important shortcoming to keep in mind if you
  628. choose to utilize the convenience of automatic file deletetion.
  629.  
  630. Currently, there is no safegaurd against this; Fitter will try to copy files
  631. that were on the error disk again, and complain that it can't find them in
  632. the source directory.
  633.  
  634. 21.    Add Files Drive selection
  635.  
  636. Drive Enabled checkboxes
  637.  
  638. Use these checkboxes to enable or disable a drive within the Add Files drive
  639. cycle.  A checked box means the corresponding drive can be used by Fitter
  640. during the AddFiles session.  As with all usable gadgets in the Add Files
  641. window, this checkbox can be toggled on the fly, but it will not come into
  642. effect until Fitter is done with the current disk.
  643.  
  644.                                  - Page 9 -
  645. 21.    Add Files Drive selection
  646.  
  647.  
  648. This enabling/disabling of drives can be a great convenience if you're
  649. running Fitter while using another application that needs to use one or more
  650. of your floppy drives.  Just toggle those drive(s) off in Fitter while the
  651. other app needs them, and then back on when the app is done.
  652.  
  653. 22.    Add Files 
  654.  
  655. Disk number boxes
  656.  
  657. The boxes to the right of the boxes containing the drives to be used by
  658. Fitter contain the number of the catalog disk each drive.  If no catalog disk
  659. or a non Fitter catalog disk is in a drive, the number box for that drive
  660. will be blank.
  661.  
  662. These boxes are strictly informational.
  663.  
  664. 23.    Add Files Copy program
  665.  
  666. Copy Method
  667.  
  668. Use the Copy Method preferences setting, or the Copy Method gadget in the Add
  669. Files window on the fly to choose between using AmigaDOS' COPY command to
  670. copy files to disks, or the copying routine built into Fitter.
  671.  
  672. Fitter is set to use Fitter's copy by default.  There is no significant
  673. advantage using AmigaDOS copy, but this option was left in for the sake of
  674. any compatibility issue that may arise for different devices, which couldn't
  675. be tested by the author.
  676.  
  677. Here are the advantages for using Fitter's copy:
  678.  
  679. - A copy progress indicatior, in the form of % completed.
  680.  
  681. - The ability to abort at any time; using AmigaDOS copy, you must wait until
  682. the current copy is finished.
  683.  
  684. - Add Files settings can be changed on the fly during a copy
  685.  
  686. - Amigaguide online help is always available (via the Help key), rather than
  687. only being available when an entire file copy is finished.
  688.  
  689. - During testing, AmigaDOS copy occasionally encountered errors during
  690. copying, which oddly gave a meaningless AmigaDOS error code of 20. Such have
  691. never occured when testing with Fitter's copy.
  692.  
  693. 24.    File system format
  694.  
  695. File System (FFS/OFS)
  696.  
  697. This setting, whose default you can specify in preferences, or on the fly
  698. during an Add Files session simply specifies what kind of file system Fitter
  699. should expect to see when a catalog disk is inserted, and what kind of file
  700. system to format a new disk with.
  701.  
  702. 25.    Delete files when finished setting
  703.  
  704. File Deletion
  705.  
  706. This setting appears as File deletion in preferences, and as and as Delete
  707. files when finished during an Add Files session.  If the box is checked for
  708. this setting, Fitter will delete each file from the source directory after it
  709. has been successfully copied to a disk.
  710.  
  711. When enabled, this feature eliminates the manual task of having to keep track
  712. of and manually delete files you've fitted to disks.  The overall effect is
  713. "moving" files to disks.
  714.  
  715.                                  - Page 10 -
  716. 25.    Delete files when finished setting
  717.  
  718.  
  719. 26.    Disk number box
  720.  
  721. Disk box
  722.  
  723. The AddFiles disk box simply contains the number of the disk it is currently
  724. formatting or copying files to.
  725.  
  726. 27.    Progress status line
  727.  
  728. System status line
  729.  
  730. This status line reports what's currently going on in the Add Files session.
  731. The status line also contains the % completed progress indicator, when the
  732. Fitter copy setting is being used.
  733.  
  734. 28.    Abort Add Files
  735.  
  736. Abort Add Files
  737.  
  738. As the name implies, you can use this button to interrupt an Add Files
  739. session, and abort it.  When aborting, you have three options:
  740.  
  741. 1. Update and abort: This option implies that Fitter should rewrite your
  742. catalog, reflecting all the new files that were copied so far during the Add
  743. Files session, keeping the catalog in sync with your disks.
  744.  
  745. 2. Pretend this session didn't happen: As it implies, this instructs Fitter
  746. to leave your catalog alone, acting as if any files copied to disks never
  747. happened.  If you decide later that you want these changes reflected in your
  748. catalog, you can do this by using the Add Disks function for new disks, and
  749. Rescan (in the Files & Deletion window) for disks in your catalog that had
  750. new files copied to them.
  751.  
  752. 3. Cancel Abort: Continue as if you didn't hit the Abort button.
  753.  
  754. 29.    The Add Disks WIndow
  755.  
  756. The Add Disks Window 
  757.  
  758. The Add Disks window appears simply for disk labeling purposes. In the "Last"
  759. section, for each drive, is displayed the volume label given to the disk in
  760. that drive, AFTER the disk was read and added to your catalog. When you
  761. remove a disk from a drive, look at the entry for that drive in the "Last"
  762. section to determine what to label to physically write on the disk.
  763.  
  764. In the "Next" section, for each drive, is what the disk's label will be
  765. changed to once you have inserted a disk, and the disk's directory is read.
  766.  
  767. 30.    The Add Disks Procedure
  768.  
  769. THE ADD DISKS WINDOW
  770.  
  771. General operation
  772.  
  773. When either of the two Add Disks options are selected from the Main window,
  774. the Add Disks window will open, along with the Add Disks requester.  This is
  775. the part of Fitter that adds the contents (file list) of disks you have that
  776. have not yet been introduced to Fitter. Your interaction during the Add Disks
  777. function is strictly using one requester, with three options:
  778.  
  779. Finished: Select this button when you are finished adding disks to the
  780. catalog.  Upon selecting this button, the current catalog will be updated
  781. with all the disks you have added.
  782.  
  783. OK: Select this button when the disk you wish to be catalogued is in the
  784. drive that the requester specifies.  You will not likely need to use this
  785.  
  786.                                  - Page 11 -
  787. 30.    The Add Disks Procedure
  788.  
  789. button, because Fitter will detect when you have inserted the disk to
  790. catalog, and immediately start reading it.
  791.  
  792. As of V2.1, Fitter no longer needs to relabel your disks as you add them. You
  793. may leave them write protected.  Fitter will record the volume name on the
  794. disk, and refer to it when asks you to insert it in other parts of Fitter.
  795.  
  796. Abort: Use this button if you decide that you would like to cancel all the
  797. disks you have added since selecting the Add Disks function from the Main
  798. window. The catalog will not be updated with the new disks.
  799.  
  800.  
  801. Use of floppy drives during the Add Disks function
  802.  
  803. The drives that are used during the Add Disks function are those that are
  804. selected in preferences.  The floppy drives you wish to use must be set in
  805. the Preferences window before using Add Disks (select either Use or Save from
  806. the Preferences Window).
  807.  
  808. As a convenience, the ability to use multiple drives is provided. This means
  809. that for every "cycle" of disks to be catalogued, the disks may be inserted
  810. in the drives in sequence so that Fitter reads them automatically without
  811. your having to respond when going to the next selected drive.  In fact, be
  812. aware that this WILL happen for every disk already in a selected drive for
  813. each cycle.
  814.  
  815. For example, let's say that you have DF0:, DF2:, and DF3: selected in the
  816. Preferences window.  When you first start the Add Disks function, Fitter will
  817. ask you to insert a disk in drive DF0: to be catalogued.  Fitter will wait
  818. until you either put a disk in drive DF0: (and only DF0:), or select OK when
  819. there is already a disk in that drive.  After reading that disk, Fitter will
  820. automatically read the disks in drives DF2: and DF3:, in that order, without
  821. bringing up the requester, if there are already disks in those drives.  If a
  822. drive does not have a disk in it, Fitter will ask you to insert one in that
  823. drive.  The requester will ALWAYS come up for each first drive in the
  824. "round", which in this example is DF0:.
  825.  
  826. 31.    The Search & Deletion Window
  827.  
  828. Files & Deletion Window
  829.  
  830. From this window, you can:
  831.  
  832.      - Interactively examine the contents of your disk catalog.
  833.  
  834.      - Search for files in your catalog.
  835.  
  836.      - Delete files from your disks.
  837.  
  838.      - Delete disks from your catalog.
  839.  
  840.      - Rescan individual disks to check for inconsistencies with your
  841.      catalog.
  842.  
  843. This window contains the following gadgets:
  844.  
  845.         Disk navigation gadgets 
  846.         File selection buttons 
  847.         Selection scope 
  848.         Disk contents box 
  849.         Rescan 
  850.         Delete Now 
  851.         Space left 
  852.         Files Find string
  853.         Search gadgets 
  854.         Mark pattern
  855.         Volume label
  856.  
  857.                                  - Page 12 -
  858. 31.    The Search & Deletion Window
  859.  
  860.         Disk writaeatble flag
  861.  
  862. 32.    File selection gadgets
  863.  
  864. File selection buttons
  865.  
  866. Below the disk navigation gadgets are the file selection buttons. These
  867. gadgets are used to select and unselect files on disks to be deleted. Whether
  868. or not the buttons affect the current displayed disk, or the whole catalog
  869. depends on the selection scope.
  870.  
  871. All - Select all files on the current disk for deletion (thereby deleting the
  872. disk itself), or all the files in the whole catalog.
  873.  
  874. None - Unselect all files on the current disk that are selected for deletion
  875. or all the files in the whole catalog.
  876.  
  877. Invert - Select all files on the current disk (or the whole catalog) that are
  878. currently unselected, and vice versa.
  879.  
  880. 33.    Selection scope gadget
  881.  
  882. Selection scope
  883.  
  884. Near the lower left corner of the Files & deletion window is the selection
  885. scope gadget.  The setting for this gadget affects the scope of the file
  886. selection buttons; it causes those buttons to either affect either the
  887. current disk displayed, or the whole catalog of disks.
  888.  
  889. 34.    The disk navigation gadgets
  890.  
  891. Disk Navigation Gadgets
  892.  
  893. The cluster of gadgets: Number box, + and - buttons, and slider gadget in the
  894. upper left corner of the Files & Deletion Window make up the disk navigation
  895. gadgets.
  896.  
  897. Use these gadgets to select a disk whose contents will appear in the disk
  898. contents box.  The number box contains the number of the catalog disk you're
  899. looking at, and can be used to change the disk number by clicking in the box,
  900. and typing the number in.
  901.  
  902. The + and - buttons increment and decrement the disk number by 1,
  903. respectively.  These are best used to fine adjust the number.
  904.  
  905. The slider gadget is a coarse adjustment for the disk number.
  906.  
  907. Note that the cursor keys can be used to navigate through the disks and their
  908. contents.
  909.  
  910. 35.    Delete now button
  911.  
  912. Delete now
  913.  
  914. This button is the "go ahead" button for the files deletion process. When you
  915. click it, the disk contents box is filled with all the disks numbers and file
  916. names on them that you selected for deletion by clicking in the disk contents
  917. box, using the file selection gadgets, or by using the Mark pattern button.
  918.  
  919. After confirming your decision to start the deletion by answering the
  920. requester that appears, Fitter prompts you for the disks to insert, after
  921. which it will delete the files you selected, both from the disk, and your
  922. catalog.  Obviously, the disks must be un-write protected. If you selected
  923. all the files on any one disk to be deleted, Fitter will not ask you to
  924. insert the disk; it will just remove the disk from the catalog.
  925.  
  926. Note that a disk rescanning is done automatically when Fitter is finished
  927.  
  928.                                  - Page 13 -
  929. 35.    Delete now button
  930.  
  931. deleting all the selected files on a disk, to make sure that what's in your
  932. catalog reflects the disk's contents.
  933.  
  934. 36.    The disk contents box
  935.  
  936. Disk contents
  937.  
  938. The box in the center of the Files & deletion window is the disk contents
  939. box.  It is here that the contents of the current disk are displayed.  Each
  940. file is displayed, along with its last modification date, size in bytes, and
  941. file comment, if it exists.
  942.  
  943. You can select files that will be deleted by the Delete now button simply
  944. clicking on them.  Unselect a file by clicking on it again.  A selected file
  945. has an asterisk (*) just left of it.
  946.  
  947. Along with the slider at the right side of the box, the cursor keys can be
  948. used to navigate through the currently displayed disk in the disk contents
  949. box:
  950.  
  951. Cursor Left/Right goes ahead to the next disk in the catalog, or back to the
  952. last disk in the catalog. 
  953.  
  954. Cursor Up/Down moves the highlight (file selected) within the disk contents
  955. box.
  956.  
  957. Holding down the Right Shift key while using cursor Up/Down moves within the
  958. disk contents box a few items at a time.
  959.  
  960. You can also use the spacebar to toggle the selection of the current file
  961. within the disk contents box.
  962.  
  963. Any other key (except the Help key) activates the Find string box.
  964.  
  965. 37.    Disk space available box
  966.  
  967. Space left
  968.  
  969. This line tells you how many blocks are left on the disk currently displayed.
  970. Blocks are used here, rather than bytes, because the way Fitter determines
  971. space availability during an Add Files session is by extracting the blocks
  972. available on an inserted disk.
  973.  
  974. 38.    The Files Find string
  975.  
  976. Search gadgets
  977.  
  978. With the box at the bottom of the screen, you can specify a search string to
  979. find the location of files within your catalog.  To do this, simply click in
  980. the box (or type any key except the cursor, space, Help and right shift
  981. keys), and enter your search string.
  982.  
  983. The setting of the Name, Date, and/or Comment checkboxes, if checked means
  984. that a search will include those respective parts of the file information to
  985. match against for your search.  For instance, if you have the Date and
  986. Comment boxes checked, but the Name box unchecked, Fitter will try to match
  987. what you typed in the Find box against file comments and date strings, but
  988. not file names.
  989.  
  990. Match case, when checked, simply means that the text you typed as a search
  991. string must match against file information, and the case of the letters must
  992. match too.  Unchecked, this box means that every search is case insensitive.
  993.  
  994. When a match is found, the disk containing the matching file becomes the
  995. current disk, and it's contents are displayed in the disk contents box, with
  996. the matching file highlighted.
  997.  
  998.  
  999.                                  - Page 14 -
  1000. 38.    The Files Find string
  1001.  
  1002. When there are at least two matches in the catalog matching your search
  1003. criterion, you can use the next and previous match buttons (+/-) next to the
  1004. search string.  Use + to go to the next file matching your criterion, and -
  1005. to a match that is earlier in the catalog.  The search will "wrap around" the
  1006. catalog if there are no more matches until the end, or beginning of the
  1007. catalog.
  1008.  
  1009. 39.    Mark pattern
  1010.  
  1011. Mark pattern
  1012.  
  1013. The Mark pattern button is used in conjunction with the search gadgets, and
  1014. scope gadget to select files for deletion, if their information matches the
  1015. pattern given in the Find box.
  1016.  
  1017. The rules for pattern matching are the same rules used to find a file using
  1018. the search gadgets.  There are no special characters in the Find box that
  1019. have a special meaning.
  1020.  
  1021. After clicking the Mark pattern button, all the files on the current disk, or
  1022. files on any disks in the catalog that have information matching your search
  1023. criterion are marked for deletion.
  1024.  
  1025. This feature can be useful to get rid of certain kinds of files on the disks
  1026. in your catalog.  For instance, if you wanted to free a lot of disk space on
  1027. your disks by getting rid of all the large DMS files on them, you could
  1028. specify ".dms" in your search string, and have only the Name checkbox gadget
  1029. checked.
  1030.  
  1031. A word of caution: Since a search pattern matches against any part of the
  1032. information it's being compared against, attention must be paid to the
  1033. pattern specified.  In the above example, files ending in .dms would be
  1034. matched, but filenames containing ".dms" would also be matched, as in
  1035. something like "my_appication.dmsetting".
  1036.  
  1037. 40.    Catalog descrepancy checking feature
  1038.  
  1039. Catalog Discrepancy Checking
  1040.  
  1041. Fitter has a feature that checks the listing of files on one of your
  1042. catalogued disks against your catalog.  This feature is activated by using
  1043. the Rescan Disk feature in the Files and Deletion window, and it also happens
  1044. automatically during an Add Files session.  In the Files & deletion window,
  1045. Rescan disk operates on the current disk displayed in the disk contents box.
  1046.  
  1047. Its purpose is to notify you when the listing of files on a disk, and the
  1048. list in your catalog do not match.  When this happens, Fitter will report
  1049. both the Files that exist on your disk that are not listed in your catalog,
  1050. and vice versa.
  1051.  
  1052. This feature is useful in that it will always let you know if any new files
  1053. were copied, or files were deleted from a catalog disk, outside of Fitter.  
  1054.  
  1055. After the discrepancy has been reported, your catalog is always updated to
  1056. reflect the contents of the disk.
  1057.  
  1058. 41.    Make disk writeable flag
  1059.  
  1060. Disk writeable flag
  1061.  
  1062. This flag is in the form of a check box, and correlates to the disk currently
  1063. being displayed in the disk contents box.  This means that each disk your
  1064. catalog will have its own setting for this flag.
  1065.  
  1066. When the box is checked for any given disk, it signifies that Add Files can
  1067. use the disk for copying new files to, as it needs.  If the box is not
  1068. checked, Add Files will never ask for this disk.
  1069.  
  1070.                                  - Page 15 -
  1071. 41.    Make disk writeable flag
  1072.  
  1073.  
  1074. This flag, new in V2.1, allows you the flexiblity of selecting which disks
  1075. Fitter can write to.  This is most useful when you've added write protected
  1076. disks in an Add Disks session, just for the sake of recording their contents,
  1077. and you don't want them touched.
  1078.  
  1079. 42.    Volume label gadget
  1080.  
  1081. Volume label / Rename Gadget
  1082.  
  1083. The text box at the top of the Search & Deletion window is the volume label
  1084. gadget.  The name in this box is the disk volume label of the disk currently
  1085. being displayed in the disk contents box.  It changes as the disk in the disk
  1086. contents box changes.
  1087.  
  1088. It can also be used to physically rename any given disk's volume label.  To
  1089. do this, simply select the disk desired using the disk navigation gadgets,
  1090. and click in the volume label gadget.  Type in the new label you want to use.
  1091. You will then be prompted to insert the given disk into any available drive
  1092. to physically relabel the disk.  You may cancel at this point, if you wish.
  1093.  
  1094. When finished, this change is reflected both on the disk and in your catalog.
  1095.  
  1096. 43.    History / New Features
  1097.  
  1098. HISTORY
  1099.  
  1100.  
  1101. Major versions:
  1102.  
  1103. 8-2-95 : V2.11 (Maintenance release)
  1104.  
  1105. BUG FIXES: 
  1106.  
  1107. -Disk numbering in catalog dumps was off by one in all output execpt for "by
  1108. disk" listings.  This has been fixed. 
  1109.  
  1110. -Fitter now accepts disk labels from *really* old FitterV1.x catalogs, where
  1111. disks were always named "Archives_Disk_##", whenever a catalog disk is
  1112. requested.
  1113.  
  1114. -For filenames listed in the Main Window list box, and for disk catalog
  1115. dumps, names are now sorted in their proper lexicographic order.  Before, the
  1116. sorts were ASCII sorts, causing the list to be split in two different groups
  1117. (all upper case followed by all lower case)
  1118.  
  1119.  
  1120. 5-31-95 : V2.10
  1121.  
  1122. NEW FEATURES:
  1123.  
  1124. -Disk usage options  (in Preferences):  This controls how fitter decides to
  1125. use new and existing catalog disks during an Add Files session.
  1126.  
  1127. -Disk writeable flag (in Files & Deletion):  This is a flag that can be
  1128. toggled for each disk in a catalog.  It determines whether a disk can be
  1129. written to (copied to) or not during an Add Files session.
  1130.  
  1131. -Menus available from the main window.  This gives the user access to all the
  1132. high level functions available in Fitter, and provides standard menu keyboard
  1133. shortcuts for these.
  1134.  
  1135. -Free form disk lableling and disk renaming function.  Fitter no longer needs
  1136. to rename disks  in order to add them to the catalog.  It will keep an
  1137. internal disk number, along with a volume label, for each disk.  This allows
  1138. a user to add a write protected disk to the catalog using the  Add Disks
  1139. function.
  1140.  
  1141.                                  - Page 16 -
  1142. 43.    History / New Features
  1143.  
  1144.  
  1145. -Catalog dumping to ASCII feature (from Main window menu):  An ASCII dump of
  1146. the current Fitter catalog can be generated, sorting by filename, filesize,
  1147. or by disk, optionally with each file's comment.
  1148.  
  1149. -File deletions now happen at the end of each disk, rather than after each
  1150. copy, thereby eliminating the possibility of deleting files from the source
  1151. directory before a problem occurs while copying files to a disk.
  1152.  
  1153. -Informational enhancements
  1154.  
  1155.  
  1156. BUG FIXES:
  1157.  
  1158. -Now properly reads V1.X Fitter catalogs.
  1159.  
  1160. -Amigaguide help request routines rewritten properly.  This eliminates the
  1161. Enforcer hits found in V2.0.
  1162.  
  1163. -Now handles absolute paths properly (for catalog files, dump files, etc.)
  1164.  
  1165. 3-4-95  : V2.00
  1166.  
  1167. -Add Files routine completely rewritten.  Fitting now happens on the fly,
  1168. instead of creating a fitting list before the session starts.  Files "fitted"
  1169. dynamically.  Many aspects of Add Files were enhanced for better usability
  1170. and reliability.
  1171.  
  1172. -A copy program was written for Fitter internally.  A choice between using
  1173. this one and AmigaDOS COPY is always available.  Fitter's copy has a %
  1174. completed indicator, and can be interrupted at any time.
  1175.  
  1176. -An Add Files progress log is maintained for Add Files sessions.
  1177.  
  1178. -Many parts of the Add Files routine enhanced for better convenience and
  1179. reliability.
  1180.  
  1181. -Disk formatting now spawns a CON: window showing the progress of the
  1182. format.
  1183.  
  1184. -Fitter preferences modified according to the new changes in Fitter.
  1185.  
  1186. -Gadgets now properly ghosted where appropriate in the Main window.
  1187.  
  1188. -Entire new window/feature: the Search and Deletion window (this also
  1189. replaces the search function).
  1190.  
  1191. -Disk scanning feature that compares disk contents to catalog contents.
  1192.  
  1193. -Online Amigaguide help added.
  1194.  
  1195.  
  1196. 2-20-94 : V1.01 Minor improvements: 
  1197.  
  1198. -Comment gadget now refreshes (clears) after an Add Files session. 
  1199.  
  1200. -Drives not available now ghosted out in Preferences and Add Files windows 
  1201.  
  1202. -Path is now remembered for each subsequent use of the path gadget.
  1203.  
  1204. -Small (one second) delay is now used between the time between a disk is
  1205. inserted and when it is accessed during the Add Files session.  This *MAY*
  1206. fix a problem reported by some people wherein Fitter looked at every disk as
  1207. if it was unformatted.
  1208.  
  1209.  
  1210. 12-18-93 : V1.00 Fitter V1.0 has been developed on a 68030 based Amiga 1200,
  1211.  
  1212.                                  - Page 17 -
  1213. 43.    History / New Features
  1214.  
  1215. and tested mainly on the same machine.  Throughout this testing, no Enforcer
  1216. hits were found.
  1217.  
  1218. -Since near the beginning of this project, there has been a gadget refresh
  1219. problem that I suspect happens on WB 3.x based systems.  The path text gadget
  1220. and size information gadget do not get "wiped clean" when new information is
  1221. displayed in them, like the other gadgets.  After much frustration, and
  1222. questions to many people, an answer could not be found for this problem.  The
  1223. program was developed on an A1200 using D.I.C.E., and so the author is one of
  1224. those who will be living with this annoyance, until an answer is found.
  1225.  
  1226. 44.    Bug reports
  1227.  
  1228. BUGS
  1229.  
  1230. It's simple: I cant fix them if I don't know about them.  In the past, I only
  1231. found out about bugs by explicitly asking users if they'd been seeing any.
  1232.  
  1233. During the author's testing, no enforcer hits were found.
  1234.  
  1235. Extra note: Fitter V2.X does not support Amigaguide V39.X on Workbench 2.X
  1236. machines. If you wish to use Amigaguide help on such a machine (and avoid
  1237. crashes), you must obtain amigaguide.library V34.X.  This is available on
  1238. Aminet, in the Amigaguide development package archive.
  1239.  
  1240. If you discover a bug while using Fitter, please contact me via internet
  1241. email at:
  1242.  
  1243.   benjamin@ritz.mordor.com
  1244.  
  1245. or via the postal service:
  1246.  
  1247.         Joe Thomas
  1248.         512 Adams St.  Apt. 3N
  1249.         Hoboken, NJ 07030
  1250.         USA
  1251.  
  1252. Please feel free to contact me also if you have any suggestions to enhance
  1253. Fitter further.
  1254.