home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload / ShartewareOverload.cdr / database / dsktrk61.zip / DISKTRAK.DOC next >
Text File  |  1991-04-17  |  64KB  |  1,304 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.                                    === DISKTRAK ===
  7.                                      Version 6.10
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.       +---------------------------------------------------------------------+
  28.       | +-----------------------------------------------------------------+ |
  29.       | |                                                                 | |
  30.       | |                                                                 | |
  31.       | |                                                                 | |
  32.       | |                                                                 | |
  33.       | |                      DISKTRAK Version 6.10                      | |
  34.       | |                                                                 | |
  35.       | |                                                                 | |
  36.       | |                A Utility for Managing Diskettes                 | |
  37.       | |                                                                 | |
  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.          Peninsula Software - 28510 Blythewood Dr. - Palos Verdes, CA - 90274
  63.                                         Page 1
  64.  
  65.  
  66.  
  67.  
  68.                                    === DISKTRAK ===
  69.                                      Version 6.10
  70.  
  71.  
  72.                                  Table of Contents
  73.                                  -----------------
  74.  
  75.                        Introduction  . . . . . . . . . . .    3
  76.                        Installation  . . . . . . . . . . .    4
  77.                        System Requirements, Compatibility     4
  78.                        Using the Menus and Windows . . . .    5
  79.                        Main Menu . . . . . . . . . . . . .    6
  80.                        ACTION -- View Data . . . . . . . .    6
  81.                        ACTION -- Report to Print . . . . .    7
  82.                        ACTION -- Report to Screen  . . . .    7
  83.                        ACTION -- Report to File  . . . . .    7
  84.                        ACTION -- Restore Files . . . . . .    7
  85.                        ACTION -- DOS Shell . . . . . . . .    8
  86.                        ACTION -- Exit  . . . . . . . . . .    8
  87.                        UPDATE -- Add/Update Disk(s)  . . .    9
  88.                        UPDATE -- Add/Edit Comment  . . . .    9
  89.                        UPDATE -- Delete Disk(s)  . . . . .   10
  90.                        UPDATE -- Delete File(s)  . . . . .   11
  91.                        UPDATE -- Label Disk  . . . . . . .   12
  92.                        SEARCH -- Filename  . . . . . . . .   12
  93.                        SEARCH -- Diskname  . . . . . . . .   12
  94.                        SEARCH -- Comment . . . . . . . . .   13
  95.                        UTILITIES -- Compress Data  . . . .   13
  96.                        UTILITIES -- Expand Data  . . . . .   13
  97.                        UTILITIES -- Make a Database  . . .   14
  98.                        UTILITIES -- Switch Databases . . .   14
  99.                        UTILITIES -- Sort Disknames . . . .   14
  100.                        UTILITIES -- Show Free Space  . . .   15
  101.                        CONFIGURATION -- Screen Colors  . .   15
  102.                        CONFIGURATION -- Background Char. .   15
  103.                        CONFIGURATION -- Data Disk Drive  .   16
  104.                        CONFIGURATION -- ZIP Filenames  . .   16
  105.                        CONFIGURATION -- Print Lines/Page .   16
  106.                        CONFIGURATION -- Report Type  . . .   17
  107.                        CONFIGURATION -- Config. Save . . .   17
  108.                        Future Enhancements . . . . . . . .   17
  109.                        The DISKTRAK Database . . . . . . .   18
  110.                        Update Summary  . . . . . . . . . .   19
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.          Peninsula Software - 28510 Blythewood Dr. - Palos Verdes, CA - 90274
  125.                                         Page 2
  126.  
  127.  
  128.  
  129.  
  130.                                    === DISKTRAK ===
  131.                                      Version 6.10
  132.  
  133.  
  134.                                     Introduction
  135.                                     ------------
  136.  
  137.     DISKTRAK was designed to provide a "quick and easy" method for keeping
  138.     track of diskette files.  DISKTRAK will allow you to easily create a
  139.     database that contains a list of all your diskettes and the files on each
  140.     one.  Optionally, you can include a comment or description for each file on
  141.     each diskette.  Also, you can optionally have DISKTRAK extract the names of
  142.     files stored inside a "ZIP", "PAK", "ARC", and "LZH" archive file.  Then,
  143.     anytime you want to locate the disk containing a particular file, simply
  144.     enter the filename into DISKTRAK and it will tell you the disk (or disks,
  145.     if there are more than one) that holds the file you're looking for.  If you
  146.     don't know the complete name of the file, key in as much of it as you do
  147.     know and DISKTRAK will search its database for all disks containing any
  148.     file that has the partial name you entered embedded in it.   DISKTRAK
  149.     supports this same database search capability for disk names and file
  150.     comments as well.
  151.  
  152.     DISKTRAK also has other useful disk and file related capabilities: it can
  153.     label diskettes, delete and/or restore any set of files in its database,
  154.     and produce hard and/or soft copy reports of its database contents. 
  155.     Finally, DISKTRAK supports several "usability" functions such as screen
  156.     color and background character customization, database maintenance, and DOS
  157.     Shell functionality.
  158.  
  159.     Creating and maintaining the DISKTRAK database is easy.  Simply "feed" 
  160.     your diskettes to DISKTRAK and it will read the directories and sub-  
  161.     directories on each one, extracting all filenames (including hidden and
  162.     system files) and automatically update its database.  If you add or delete
  163.     files on a diskette, simply "re-feed" it into DISKTRAK; the database will
  164.     be automatically updated. 
  165.  
  166.     DISKTRAK is completely menu driven and was designed for easy, intuitive
  167.     use.  Hopefully you will find DISKTRAK not only easy to use, but also
  168.     useful.  DISKTRAK is being distributed as "shareware", meaning it is
  169.     allowed to be freely copied and distributed, but if used on a regular
  170.     basis, should be paid for.  If you continue to use DISKTRAK you are
  171.     obligated to send its registration fee ($15.00) to Peninsula Software. 
  172.     Doing so will allow Peninsula Software to continue further enhancements to
  173.     DISKTRAK (many features in the current version were suggested by registered
  174.     users) and to develop other low cost software products. 
  175.  
  176.     The following sections describe how to install DISKTRAK and how to use
  177.     DISKTRAK's menus and windows.  After that is a description of each menu 
  178.     selection.  Finally, there is a brief discussion of the DISKTRAK database
  179.     and a summary of the changes made to DISKTRAK since version 4.5.
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.          Peninsula Software - 28510 Blythewood Dr. - Palos Verdes, CA - 90274
  187.                                         Page 3
  188.  
  189.  
  190.  
  191.  
  192.                                    === DISKTRAK ===
  193.                                      Version 6.10
  194.  
  195.  
  196.                                     Installation
  197.                                     ------------
  198.  
  199.     DISKTRAK is very easy to install.  Simply copy the files DISKTRAK.EXE and
  200.     SAMPLE.DTK to the disk and directory from which you wish to run.  Then,
  201.     make this directory the default directory and enter the command DISKTRAK. 
  202.     DISKTRAK will start; it will use the file SAMPLE.DTK as a "demonstration"
  203.     database.  You can use this database to try out all of the DISKTRAK
  204.     functions, including making updates and deletes, before you create your own
  205.     database.  Later, when you're familiar with how DISKTRAK works, create your
  206.     own database, verify that it works O.K., and delete SAMPLE.DTK.  (Note --
  207.     when you do this BE SURE to first create a DISKTRAK configuration file
  208.     identifying your database as the one DISKTRAK should use.  See the section
  209.     "Config. Save" below for details on how to do this.)
  210.  
  211.     DISKTRAK was designed for a system with a hard disk.  If you have a hard
  212.     disk it is recommended that you put DISKTRAK.EXE and SAMPLE.DTK in your
  213.     "utility" subdirectory.  Then, after making this the default directory,
  214.     simply enter the command "DISKTRAK".  If you do not have a hard disk you
  215.     will need two diskette drives to use DISKTRAK.  In this case you should put
  216.     DISKTRAK.EXE and SAMPLE.DTK on a diskette in Drive B: and make this the
  217.     default drive.  Do not put DISKTRAK in Drive A: because DISKTRAK assumes
  218.     Drive A: will be used to read diskette files into its own database.  (You
  219.     can change this if you wish -- see the Configuration section below.)  If
  220.     you have a large enough RAMDISK you can copy the DISKTRAK database there
  221.     and make it (the RAMDISK) the default directory.  However, if you choose to
  222.     do this, be certain to copy your RAMDISK database to a real disk after any
  223.     DISKTRAK session in which you make database updates or changes.
  224.  
  225.                 System Requirements, Compatibility, and Limitations
  226.                 ---------------------------------------------------
  227.  
  228.     DISKTRAK requires DOS 3.0 or higher.  DOS 3.3 is recommended.  DISKTRAK
  229.     will not work properly with DOS versions prior to 3.0 because they do not
  230.     support some of DISKTRAK's functions, such as disk labeling or DOS Shell.
  231.  
  232.     This version of DISKTRAK is incompatible with the database formats from
  233.     versions 4.00 or earlier (smaller version numbers).  DO NOT attempt to use
  234.     this version of DISKTRAK with a database created by version 4.00 or any
  235.     earlier version of the program.  Instead, first create a new database using
  236.     this version and then feed your floppy disks into this new database.  This
  237.     incompatibility is a result of changing the internal database pointers to
  238.     allow databases of unlimited size (databases in earlier versions were
  239.     limited to 32K bytes in size.)
  240.  
  241.     DISKTRAK is written using the Microsoft QuickBasic (r) compiler and there-
  242.     fore must maintain all information being processed in conventional RAM
  243.     memory.  This places a limit on the maximum number of diskettes DISKTRAK
  244.     can handle in any one database.  (Actually, the limiting factor is the
  245.     total number of filenames in the database.)  Some users have reported that
  246.     DISKTRAK will not handle more than about 250 -- 300 disks, whereas others
  247.  
  248.          Peninsula Software - 28510 Blythewood Dr. - Palos Verdes, CA - 90274
  249.                                         Page 4
  250.  
  251.  
  252.  
  253.  
  254.                                    === DISKTRAK ===
  255.                                      Version 6.10
  256.  
  257.  
  258.     have had success with 500 or more disks.  If you receive error messages
  259.     indicating insufficient memory you should split your diskettes up into two
  260.     (or more) DISKTRAK databases.  Finally, DISKTRAK is limited to not more
  261.     than 30 different database files and a maximum of 900 files per diskette
  262.     directory (not including filenames found inside ZIP files.)
  263.  
  264.  
  265.                             Using the Menus and Windows
  266.                             ---------------------------
  267.  
  268.     DISKTRAK's menus and windows are all of the "point-and-shoot" variety. 
  269.     This means that you make the choice you want by first selecting it and then
  270.     telling DISKTRAK to proceed.  This is done in one of two ways: use the
  271.     arrow and Home/End keys to move the highlighted menu selection bar to the
  272.     desired option and then press "Enter", or simply type the single letter
  273.     (upper or lower case are considered the same) in each selection's name that
  274.     is highlighted.  In this case the "Enter" key is not needed; the selection
  275.     is made as soon as you type the highlighted letter.
  276.  
  277.     Some windows have no selections with highlighted letters.  These are
  278.     windows in which selections are to be made, but there is no way for
  279.     DISKTRAK to be able to establish unique selection letters for highlighting,
  280.     or they are windows in which multiple selections are to be made and it is
  281.     not possible to guarantee unique selection letters.  In these windows you
  282.     select the desired item by using the arrow and Home/End keys to position
  283.     the highlight bar, then press the "Enter" key to invoke the selected
  284.     function using your selected item.  When multiple selections are to be made
  285.     (for instance, when selecting files to be restored) you position the
  286.     highlight bar over an item to be selected and press the space bar.  The
  287.     selected item itself will be both highlighted and indicated by surrounding
  288.     arrow points, and the highlight bar will move to the next item.  You can
  289.     de-select items by positioning the highlight bar over a previously selected
  290.     item and pressing the space bar.  When you are finished selecting and/or
  291.     de-selecting items, press the "Enter" key to tell DISKTRAK to continue the
  292.     selected function on all of the selected (and highlighted) items.
  293.  
  294.     In all of the menus and windows the "Home" key moves the selection bar to
  295.     the first entry, and the "End" key moves it to the last entry.  If there
  296.     are more items than can be shown in the window and one time, use the "Page
  297.     Up" and "Page Down" keys to scroll back/forward through the entire set of
  298.     items.  At any time the "Esc"  key will immediately exit the current window
  299.     and return you to the next higher window or menu without invoking any
  300.     selection.
  301.            
  302.     DISKTRAK will not let you make an invalid selection, and will query you for
  303.     confirmation in those instances where a major change in your database will
  304.     occur (like deleting disks.)
  305.  
  306.  
  307.  
  308.  
  309.  
  310.          Peninsula Software - 28510 Blythewood Dr. - Palos Verdes, CA - 90274
  311.                                         Page 5
  312.  
  313.  
  314.  
  315.  
  316.                                    === DISKTRAK ===
  317.                                      Version 6.10
  318.  
  319.  
  320.                                      Main Menu
  321.                                      ---------
  322.            
  323.     DISKTRAK's Main Menu command line is always displayed at the top of the
  324.     screen, allowing you to select one of five possible options: ACTION,
  325.     UPDATE, SEARCH, UTILITIES, and CONFIGURATION.  The command line also
  326.     displays a continuously running digital clock and the current version
  327.     number of the DISKTRAK program.  The Main Menu screen also displays a
  328.     window with information about the current DISKTRAK database.
  329.            
  330.     When DISKTRAK starts, ACTION is automatically selected by default.  Each
  331.     Main Menu option has several sub-options.  You can view these by  pressing
  332.     "Enter" when the Main Menu appears, and then moving the Main  Menu high-
  333.     light left or right by using the arrow keys.  DISKTRAK will not perform any
  334.     sub-option until you specifically select one.  Do this by (1) highlighting
  335.     it by use of the up/down arrow keys and pressing "Enter", or (2) typing the
  336.     highlighted letter (lower case is O.K.) in the desired sub-option.
  337.  
  338.  
  339.     The following diagram shows the Main Menu command line and each set of sub-
  340.     options.
  341.            
  342.     ACTION        UPDATE            SEARCH    UTILITIES        CONFIGURATION    
  343.        
  344.     View Data     Add/Update Disk   Filename  Compress Data    Screen Colors
  345.     Print Rpt     Add/Edit Comment  Diskname  Expand Data      Background Char. 
  346.     Screen Rpt    Delete Disk(s)    Comment   Make a Database  Data Disk Drive
  347.     File Rpt      Delete File(s)              Switch Database  ZIP Filenames
  348.     Restore Files Label Disk                  Sort Disknames   Print Lines/Page
  349.     Exit                                      Show Free Space  Report Type
  350.                                                                Config. Save
  351.  
  352.     In addition to the Main Menu, the Main Menu screen has a window showing
  353.     information about the current DISKTRAK database.  This window is labeled
  354.     "Database Data" and shows the name of the current Database, the maximum
  355.     number of diskettes it can hold, the number of diskettes currently in it,
  356.     the amount (in terms of overall percent) of free space in the database, the
  357.     total size (in K-bytes) of the Database, and the diskette drive DISKTRAK
  358.     will use for reading disks.  The section headed DISKTRAK Database has more
  359.     information about the database contents.
  360.  
  361.  
  362.                                 ACTION -- View Data
  363.                                 -------------------
  364.            
  365.     Selecting this option causes DISKTRAK to display a window listing all of
  366.     the disks in the current database.  To see the names of the files on any
  367.     particular disk, simply select the disk and DISKTRAK will display a second
  368.     window containing the filenames for the selected disk.  You can scroll
  369.     through the filenames using the Up/Down, PgUp/PgDn, and Home/End keys. 
  370.     Filenames for which you have added comments have the symbol "<C>" after
  371.  
  372.          Peninsula Software - 28510 Blythewood Dr. - Palos Verdes, CA - 90274
  373.                                         Page 6
  374.  
  375.  
  376.  
  377.  
  378.                                    === DISKTRAK ===
  379.                                      Version 6.10
  380.  
  381.  
  382.     their names.  (See the UPDATE Add/Edit Comments section for how to create
  383.     comments.)  Selecting a filename with a comment will cause its comment to
  384.     display in a window at the bottom of the screen.  Selecting a file with no
  385.     comment has no effect.  To erase the filename window and return to the
  386.     Disks window, simply press "Esc."  From there you can select another disk
  387.     to examine, or press Esc to return to the main menu.
  388.  
  389.  
  390.                              ACTION -- Report to Print
  391.                              -------------------------
  392.  
  393.     This option causes DISKTRAK to send its report directly to your printer. 
  394.     DISKTRAK can produce any of three types of reports (see CONFIGURATION --
  395.     Report Type option below for details) summarizing its database contents.    
  396.     When you make this selection, DISKTRAK will first show a message indicating
  397.     how many filenames are being sorted, and then will display a message
  398.     telling you the report is being printed.  DISKTRAK returns to the main menu
  399.     when the printout is finished.
  400.  
  401.  
  402.                              ACTION -- Report to Screen
  403.                              --------------------------
  404.  
  405.     This option is like the previous one, except the report is presented on the
  406.     screen instead of being printed.  The report is formatted into screen
  407.     images of 25 lines, so there will be more screen pages than printed pages. 
  408.     Pressing any key except ESCape will present the next page of the report on
  409.     the screen.  Pressing the ESCape key will abort the screen report and
  410.     return you to the main menu screen.  This option creates no printed or disk
  411.     file output.  
  412.  
  413.  
  414.                               ACTION -- Report to File
  415.                               ------------------------
  416.  
  417.     This option "prints" the report to a disk file named DISKTRAK.RPT that is
  418.     created in the default directory.  The format of the report file is as
  419.     specified in the CONFIGURATION -- Report Type option below.   This option
  420.     is provided to allow you to create the report output and view it with some
  421.     utility text viewing program (or the DOS "TYPE" command), and then decide
  422.     if you want to print it by copying the file DISKTRAK.RPT to a printer. 
  423.     This option creates no printer or screen output.
  424.  
  425.  
  426.                               ACTION -- Restore Files
  427.                               -----------------------
  428.  
  429.     This option allows you to select a set of files from the DISKTRAK database
  430.     and have them copied from their respective diskettes to a hard disk
  431.     directory you specify.  This function is typically called "restoring". 
  432.     When you select this option, DISKTRAK first asks you to enter the full path
  433.  
  434.          Peninsula Software - 28510 Blythewood Dr. - Palos Verdes, CA - 90274
  435.                                         Page 7
  436.  
  437.  
  438.  
  439.  
  440.                                    === DISKTRAK ===
  441.                                      Version 6.10
  442.  
  443.  
  444.     name (such as C:\WORDPROC) specifying  where it should restore files. 
  445.     DISKTRAK first verifies the path you entered exists, then displays a
  446.     message telling you it is sorting all of the filenames in the current
  447.     database and, when the sort is complete, opens a window showing a 3-column
  448.     list of all filenames and the diskettes containing them.  You are prompted
  449.     to select files for restoring; do this by moving the highlight bar to the
  450.     desired filename and pressing the space bar to select it.  A selected file
  451.     can be de-selected in the same way.  When finished selecting files, press
  452.     the Enter key.  DISKTRAK will then ask you to insert the required
  453.     diskette(s), copy the appropriate files to the path you specified, and
  454.     return to the main menu with a message telling how many files were
  455.     successfully restored.  DISKTRAK displays a message identifying each
  456.     filename and its target directory as it is copied.
  457.  
  458.     Note: Because DISKTRAK does not store directory (or subdirectory)
  459.     information in its database it will be unable to restore files contained in
  460.     diskette directories other than the root.  DISKTRAK will indicate "File not
  461.     found" in these cases.
  462.  
  463.  
  464.                                 ACTION -- DOS Shell
  465.                                 -------------------
  466.  
  467.     Selecting this option causes DISKTRAK to start a "child" DOS shell.  This
  468.     means DISKTRAK will appear to end and return control to DOS.  In fact,
  469.     DISKTRAK is still active (in your computer's memory), but has invoked the
  470.     DOS command processor allowing you to issue any command you would when
  471.     running under DOS alone.  From the DOS shell you can copy files, initialize
  472.     disks, invoke other programs, etc.  However, you MUST remember to return to
  473.     DISKTRAK by entering the command "Exit" when you have finished with your
  474.     DOS functions.  Also, since DISKTRAK is still in memory when the DOS shell
  475.     is active, you will have significantly less memory available for programs
  476.     than when running DOS directly.
  477.  
  478.     Note:  when in the DOS shell, do not move, rename, or otherwise disturb the
  479.     DISKTRAK database or configuration file.  Changes made to these files while
  480.     in the DOS shell would be unknown to DISKTRAK, and unpredictable (probably
  481.     bad) results would occur when DISKTRAK resumes.
  482.  
  483.  
  484.  
  485.                                    ACTION -- Exit
  486.                                    --------------
  487.  
  488.     Selecting this option ends DISKTRAK and returns you to DOS.  As the closing
  489.     screen indicates, if you use DISKTRAK on a regular basis you are obligated
  490.     to send the registration fee to Peninsula Software.
  491.  
  492.  
  493.  
  494.  
  495.  
  496.          Peninsula Software - 28510 Blythewood Dr. - Palos Verdes, CA - 90274
  497.                                         Page 8
  498.  
  499.  
  500.  
  501.  
  502.                                    === DISKTRAK ===
  503.                                      Version 6.10
  504.  
  505.  
  506.                             UPDATE -- Add/Update Disk(s)
  507.                             ----------------------------
  508.            
  509.     Selecting this option allows you to enter a diskette into the DISKTRAK
  510.     database.  The diskette you enter can be either a new diskette, i. e., one
  511.     not currently in the database, or a "refresh" of a diskette currently in
  512.     the database.  After selecting this option DISKTRAK will ask you to insert
  513.     the diskette into the Data Disk Drive and press Enter when ready.  DISKTRAK
  514.     will then attempt to read the diskette's internal label (sometimes called
  515.     the volume ID.)  If there is no internal label, DISKTRAK will ask you to
  516.     enter one.  This label will be used by DISKTRAK to identify the diskette in
  517.     its database and will also be automatically written onto the diskette. 
  518.     (See the UPDATE -- Label Disk section below for details on the labeling
  519.     process.)  DISKTRAK will then check to see if the diskette is already
  520.     contained in the database.  If not, DISKTRAK will read all the filenames on
  521.     the disk (including hidden and system files and files in directories and/or
  522.     subdirectories, if any) and enter them into the database.  If you specified
  523.     the "ZIP" option to be enabled, DISKTRAK will also extract all filenames
  524.     from inside archive files of type ZIP, PAK, ARC, or LZH.  If the diskette
  525.     is in the DISKTRAK database you will be asked if you want to proceed and
  526.     "refresh" the database information.  Normally you will want to do this,
  527.     because (presumably) you have added or deleted files from the diskette, and
  528.     you want its current status reflected in the DISKTRAK database.  However,
  529.     if you have inadvertently created two different diskettes with the same
  530.     name, you can abort the Add/Update function at this time, relabel the
  531.     diskette, and proceed again.
  532.  
  533.     Note that DISKTRAK will process only normally formatted DOS diskettes. 
  534.     DISKTRAK will reject an unformatted diskette, or a diskette with a non-
  535.     standard format, such as those created by some hard disk backup programs. 
  536.     Also, note that DISKTRAK stores in its database only the diskette name and
  537.     filenames for each diskette.  It does NOT store any directory (or
  538.     subdirectory) names; it does store only the filename contained in these
  539.     directories (or subdirectories.)  Consequently, if a file is contained in a
  540.     directory other than the root directory, DISKTRAK will identify it only as
  541.     being on the diskette, and not in a particular directory or subdirectory.
  542.  
  543.  
  544.                              UPDATE -- Add/Edit Comment
  545.                              --------------------------
  546.            
  547.     Use this option to enter a comment for a filename that does not yet have
  548.     one, or to update an existing comment.  Files with comments have the symbol
  549.     "<C>" (without the quotes) following their names in the Files window.  To
  550.     add/update a comment, select the desired file in the Files window and press
  551.     "Enter".  A window will appear at the bottom of the screen and query you to
  552.     enter a new comment or update an existing one, depending on whether or not
  553.     the selected file has the "<C>" symbol.  New comments can be up to 63
  554.     characters long; to create one simply enter the text and press "Enter" when
  555.     finished.  After entering the comment the "<C>" symbol will appear after
  556.     the file name and the filename highlight bar will move to the next file in
  557.  
  558.          Peninsula Software - 28510 Blythewood Dr. - Palos Verdes, CA - 90274
  559.                                         Page 9
  560.  
  561.  
  562.  
  563.  
  564.                                    === DISKTRAK ===
  565.                                      Version 6.10
  566.  
  567.  
  568.     the Files window. You can enter a comment for this file, or select a
  569.     different one.  When you have finished entering comments, press "Esc" and
  570.     DISKTRAK will return you to the Disks selection window.  Continue to select
  571.     disks/files until all comments have been entered.  Press "Esc" from the
  572.     Disks window to return to the main menu.
  573.  
  574.     If the file you select already has a comment (i. e., the "<C>" symbol
  575.     appears after its name in the Files window) you can edit the comment by
  576.     simply pressing "Enter."  DISKTRAK will display a window at the bottom of
  577.     the screen and request you to edit the existing comment.  You can use the
  578.     "Ins" toggle, Backspace, Home, End, and arrow keys when editing a comment.  
  579.     Also, the Ctrl+arrow key combination moves the cursor one word left or
  580.     right.
  581.  
  582.     If you select a file with a comment by mistake, pressing "Esc" at the
  583.     comment edit window will return you to the Files window with no effect on
  584.     the existing comment.
  585.  
  586.  
  587.                               UPDATE -- Delete Disk(s)
  588.                               ------------------------
  589.  
  590.     This option is provided to allow you to delete one or more diskettes from
  591.     the current database.  You would want to do this if, for instance, you
  592.     decided to re-use a diskette for a different purpose and had given it a new
  593.     internal label and a new set of files.  Note that if you keep the same
  594.     internal diskette name (volume label) and merely replace all the files on
  595.     it there is no need to delete the diskette name from DISKTRAK's database. 
  596.     Simply use the Add/Update function described above to "refresh" the
  597.     DISKTRAK database with the diskette's current status.
  598.  
  599.     To delete a diskette first select this option; DISKTRAK will present a menu
  600.     of all diskettes in the database.  The select the diskette(s) you want to
  601.     delete and press Enter.  DISKTRAK will ask you if you really want to
  602.     proceed.  If yes, enter a "y" (without the quotes); any other character
  603.     will abort the Delete a Disk function with no action taken.
  604.  
  605.     Note: To select diskette(s) to delete, use the arrow keys to position the
  606.     highlight bar over the name of the diskette you want to delete.  Then press
  607.     the space bar.  Doing this will highlight the name and move the highlight
  608.     bar down to the next name.  Continue selecting/ moving until all desired
  609.     disks have been selected.  If you make a mistake and select a diskette you
  610.     don't want to delete, move the highlight bar to the (now highlighted)
  611.     diskette name and press the space bar; this "un-selects" a selected name. 
  612.     You can select and unselect as many times as necessary before pressing
  613.     Enter.
  614.  
  615.  
  616.  
  617.  
  618.  
  619.  
  620.          Peninsula Software - 28510 Blythewood Dr. - Palos Verdes, CA - 90274
  621.                                        Page 10
  622.  
  623.  
  624.  
  625.  
  626.                                    === DISKTRAK ===
  627.                                      Version 6.10
  628.  
  629.  
  630.                               UPDATE -- Delete File(s)
  631.                               ------------------------
  632.  
  633.     This option allows you to physically delete one or more files from your
  634.     diskettes.  
  635.  
  636.     WARNING:  THE SELECTED FILES WILL ACTUALLY BE DELETED FROM YOUR DISKETTES,
  637.               NOT SIMPLY REMOVED FROM THE DISKTRAK DATABASE.  
  638.  
  639.     This option was included to make it easy to "clean up" your diskettes; you
  640.     can easily delete unwanted and/or duplicate files using this option.  (You
  641.     can also delete files you really want to keep if you are not careful!)
  642.  
  643.     When this option is selected DISKTRAK first displays a message indicating
  644.     it is sorting all of the filenames in the database.  It then displays a
  645.     window containing list of all the filenames in the DISKTRAK database sorted
  646.     alphabetically, along with the disk name containing each file.  (The format
  647.     is the same as the ACTION -- Restore Files option described above.)  The
  648.     list allows you to page through all the files in the database, and to
  649.     select individual or groups of files for deleting by pressing the space bar
  650.     after you have moved the highlight bar over the desired filename.  (The
  651.     selection and de-selection process is the same as that described in the
  652.     above section.)  Once you have selected all the files you want to delete,
  653.     press "Enter."  DISKTRAK will ask you to confirm the fact that you want to
  654.     delete files.  Pressing anything but "y" (or "Y") will return to the main
  655.     menu with no action.  If you confirm that you want to proceed, DISKTRAK
  656.     will make an internal list of all the diskettes containing the selected
  657.     files, sort the list alphabetically, and ask you to successively mount each
  658.     diskette in the data drive.  After verifying that the correct diskette is
  659.     mounted, DISKTRAK will delete the selected files on that disk.  (By
  660.     sorting, DISKTRAK insures that each diskette will have to be mounted only
  661.     once.)  After deleting the selected files from the diskette, DISKTRAK will
  662.     automatically update its database to reflect the deleted files, and then
  663.     ask you for the next diskette.  This process continues until you have
  664.     mounted all needed diskettes, after which DISKTRAK returns to the main menu
  665.     with a message indicating how many files (in total) were deleted and how
  666.     many (if any) were not deleted.  
  667.  
  668.     Undeleted files can result from the file not actually being on the diskette
  669.     (it was deleted outside DISKTRAK after the diskette was added to the
  670.     DISKTRAK database), being in a (sub)directory other than the root (DISKTRAK
  671.     does not retain subdirectory data in its database), or the file was found
  672.     on a disk that was write protected, and consequently could not be deleted.
  673.  
  674.     Note:  this option can be used to simply view the sorted contents of the
  675.     DISKTRAK database, and not actually delete any files.  For instance,
  676.     because it displays the entire DISKTRAK database sorted by filename, this
  677.     option is very convenient for determining if you have duplicate files on
  678.     your diskettes.  You can then decide if you want to delete duplicate files,
  679.     or, when asked to confirm the delete request, simply return to the main
  680.     menu by replying "n" or hitting the Esc key.
  681.  
  682.          Peninsula Software - 28510 Blythewood Dr. - Palos Verdes, CA - 90274
  683.                                        Page 11
  684.  
  685.  
  686.  
  687.  
  688.                                    === DISKTRAK ===
  689.                                      Version 6.10
  690.  
  691.  
  692.                                 UPDATE -- Label Disk
  693.                                 --------------------
  694.  
  695.     This option lets you label (or re-label) a diskette from within DISKTRAK,
  696.     thus eliminating the need to shell to DOS and use the DOS LABEL command. 
  697.     When you select this option DISKTRAK will ask you to put a diskette in the
  698.     data disk drive.  It will then attempt to read the internal label from the
  699.     disk.  If there is no label DISKTRAK will so indicate and ask you to enter
  700.     one.  If there already is a label on the disk, DISKTRAK displays a message
  701.     window showing the current label and asks you if you want to re-label the
  702.     disk.  If so, enter the new label.  When you have finished labeling disks
  703.     simply hit the Esc key to return to the main menu bar.  DISKTRAK will
  704.     continue to ask for another disk to relabel until the Esc key is pressed;
  705.     this makes it convenient to label numerous disks in one session.
  706.  
  707.     Note: DISKTRAK checks for a write protected disk prior to initiating the
  708.     label operation.  DISKTRAK will return to the main menu and display an
  709.     error message if you attempt to label a write protected diskette.  Also,
  710.     DISKTRAK checks the label name you enter for valid characters and will
  711.     reject a name that contains invalid characters.  DISKTRAK displays an error
  712.     message in this case.
  713.  
  714.  
  715.                                  SEARCH -- Filename
  716.                                  ------------------
  717.  
  718.     This function is the primary reason DISKTRAK was written.  It allows you to
  719.     enter a filename (or part thereof) and have DISKTRAK search its entire
  720.     database for all diskettes containing a file with that name (or partial
  721.     name).  DISKTRAK will then display a window showing all such diskettes.  To
  722.     see all of the files on any particular diskette, simply select it and
  723.     DISKTRAK will display its filenames, with the highlight bar positioned over
  724.     the first filename that matches your search criteria.  Pressing the Enter
  725.     or Space key will either display the comment for that filename (if there is
  726.     one), or automatically move the highlight bar to the next filename that
  727.     matches the search criteria.  If there is a comment to display, press the
  728.     Enter or Space key a second time to automatically find the next matching
  729.     filename.  You can also page through the files on the selected diskette as
  730.     described in the View Data function. 
  731.  
  732.     Note that the search functions (Filename, Diskname, and Comment) employ
  733.     literal searches based on the exact set of characters you enter.  The
  734.     special DOS wildcard characters * and ? are NOT recognized as wildcards,
  735.     and consequently should not be used in the search string.
  736.  
  737.  
  738.                                  SEARCH -- Diskname
  739.                                  ------------------
  740.  
  741.     This function works just like Search -- Filename except DISKTRAK searches
  742.     its database for the input diskette name (or part thereof).  Use this
  743.  
  744.          Peninsula Software - 28510 Blythewood Dr. - Palos Verdes, CA - 90274
  745.                                        Page 12
  746.  
  747.  
  748.  
  749.  
  750.                                    === DISKTRAK ===
  751.                                      Version 6.10
  752.  
  753.  
  754.     function if you want to quickly browse the filenames of a series of
  755.     diskettes having similar internal labels.
  756.  
  757.  
  758.                                  SEARCH -- Comment
  759.                                  -----------------
  760.  
  761.     This function works just like Search -- Filename except DISKTRAK searches
  762.     its database for a match between the input character string and a comment
  763.     associated with a filename.  Use this function to find files whose comments
  764.     contain a particular character string.  As with the Search -- Filename
  765.     option above, after returning to the main menu screen, DISKTRAK will
  766.     automatically select the next filename with a comment containing the
  767.     searched for character string each time you press the Enter or Space key. 
  768.     You can see the comment itself by pressing Enter or Space a second time.
  769.  
  770.  
  771.                              UTILITIES -- Compress Data
  772.                              --------------------------
  773.  
  774.     Selecting this option causes DISKTRAK to remove all of the unused space
  775.     from its database.  To do this, DISKTRAK creates a new database for itself,
  776.     copies all of the current database information to it, deletes the old one,
  777.     and renames the new one to the same name as the old.  When this operation
  778.     finishes there will be 0% free space in the DISKTRAK database.
  779.  
  780.     Note: in order for this function to work there must be sufficient free
  781.     space on the disk with the default directory to accommodate a second file
  782.     equal in size to the current DISKTRAK database.       
  783.  
  784.  
  785.                               UTILITIES -- Expand Data
  786.                               ------------------------
  787.            
  788.     Select this option if you have to add more disks to your database than it
  789.     was originally specified to hold.  After choosing this option DISKTRAK will
  790.     ask you for the number of diskettes in the expanded database.  You should
  791.     enter the new TOTAL number of diskettes desired, NOT the increase (delta)
  792.     over the current number.  After entering this new total, DISKTRAK will
  793.     create a database capable of holding the specified number of disks, and
  794.     will then copy all of the data in your current database to the newly
  795.     expanded one.  When this is complete, DISKTRAK will delete your current
  796.     database and rename the new one to your "old" current database name.  The
  797.     new, expanded database will also be compressed, i. e., it will have 0% free
  798.     space. 
  799.  
  800.     Note: since there is no way to reduce the size of a DISKTRAK database you
  801.     should avoid specifying a total number of disks significantly larger than
  802.     you are likely to need.  You can always expand your database later.
  803.  
  804.  
  805.  
  806.          Peninsula Software - 28510 Blythewood Dr. - Palos Verdes, CA - 90274
  807.                                        Page 13
  808.  
  809.  
  810.  
  811.  
  812.                                    === DISKTRAK ===
  813.                                      Version 6.10
  814.  
  815.  
  816.                             UTILITIES -- Make a Database
  817.                             ----------------------------
  818.            
  819.     Use this option to create your own DISKTRAK database(s).  You can have up
  820.     to thirty DISKTRAK databases, but only one can be in use at a time. 
  821.     Multiple databases may be desired, for instance, if there are several 
  822.     people using your computer and each has his/her own set of diskettes.  Or,
  823.     you may have so many diskettes that you want to logically segregate them
  824.     into groups.
  825.            
  826.     To create a DISKTRAK database, select this option and specify the name of
  827.     the database and the number of diskettes you want it to hold.  When 
  828.     specifying the database name, enter only the 1 to 8 character primary
  829.     extension.  (Because all DISKTRAK Databases must have a name of the form
  830.     <name>.DTK, DISKTRAK will automatically add the extension ".DTK" to the
  831.     name you enter.)  After specifying the name, DISKTRAK will query you for
  832.     the maximum number of disks the database should hold.  Enter a reasonable
  833.     number; you can always increase it later by use of the Expand function
  834.     described above.
  835.  
  836.     The database created by this option will (obviously) be empty.  Add   
  837.     diskettes to it by first selecting the new database for use by using the
  838.     UTILITIES -- Switch Database function, and then invoking the UPDATE --
  839.     Add/Update Disk option.
  840.  
  841.  
  842.                            UTILITIES -- Switch Databases
  843.                            -----------------------------
  844.            
  845.     This option allows you to select the database to use by presenting you with
  846.     a menu showing all files in the current (default) directory having a name
  847.     of the form <name>.DTK.  All such files are assumed to be DISKTRAK
  848.     databases.  Selecting the file you want to use makes it the current
  849.     DISKTRAK database.  To make the current database the "default" for DISKTRAK
  850.     to use when it starts, you must use the CONFIGURATION -- Config. Save
  851.     function described below.
  852.  
  853.     Note: if there is a file in the default directory with a name of the form
  854.     <name>.DTK that is not a DISKTRAK database, or that is a DISKTRAK database
  855.     created by a version of DISKTRAK prior to version 4.0, it will still be
  856.     shown in the list of files for selection as a DISKTRAK database.  If you
  857.     select such a file for use by DISKTRAK, unpredictable (probably bad)
  858.     results will occur.
  859.  
  860.  
  861.                             UTILITIES -- Sort Disknames
  862.                             ---------------------------
  863.  
  864.     In general, DISKTRAK displays diskettes entered into its database in the
  865.     order in which they are entered.   The UTILITIES -- Sort Disknames option
  866.     lets you change the order of the display to alphabetical.  New diskettes
  867.  
  868.          Peninsula Software - 28510 Blythewood Dr. - Palos Verdes, CA - 90274
  869.                                        Page 14
  870.  
  871.  
  872.  
  873.  
  874.                                    === DISKTRAK ===
  875.                                      Version 6.10
  876.  
  877.  
  878.     will continue to be added in the order entered, and will not be listed in
  879.     alphabetical order unless you re-sort the entire list of names using this
  880.     option.
  881.  
  882.  
  883.                             UTILITIES -- Show Free Space
  884.                            -----------------------------
  885.  
  886.     This option lets you see the amount of free space on a diskette.  After
  887.     selecting this option DISKTRAK will ask you to insert a diskette into the
  888.     Data Disk Drive.  After doing so, press Enter and DISKTRAK will read the
  889.     label of the diskette, determine its total free space (in K bytes, where K
  890.     = 1024) and display a message containing this information.  DISKTRAK will
  891.     then repeat this process until you press the Esc key to return to the main
  892.     menu.
  893.  
  894.  
  895.                            CONFIGURATION -- Screen Colors
  896.                            ------------------------------
  897.            
  898.     This option lets you set the colors for the various DISKTRAK menus.  When
  899.     you select this option DISKTRAK displays a "sample" screen on the right
  900.     hand side of your display, with all colors set to their current values.  A
  901.     menu on the left lets you pick the particular set of colors to change. 
  902.     After selecting the set you wish to change,  DISKTRAK will allow you to
  903.     pick the background and foreground colors; as you pick them, the "sample"
  904.     screen will be updated accordingly.  To activate the setting you have
  905.     currently picked, select the Quit to Main Menu option in the Selections
  906.     menu.  To retain the selected colors permanently, use the CONFIGURATION --
  907.     Config. Save option described below.  (If you don't do this your newly
  908.     selected colors will be in effect only for your current DISKTRAK session.)
  909.  
  910.  
  911.  
  912.                          CONFIGURATION -- Background Char.
  913.                          ---------------------------------
  914.  
  915.     This option lets you specify one of thirteen different characters for
  916.     DISKTRAK's main screen background.  Selecting this option displays a menu
  917.     showing a string of each of the possible characters.  Selecting the desired
  918.     character (by entering its corresponding menu selection character or using
  919.     the arrow/enter keys) will immediately change the background character to
  920.     the selected character.  Instead of returning immediately to the main manu
  921.     command line, DISKTRAK will keep the character selection menu active, thus
  922.     making it easy to cycle through all of the possibilities.  When you have
  923.     decided which background character you want, use the Esc key to return to
  924.     the main menu command line.  Remember to use the Config. Save option to
  925.     permanently retain your selected background character, or your newly
  926.     selected character will only be used for your current DISKTRAK session.
  927.  
  928.  
  929.  
  930.          Peninsula Software - 28510 Blythewood Dr. - Palos Verdes, CA - 90274
  931.                                        Page 15
  932.  
  933.  
  934.  
  935.  
  936.                                    === DISKTRAK ===
  937.                                      Version 6.10
  938.  
  939.  
  940.                           CONFIGURATION -- Data Disk Drive
  941.                           --------------------------------
  942.            
  943.     This option allows you to specify the diskette drive DISKTRAK will use for
  944.     reading diskettes.  The default diskette drive is A:, but you can change it
  945.     to any drive letter A: through P:.  DISKTRAK will reject a drive "letter"
  946.     that is not a character in the range A -- P.  You can enter either an upper
  947.     or lower case letter (no colon).        
  948.  
  949.     Although not recommended, you can use this option to "point" DISKTRAK at a
  950.     hard disk and then read all its filenames into the DISKTRAK database. 
  951.     Doing this may be interesting, but is of little value since DISKTRAK does
  952.     not contain directory or subdirectory information in its database; it can
  953.     only tell you the filenames that are on the disk, not what directory they
  954.     are in.
  955.  
  956.                            CONFIGURATION -- ZIP Filenames
  957.                            ------------------------------
  958.  
  959.     This option lets you specify whether or not DISKTRAK is to extract the
  960.     names of files stored inside an archive file of type ZIP, ARC, PAK, or LZH. 
  961.     The default is NOT to do this.  If you specify yes, DISKTRAK will add to
  962.     its database, in addition to the base ZIP, ARC, PAK, or LZH archive file,
  963.     all of the filenames contained inside it.  Note that if you enable this
  964.     function and then add to the DISKTRAK database one or more disks containing
  965.     numerous archive files, the size of your database will get very large very
  966.     quickly.
  967.  
  968.     When you select this option DISKTRAK will display a message indicating
  969.     whether this option is currently enabled or disabled and will ask if you
  970.     want to reverse this status.  Enter a "y" if you do, or an "n" to retain
  971.     the current status.  DISKTRAK will display the new status when it returns
  972.     to the main menu screen.  Entering "Esc" will return you to the main menu
  973.     screen with no change in status.  Note that the "ZIP" status is not saved
  974.     in the DISKTRAK.CFG file and is not retained by DISKTRAK when the program
  975.     ends; it is reset to "disabled" each time DISKTRAK starts.
  976.  
  977.  
  978.                          CONFIGURATION -- Print Lines/Page
  979.                          ---------------------------------
  980.  
  981.     This option lets you specify the number of lines DISKTRAK will place on its
  982.     output reports.  These reports can be sent either directly to your printer
  983.     or to a disk file: see the ACTION -- Report options above.  Because of the
  984.     title and page number lines DISKTRAK prints on each report page, the number
  985.     of lines per page must be at least 7.  The Print Lines/Page option has no
  986.     effect on reports directed to the screen.  You can retain the number you
  987.     specify in the DISKTRAK.CFG configuration file by selecting the
  988.     CONFIGURATION -- Config. Save option below.
  989.  
  990.  
  991.  
  992.          Peninsula Software - 28510 Blythewood Dr. - Palos Verdes, CA - 90274
  993.                                        Page 16
  994.  
  995.  
  996.  
  997.  
  998.                                    === DISKTRAK ===
  999.                                      Version 6.10
  1000.  
  1001.  
  1002.                             CONFIGURATION -- Report Type
  1003.                             ----------------------------
  1004.  
  1005.     DISKTRAK can create three types of reports that summarize the information
  1006.     in its database.  Report type 1 lists all files in the database and the
  1007.     diskette name each file is on, sorted alphabetically by filename.  Report
  1008.     type 2 contains the same information, but sorts it by diskette volume name. 
  1009.     Report type 3 list every filename and its comment (if present); this report
  1010.     is sorted by filename.  Report types 1 and 2 are formatted in 3 columns,
  1011.     with 50 filename/diskname entries per column.  Report type 3 lists one
  1012.     filename per line, followed by a line containing its comment, if there is
  1013.     one.  Use the ACTION -- Report to Screen option to first see the reports,
  1014.     then either print them or direct them to disk.  For reports destined to be
  1015.     printed, use the Print Line/Page option above to set the number of
  1016.     printlines you want printed per page.  You can retain this number by
  1017.     selecting the CONFIGURATION -- Config. Save option below.
  1018.  
  1019.  
  1020.                            CONFIGURATION -- Config. Save
  1021.                            -----------------------------
  1022.  
  1023.     This option creates (if it does not already exist) or updates (if it does
  1024.     exist) a file in the current default directory called DISKTRAK.CFG and
  1025.     writes into it all of the current DISKTRAK configuration parameters.  These
  1026.     parameters include the current color specifications, the DISKTRAK database
  1027.     name, the main screen background character, the diskette drive to use when
  1028.     reading diskettes, the number of lines per report page, and the desired
  1029.     report type.  If there is no DISKTRAK.CFG file, DISKTRAK uses default
  1030.     values for the color settings and report parameters, assumes the database
  1031.     name is SAMPLE.DTK, and uses diskette drive A:.
  1032.  
  1033.  
  1034.                                 Future Enhancements
  1035.                                 -------------------
  1036.  
  1037.     Additional enhancements for DISKTRAK will be developed depending on the
  1038.     degree of interest and support received by the current version of DISKTRAK.
  1039.     Peninsula Software will seriously consider any enhancements suggested by
  1040.     registered users.  For example, the report option was added as a result of
  1041.     a suggestion (and sample source code) from Joseph R. Nelis, Jr. (Thanks,
  1042.     Jody!) and the comments option resulted from a suggestion by L. P.
  1043.     Thomason.  
  1044.  
  1045.     Microsoft will be releasing a new version of the BASIC programming language
  1046.     by mid 1991 that is capable of supporting Windows.  With this new compiler,
  1047.     the next significant change for DISKTRAK will be to re-write it as a native
  1048.     Windows application.  Consequently, no further enhancements to the current
  1049.     DOS version, except for bug fixes, are planned.  All new capabilities will
  1050.     be added to the forthcoming Windows version.
  1051.  
  1052.  
  1053.  
  1054.          Peninsula Software - 28510 Blythewood Dr. - Palos Verdes, CA - 90274
  1055.                                        Page 17
  1056.  
  1057.  
  1058.  
  1059.  
  1060.                                    === DISKTRAK ===
  1061.                                      Version 6.10
  1062.  
  1063.  
  1064.                                The DISKTRAK Database
  1065.                                ---------------------
  1066.  
  1067.     DISKTRAK cannot operate without a database file.  The distribution DISKTRAK
  1068.     files contain a "sample" database called SAMPLE.DTK; this database contains
  1069.     information from a small set of disks and includes comments containing
  1070.     helpful information about DISKTRAK's use.  When DISKTRAK starts, it first
  1071.     checks to see if a configuration file exists.  (See above section 
  1072.     CONFIGURATION -- Config. Save for more information on creating the
  1073.     configuration file.)  If there is a configuration file, DISKTRAK attempts
  1074.     to open the database defined in it.  If there is no configuration file,
  1075.     DISKTRAK attempts to open a database called SAMPLE.DTK.  If it is unable to
  1076.     do this (file not found) it attempts to build an empty database called
  1077.     EMPTY.DTK with space for 10 diskettes.  If it is successful, DISKTRAK then
  1078.     starts using this empty database.  If unable to create the "empty"
  1079.     EMPTY.DTK file (probably caused by the default disk being full) DISKTRAK
  1080.     terminates, displaying a message that it was unable to create EMPTY.DTK.
  1081.  
  1082.     The DISKTRAK database will contain the names of all the diskettes you have 
  1083.     entered, all of the file names on each diskette, and all of the comments
  1084.     you enter.  There are pointers in the database that connect a diskette to
  1085.     its files, and files to their comments (if present).  Finally, there are 
  1086.     counters holding the total number of diskettes in the database, the number
  1087.     of "free" file names, and the number of "free" comment characters.  "Free"
  1088.     filenames result from files being deleted from diskettes, or from diskettes
  1089.     being deleted from the database.  "Free" comment bytes result from files
  1090.     with comments being deleted from the database, or by creating new (edited)
  1091.     comments that are longer than the original comment.
  1092.  
  1093.     The latter two number are what determine the "free space" in the data-   
  1094.     base.  Free space results from deleting a diskette from the database, or
  1095.     from "refreshing" a diskette already existing in the database.  In either
  1096.     of these two cases, the filenames previously used are flagged as "free" and
  1097.     are no longer usable.  (Comments are maintained intact, however, if the
  1098.     filename with the comment is still on the updated disk.)  All updates
  1099.     and/or additions to the database are made at the end of the database. 
  1100.     Consequently, as time goes on, unwanted "free space" will build up inside
  1101.     the database.  This "free space" is reported on the DISKTRAK main menu in
  1102.     terms of a percentage of the size of the entire database.  This "free
  1103.     space" is literally unusable, wasted space and should be eliminated when it
  1104.     becomes excessive.
  1105.            
  1106.     The "Compress Data" sub-option under the Main Menu Utilities selection 
  1107.     will eliminate all "free space" from your database.  See the section  
  1108.     describing that option for more detail.
  1109.  
  1110.     Note that the DISKTRAK database does NOT contain any information about
  1111.     directories or subdirectories.  Consequently, DISKTRAK cannot perform any
  1112.     functions dependent on the directory structure of a diskette.  
  1113.  
  1114.  
  1115.  
  1116.          Peninsula Software - 28510 Blythewood Dr. - Palos Verdes, CA - 90274
  1117.                                        Page 18
  1118.  
  1119.  
  1120.  
  1121.  
  1122.                                    === DISKTRAK ===
  1123.                                      Version 6.10
  1124.  
  1125.  
  1126.                                      Update Summary
  1127.                                      --------------
  1128.     Version 4.70
  1129.     ------------
  1130.  
  1131.     Added path support for the DISKTRAK database and other active files thus
  1132.     eliminating the requirement to return to the same directory from which
  1133.     DISKTRAK was started after using the DOS Shell function.
  1134.  
  1135.     Added the Restore function to the ACTION main menu selection.
  1136.  
  1137.     Added the capability for DISKTRAK to automatically create an empty, 10 disk
  1138.     database named EMPTY.DTK in the event it cannot find any valid database.
  1139.  
  1140.     Added code to prevent invalid characters from being used in new or updated
  1141.     diskette labels and database file names.
  1142.  
  1143.  
  1144.     Version 4.80
  1145.     ------------
  1146.  
  1147.     Corrected bug that sometimes prevented filenames from being found when
  1148.     doing a search function.  (Thanks to Bruce Banks for identifying this one.)
  1149.  
  1150.  
  1151.     Version 4.90
  1152.     ------------
  1153.  
  1154.     Corrected bug that caused message window border to display incorrectly when
  1155.     using the Update -- Delete Files option and the DISKTRAK database name was
  1156.     more than 7 characters long.
  1157.  
  1158.     Corrected bug that caused corruption of % Free Space after deleting files
  1159.     from disks using Update -- Delete Files option.
  1160.  
  1161.     Enhanced comment editing capability by allowing edited comments to exceed
  1162.     the length of the original comment.
  1163.  
  1164.     Made several minor editorial changes to the documentation.
  1165.  
  1166.  
  1167.     Version 5.00
  1168.     ------------
  1169.  
  1170.     Added the ability to control the number of lines printed on each report
  1171.     page, and changed the default number of print lines on reports from 61 to
  1172.     60.  (Thanks to Ronald C. Brazell, Jr. for these two suggestions.)
  1173.  
  1174.     Added the ability to create reports sorted by either file name or disk
  1175.     name.  (Thanks to Kyle Rudden for suggesting these report options.)  Also
  1176.     added the Report type 3 option which produces a report showing all
  1177.  
  1178.          Peninsula Software - 28510 Blythewood Dr. - Palos Verdes, CA - 90274
  1179.                                        Page 19
  1180.  
  1181.  
  1182.  
  1183.  
  1184.                                    === DISKTRAK ===
  1185.                                      Version 6.10
  1186.  
  1187.  
  1188.     filenames and their comments.  
  1189.  
  1190.     Eliminated the "beep" when paging through screen reports of more than 12
  1191.     pages.
  1192.  
  1193.     Added the report type and the number of lines per printed report page to
  1194.     the configuration data displayed on main screen and saved in DISKTRAK.CFG.
  1195.  
  1196.     Added a message displaying the current disk label when using the Label Disk
  1197.     function to relabel a disk having an existing label.  (Thanks to Mahlon
  1198.     Huff for suggesting this one.)
  1199.  
  1200.     Added the ability to sort disk names so they appear alphabetically in the
  1201.     Disks window.  (This capability was requested by several users.)
  1202.  
  1203.     Added several information messages that appear in the Message window as
  1204.     DISKTRAK is running.
  1205.  
  1206.     Increased the size of the windows displaying disknames and filenames for
  1207.     the Delete and Restore functions, and made the window highlight and
  1208.     selection colors consistent with other selection windows.
  1209.  
  1210.     Eliminated a program hang when attempting to label or delete files from a
  1211.     write protected diskette by checking for write protect and issuing an error
  1212.     message if encountering same.
  1213.  
  1214.  
  1215.     Version 5.10
  1216.     ------------
  1217.  
  1218.     Corrected a bug introduced in Version 5.00 that resulted in incorrect
  1219.     display of Delete Files window when Report Type was specified as 2 or 3.
  1220.  
  1221.  
  1222.  
  1223.     Version 6.00
  1224.     ------------
  1225.  
  1226.     Redesigned most windows and menus to incorporate a "3-D shadow" effect. 
  1227.     Also changed many window sizes and shapes to include more information.
  1228.  
  1229.     Added the capability to determine and display the total free space on any
  1230.     diskette.
  1231.  
  1232.     Enhanced the Search Filename option to automatically highlight the first
  1233.     filename matching the search criteria when viewing search results. 
  1234.     DISKTRAK version 6.00 will also automatically highlight the next filename
  1235.     matching the search criteria after each press of the Enter key.  (Thanks to
  1236.     Larry G. Crowell for suggesting this usability enhancement.)
  1237.  
  1238.     Added more informational messages throughout the program.
  1239.  
  1240.          Peninsula Software - 28510 Blythewood Dr. - Palos Verdes, CA - 90274
  1241.                                        Page 20
  1242.  
  1243.  
  1244.  
  1245.  
  1246.                                    === DISKTRAK ===
  1247.                                      Version 6.10
  1248.  
  1249.  
  1250.     Updated the System Requirements and Compatibility section of the
  1251.     documentation to include a paragraph on program limitations, and added
  1252.     other clarifying information throughout the documentation.
  1253.  
  1254.     To defray the cost of higher postage rates, disks, mailers, and the cost of
  1255.     new windowing and menu software (also Shareware), the program registration
  1256.     fee was raised from $10 to $15. 
  1257.  
  1258.     Changed the routine used to accept user text input so it responds to Ctrl +
  1259.     arrow key commands to move one word left or right and to no longer ignore
  1260.     text to the right of the cursor when "Enter" is pressed.
  1261.  
  1262.     Added a continuously running digital clock to the main menu command line.
  1263.  
  1264.     Increased the number of filenames that can be extracted from archive files
  1265.     from 255 to 500, and removed the limitation of a maximum of a 600 filenames
  1266.     per diskette.  (Thanks to Larry King for pointing out these program
  1267.     limitations.)
  1268.  
  1269.     Added the ability to ESCape back to the main menu when paging through a
  1270.     multi-page screen report.
  1271.  
  1272.     Enhanced the ZIP file function to include extracting file names stored in
  1273.     PAK, ARC, and LZH archives in addition to ZIP archives.  (Thanks to Tom
  1274.     Hanlin III for writing the QuickBasic shareware library that provided this,
  1275.     and several other, capabilities for inclusion in DISKTRAK.)
  1276.  
  1277.     Added the Search -- Comment capability allowing database searches on
  1278.     comments as well as filenames and disknames.  Several users requested this
  1279.     feature.  As with the Search -- Filename function, DISKTRAK automatically
  1280.     selects the filenames who's comments contain character strings matching the
  1281.     search argument.
  1282.  
  1283.     Added checks for sufficient free memory (RAM) to complete data sorting
  1284.     operations.  When insufficient memory is available to perform necessary
  1285.     sort operations, DISKTRAK will now beep, return to the main menu, and
  1286.     display an error message.  Previous versions of DISKTRAK would terminate
  1287.     with error messages like "Subscript out of range..." or "Insufficient
  1288.     memory..." when running out of RAM memory.
  1289.  
  1290.  
  1291.     Version 6.10
  1292.     ------------
  1293.  
  1294.     Corrected mis-spelling of the identifier "Files" in the window listing disk
  1295.     file names.  ("Files" was spelled "Disks" in version 6.00.  Dumb!!)
  1296.  
  1297.  
  1298.  
  1299.  
  1300.  
  1301.  
  1302.          Peninsula Software - 28510 Blythewood Dr. - Palos Verdes, CA - 90274
  1303.                                        Page 21
  1304.