home *** CD-ROM | disk | FTP | other *** search
/ Hall of Fame / HallofFameCDROM.cdr / util2 / pmcat40f.lzh / PMCAT4.DOC < prev    next >
Text File  |  1989-02-28  |  46KB  |  976 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.                                      PMCAT
  22.  
  23.  
  24.  
  25.                         A Disk File Cataloging Program
  26.  
  27.                                       by
  28.  
  29.                                 Patrick Michaud
  30.  
  31.  
  32.  
  33.                                   Version 4.0
  34.                                23 January, 1989
  35.  
  36.  
  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.                          Copyright 1987 by William C. Scott
  63.  
  64.  
  65.  
  66.  
  67.  
  68.                                    PmCat
  69.  
  70.                             A Disk File Catalog
  71.                             by Patrick Michaud
  72.  
  73.                      Copyright 1987 by William C. Scott
  74.  
  75.  
  76.  
  77.          PmCat is designed to make it easy for you to keep track of
  78.          the files and programs on your floppy disks and hard drive(s).
  79.  
  80.          Some of the features of PmCat include:
  81.  
  82.          * Read contents of archived files on disk
  83.          * "Mask" filespec to include and/or exclude files
  84.          * Delete individual files from catalog
  85.          * Find Free Space on cataloged diskettes
  86.          * Assign a DRIVE:\PATHNAME to be a VOLUME
  87.          * Read subdirectories and labels, too
  88.          * Comment each file with up to 80 characters
  89.          * "Rubber-stamp" for comments for duplicate files
  90.          * Sort catalog by filename, ext, size, path or date
  91.          * Supports "*" and "?" searches for files and comments
  92.          * User configurable printer formatting
  93.          * Automatic update of catalog when disks are reread.
  94.          * User customizing of color, catalog name, ASCII filename
  95.          * Writes volume label to diskette (optionally)
  96.          * Create ASCII disk file with user-assigned name
  97.          * Handles multiple catalogs of various names
  98.  
  99.          Minimum System Requirements:
  100.  
  101.           IBM PC/XT/AT or compatible, 256K RAM, one floppy disk
  102.           drive.  Hard drives and subdirectories are supported.
  103.  
  104.  
  105.         DISCLAIMER:
  106.  
  107.           By using this product, the user agrees that neither
  108.           William C. Scott nor Patrick R. Michaud may be held
  109.           liable for any damages, direct or consequential, that
  110.           might arise from the use or misuse of PmCat.
  111.  
  112.  
  113.         INSTALLING PMCAT:
  114.  
  115.           No special steps need be taken.  PmCat contains defaults
  116.           that may be altered by the user once within the program.
  117.           The data files will default to the directory from which
  118.           PmCat is run, as will the PMCAT.DEF file, containing the
  119.           user specified defaults. (The defaults will be explained
  120.           in detail under the appropriate heading later in the docs)
  121.  
  122.    Copyright Notice - PmCat, copyright 1987,1988,1989 by William C. Scott
  123.            PmCat is NOT public domain software.  You may use, copy and
  124.            distribute it freely, but you MAY NOT RESELL PmCat.  A modest
  125.            fee for copying may be charged, not to exceed $3.00 exclusive
  126.            of the cost of disk, mailer and postage.
  127.  
  128.  
  129.  
  130.                                                                     Page 2
  131.  
  132.  
  133.         USING PMCAT:
  134.  
  135.           The following pages will explain first, how to get going
  136.           from the standpoint of "How do I ....?" and later from an
  137.           explanation of each of the various menu commands.
  138.  
  139.           We wrote the docs in the manner we have in the hope they
  140.           could be really "useful".  (I personally hate searching
  141.           documentation for the *only* spot a particular item is
  142.           mentioned). If our feedback indicates a majority of users
  143.           dislike this format, it will be changed to a more 'normal'
  144.           sort of format in the next release.  Please, do let us know.
  145.  
  146.  
  147.         How Do I ... ?
  148.  
  149.           Begin Using PmCat - Enter 'pmc4-250' at the DOS prompt. A
  150.                         titlescreen will be displayed. Follow those
  151.                         instructions. You may prefer to rename your
  152.                         copy of PmCatxx.exe (where 'xx' is the version
  153.                         number) to PMCAT.exe.  This is done at the DOS
  154.                         command line prompt so,
  155.  
  156.                             A>ren pmcatxx.exe pmcat.exe  <ENTER>
  157.  
  158.           Set the Filename for My Data - after the title screen, you
  159.                         will see a small window.  If you want to use
  160.                         the filename of catalog.cat, press <ENTER>.
  161.                         If you want to enter a filename of your own,
  162.                         just type it in, and press  <ENTER>.
  163.  
  164.           Put my catalog data on a different drive or directory-
  165.                         When you enter your filename, enter the full
  166.                         pathname. For example, if you want a file
  167.                         called "disk.dat" on drive C in subdirectory
  168.                         "junk" ... enter "C:\junk\disk.dat"  <ENTER>
  169.  
  170.           Read a DIRECTORY TREE as though it were a VOLUME -
  171.  
  172.                         At the point in updating the catalog when you
  173.                         are prompted for a drive designator (usually A,
  174.                         B, etc.) you may enter an asterisk (*) instead.
  175.                         This will permit you to enter a FULL PATHNAME
  176.                         that will be treated as a VOLUME.  Make sure
  177.                         you include the drive letter and the DOS path
  178.                         to the directory from which you wish to read
  179.                         files.  For example, to read all the files on
  180.                         in the MISC directory, on DRIVE 'C' enter the
  181.                         following:
  182.  
  183.                                   C:\MISC       <ENTER>
  184.  
  185.                         All of the files and subdirectories below (within)
  186.                         the MISC directory will be cataloged as belonging
  187.                         to a volume named  "C:\MISC".
  188.                NOTE: Only 12 total characters are allowed for this function.
  189.                      You may have to rename a directory or two if they have
  190.                      'descriptive' names and you wish to begin below the
  191.                      first level.  E.g., "C:\PMCAT\ACCNT" (14 chars) would
  192.                      be too long, but "C:\PMCAT\ACC" (12 chars) would be OK.
  193.  
  194.  
  195.  
  196.                                                                     Page 3
  197.  
  198.  
  199.           Make my filename the `automatic' (default) one - When the
  200.                         catalog has been read (or not, according to
  201.                         what you do), go to the <S>et Defaults option
  202.                         of the menu on the first screen you see with
  203.                         a menu area at the bottom.  Select <F> from
  204.                         the next manu and enter the full path (if you
  205.                         want it that way) and press enter.  Immediately
  206.                         press <W>rite Defaults to save the setting to
  207.                         disk. Press <ESC> to return to the first menu.
  208.  
  209.           Read the files from a diskette or hard drive - At the first
  210.                         menu, press <U>pdate.  Place the diskette you
  211.                         wish to catalog in the drive. Then enter the
  212.                         the source drive letter.  If you are going
  213.                         to read diskettes in drive A, enter 'A' (no
  214.                         quotes), likewise for B,C or others.  If you
  215.                         enter a drive letter for a non-existent drive
  216.                         it will cause an error.  When you are through
  217.                         adding files to the catalog, press <ESC> to
  218.                         return to the first menu.
  219.  
  220.           Label a diskette - when you <U>pdate by adding a volume PmCat
  221.                         will read the disk and determine if a label
  222.                         exists on the diskette.  You may enter your
  223.                         own or PmCat will label it automatically as
  224.                         DISK% where % is the next number not already
  225.                         used...DISK1, DISK2, etc.
  226.  
  227.           Save my catalog to disk - at the first menu, or the second
  228.                         (which we haven't reached yet), select <W>rite
  229.                         catalog.  It is recommended you do this right
  230.                         after adding files.
  231.  
  232.           Change catalogs - by using the <R>ead catalog option of the
  233.                         first menu, you can load or create a different
  234.                         file from the one you have been working with.
  235.  
  236.           Look at files I want to know about - select <V>iew from the
  237.                         first menu and it will move you to the second
  238.                         menu and open a window containing the filenames
  239.                         and extensions. If you have the Auto-Sort
  240.                         option set to 'ON' a sort will take place when
  241.                         you move from the first to second menu.  This
  242.                         sort does files in alphabetic order of filenames.
  243.                         Auto-Sort may be turned off in the <S>et defaults
  244.                         area. Use the PgUp/PgDn, up/down arrows and
  245.                         Home/End keys to move through the displayed files.
  246.  
  247.           Find a specific file/volume/free space - from the second menu
  248.                         select <F>ind, then <F>, <C> or <S>... search
  249.                         <F>ilenames, <C>omments or free <S>pace.  Then
  250.                         enter the keyword, string or size you wish.
  251.                         Wildcards searches are allowed for filename
  252.                         searches. (See note on searching)
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.                                                                     Page 4
  261.  
  262.  
  263.           Find another file/volume matching the same search pattern -
  264.                         select <N> at the second menu and the next one
  265.                         will be shown.
  266.  
  267.           Find the file size, date and other particulars - select <I>
  268.                         from the second menu.  This will open an Info
  269.                         Window with the statistics about the file, as
  270.                         well as a Comments window
  271.  
  272.           Enter comments about a particular file - select <C> from the
  273.                         second menu.  If the windows are not open, this
  274.                         option will open both the Info Window and the
  275.                         Comments Window and place the cursor in the
  276.                         Comments Window.  Type in your information and
  277.                         press <ENTER>.  Once you have made changes such
  278.                         as adding or deleting comments, use the <W>rite
  279.                         catalog option to save it to disk.  NOTHING IS
  280.                         SAVED on disk until you do this, or exit PmCat.
  281.  
  282.           Delete a FILE from a catalog file - at the SECOND menu select
  283.                         <E>rase and the file will be marked >>DELETED<<.
  284.                         This change is not permanent until you write the
  285.                         existing catalog to disk, even though the file
  286.                         will no longer be shown in the window.
  287.  
  288.           Delete a VOLUME from a catalog file - chose <D> from the
  289.                         FIRST menu. A window displaying all volumes
  290.                         will be opened. Move the bar selector to the
  291.                         one you wish to delete and press <D>. You will
  292.                         have to confirm that decision with a 'Y' or 'N'
  293.                         before going on.  (<ESC> will allow you to
  294.                         abort the process)
  295.  
  296.           Find out what volumes are contained in my catalog file - from
  297.                         the SECOND menu, chose <V> and an overlay window
  298.                         will open with the list of volume names.  Press
  299.                         <ESC> to back up one level.
  300.  
  301.           See the files in a specific directory or volume - place the bar
  302.                         cursor on the Volume or directory name, press <D>
  303.                         from the SECOND menu.  The Info Window will tell
  304.                         you if the name under the bar is a file or
  305.                         directory. Volumes and directory entries both
  306.                         show <DIR> as their size.
  307.  
  308.           See what directories are in my file - first perform a sort on
  309.                         size by selecting <S> from the SECOND menu and
  310.                         <A> for ascending order.  This will get the
  311.                         volumes and directories in alphabetical order
  312.                         at the head of the listing which is being dis-
  313.                         played in the filename display window.
  314.  
  315.           Get a printed listing of my catalog - select <P> from the
  316.                         SECOND menu.  Make sure your printer is ready
  317.                         and press `Y' to continue.
  318.  
  319.  
  320.  
  321.  
  322.                                                                     Page 5
  323.  
  324.  
  325.           Create an ASCII file of my files - after selecting <P> from
  326.                         the SECOND menu a window offers you the option
  327.                         of printing to disk (as the ASCII file) or to
  328.                         the printer.  You are also given the opportunity
  329.                         to name the ASCII file to whatever you wish
  330.                         (any valid DOS filename) or to accept the
  331.                         default filename (which is the name of the
  332.                         present catalog..without extension...with
  333.                         the extension ".LST" added.)
  334.  
  335.           Print only the files from a particular disk (volume) - from
  336.                         the SECOND menu, select <V> then place the
  337.                         selector bar on the volume you want, press
  338.                         <D> and then press <P>. The rest of the
  339.                         printing is the same as above.
  340.  
  341.           Change the default settings for my formatted printing -
  342.                         select <S> from the FIRST menu, then select
  343.                         <P>.  This will open a window showing the
  344.                         current settings.  Printing for a particular
  345.                         field will begin at Start Column and continue
  346.                         for `Size' spaces.  If fields overlap, a warn-
  347.                         ing occurs.  If you ignore it, printing will
  348.                         follow your entry.  The default field widths
  349.                         may be decreased but attempts to make them
  350.                         wider will cause them to be truncated at the
  351.                         default width.  Normal and condensed modes on
  352.                         10" and 15" printers can be used (width up to
  353.                         255 characters).
  354.  
  355.           Use the archive reading feature -
  356.  
  357.                         This may be turned ON or OFF at the <S>et
  358.                         Defaults menu.  When Arc-Read is ON the files
  359.                         contained within the first level of an archive
  360.                         will be cataloged in PmCat.  Archives contained
  361.                         within archives will not be read.  Once in PmCat
  362.                         the files with an extension of '.arc' may be
  363.                         viewed as though they are a directory, using
  364.                         the <D> command of the SECOND menu.  (they are
  365.                         also displayed in the first level window just as
  366.                         contents of other directories are.  If you did
  367.                         not read a disk with Arc-Read ON, and try to
  368.                         see the contents later, a message will appear
  369.                         in the menu area.
  370.  
  371.  
  372.  
  373.  
  374.  
  375.                                                                     Page 6
  376.  
  377.  
  378.  
  379.           Use the "masking" feature -
  380.  
  381.                         In the <S>et defaults menu, use the <M>ask
  382.                         command to open a window.  This window will
  383.                         contain the list of 'filespecs' that will
  384.                         determine which files will be read and/or
  385.                         excluded when you catalog or update a disk.
  386.                         Note that the <I> and the <E> keys while in
  387.                         this window will toggle the Include/Exclude
  388.                         lists as active or inactive by placing a small
  389.                         double arrowhead on the headings.  To alter
  390.                         the list(s), just place the cursor bar on the
  391.                         filespec you wish to change, press <ENTER>
  392.                         and type in the new filespec.  If you wish to
  393.                         change your mind, just press <ENTER> (without
  394.                         entering anything), or if you have typed a few
  395.                         characters press <ESC> and the old filespec
  396.                         will be retained.  These filespecs and active/
  397.                         inactive status will be saved along with other
  398.                         settings if you <W>rite defaults at the previous
  399.                         menu.  Pressing <C> when the cursor is on a
  400.                         filename will clear that name.
  401.  
  402.  
  403.           Set a new DEF (default) file -
  404.  
  405.                         At the <S>et Defaults menu, select the <D>ef-file
  406.                         option.  Type in the filename you want and press
  407.                         enter.  When you save the current program config-
  408.                         uration it will be saved in the new default file.
  409.                         NOTE: An extension of .DEF will automatically be
  410.                         added to the filename you type in, so don't include
  411.                         an extension.  This feature will be useful if you
  412.                         have different mask, screen color combinations or
  413.                         print configurations you might like to use at
  414.                         different times.
  415.  
  416.  
  417.  
  418.                                                                     Page 7
  419.  
  420.         AT THE FIRST MENU (options)
  421.  
  422.           S - set defaults: Change colors, default catalog name/path,
  423.                         titlescreen on/off, Auto-Sort on/off, etc.
  424.               Titlescreen - the title screen may be toggled on and off
  425.                         by pressing "T".  This allows you to bypass
  426.                         the opening messages with Serial # display.
  427.               Auto-Sort - the automatic sorting feature may be toggled
  428.                         on and off by pressing "S".  "OFF" disables
  429.                         sorting when passing from the first screen
  430.                         to the second.
  431.               Archive-read - the ability to read archived files is
  432.                         toggled on/off by pressing <A>.
  433.               Mask-set - pressing <M> will open the window for access
  434.                         to the filemasking information.  Selecting <E>
  435.                         will toggle the list of Exclude filemasks, <I>
  436.                         will toggle the list of Include filemasks.  If
  437.                         you have both turned on, the Include takes
  438.                         precedence.  I.e., you may Exclude all files
  439.                         with a "*.bat" name under the Exclude list, but
  440.                         Include any "autoexec.bat" files under the
  441.                         Include list.
  442.               Default Filename - the location and name of the default
  443.                         data file may be set by pressing "F" and enter-
  444.                         ing your default path and filename.ext.
  445.  
  446.                    NOTE: If you are using Drive B for a data file, then
  447.                         here is an example...
  448.  
  449.                                           B:\MYDATA.CAT
  450.  
  451.                         ...this will cause PmCat to look in the root
  452.                         directory of the disk in Drive B, for a data
  453.                         file named "MYDATA.CAT", and use it for
  454.                         information.
  455.               Colors - the colors of the display may be customized according
  456.                         to your taste by choosing "C".  Notice that as you
  457.                         press the UP and DOWN arrows, the label to the left
  458.                         of the color bar changes, showing what item will
  459.                         be changed.  The line pointer, which is moved
  460.                         by using the LEFT and RIGHT arrow keys, points to
  461.                         the present color, which you can change.  The small
  462.                         window shows how your colors will look.  When you
  463.                         exit by using <ESC> the colors are set and will
  464.                         show when the program is resumed.
  465.               Print settings - this is where you format your output to the
  466.                         printer.  Place the selector bar on the item you
  467.                         wish to alter and press <ENTER>.  The item will
  468.                         be marked with an asterisk (*) to indicate it
  469.                         will be an active part of your printing process.
  470.                         Clear an item by placing the bar on the item and
  471.                         pressing <C>.
  472.  
  473.             When you are satisfied with your settings, press "W" to write the
  474.             new default settings to disk.  These will be read in each time you
  475.             run PmCat or when you select the "R" option of this sub-menu.
  476.  
  477.   YOUR SETTINGS WILL BE ONLY FOR THAT SESSION UNLESS YOU <W>RITE THEM TO DISK!
  478.  
  479.  
  480.  
  481.                                                                     Page 8
  482.  
  483.  
  484.  
  485.  
  486.           U - Update catalog: Read diskettes into catalog. Respond
  487.                         to the prompt with the appropriate drive letter.
  488.  
  489.           W - Write catalog: Writes catalog, which is held in memory,
  490.                         to disk.
  491.                           NOTHING IS PERMANENT UNTIL YOU DO THIS.
  492.  
  493.           R - Read catalog: Read an existing catalog from disk.  This
  494.                         doesn't have to be the same one you read upon
  495.                         startup.
  496.  
  497.           V - View catalog: Takes you to the section of PmCat where
  498.                         you can browse through the files, enter comments
  499.                         and print hardcopy.
  500.  
  501.           D - Delete volume: Allows you to delete a volume from PmCat.
  502.                         This change is not permanent till you WRITE
  503.                         the altered catalog to disk.
  504.  
  505.  
  506.         AT THE SECOND MENU  (options)
  507.  
  508.           <ESC> - always moves you back to the previous step,
  509.                         eventually to the exit prompt.
  510.  
  511.           Home - takes you to the top of the files in the window (#1)
  512.  
  513.           End  - takes you to the bottom of the files in the window (#??)
  514.  
  515.           PgUp - brings up the next 12 files to the window
  516.  
  517.           PgDn - brings up the previous 12 files to the window
  518.  
  519.           Up/Dn Arrows - move the selector bar up or down.  Going past
  520.                         the first or last entry takes you to the
  521.                         previous or next page.
  522.           W - write catalog: Performs same function as the <W> in the
  523.  
  524.           D - Display Directory:  If the item under the selector bar
  525.                         is a <DIR>, a listing of those files in that
  526.                         directory is made available through the window.
  527.                         Contents of archived files are displayed if it
  528.                         was read with the Arc-read ON.
  529.  
  530.           I - Info Window: Opens the Info Window and Comments Window.
  531.                         The Info Window shows the path, size, date,
  532.                         and filename of the file under the selector
  533.                         bar.  Pressing "I" again will close both the
  534.                         Info and Comments windows.
  535.  
  536.  
  537.  
  538.                                                                     Page 9
  539.  
  540.           C - Comments Window:  Pressing "C" will place the cursor in
  541.                         the Comment window and enable commenting of
  542.                         the file under the selector bar.  If the
  543.                         Comments Window was not open when "C" was
  544.                         pressed, the Info Window AND the Comment Window
  545.                         will be opened.  After entering your comments,
  546.                         press <ENTER> and they will be saved.
  547.  
  548.                   THEY ARE NOT PERMANENTLY SAVED TILL YOU "WRITE" THE
  549.                            CATALOG TO DISK.  Press <ESC> to abort.
  550.  
  551.           E - Erase/delete file:  Removes the selected file from your
  552.                         catalog.
  553.  
  554.           F - Find: You will be prompted in the Menu Area at the bottom
  555.                         of the screen about whether you wish to search
  556.                         through filenames or comments.  Choose `F' or
  557.                         `C', whichever is appropriate.  Then enter your
  558.                         key (word, phrase, or character sequence) to find.
  559.                         PmCat will find and display the first one in the
  560.                         file...to go to the next match, press `N'.  (see
  561.                         note on searching)
  562.  
  563.           N - Next Find: finds the next occurrence of the specified
  564.                         search string
  565.  
  566.           S - Sort: sorts files on filename, extension, date, size or
  567.                         path, in ascending or descending order.
  568.  
  569.           P - Print:  If you include comments, it will require two lines
  570.                         per file, otherwise, one.  The files that will
  571.                         be printed depend on where you are in your
  572.                         browsing.  If you are at the "Top" window, all
  573.                         files in PmCat will be printed.  If you have
  574.                         selected a particular volume, then only that
  575.                         volume will be printed.  Likewise, if you have
  576.                         selected a subdirectory, the files in that
  577.                         subdirectory will be printed.   I.e., whatever
  578.                         can be viewed with PgUp/PgDN or Up/Dn arrow
  579.                         will be printed. The output will be sent to
  580.                         an ASCII disk file by selecting <D> to confirm
  581.                         print start.
  582.  
  583.           V - Volume List: gives a display through the window of the
  584.                         volumes that are registered in the current
  585.                         catalog.
  586.  
  587.           Buffer -> comment :  These two menu items make up a simple
  588.           Buffer <- comment :  cut and paste function for the comments
  589.                                portion of the display.  You can type
  590.               the comments for a file once and then copy it to other
  591.               occurrences of that file that might be found in the
  592.               current catalog.  Using the left arrow will copy comments
  593.               to a buffer(scratchpad). Place the bar cursor on the file
  594.               you want the information copied to and press the right
  595.               arrow. The information remains in the buffer until you
  596.               replace it with something else or leave the program.
  597.               This feature enables "rubber-stamping" of a file's comments.
  598.  
  599.  
  600.  
  601.                                                                     Page 10
  602.  
  603.  
  604.         NOTES, HINTS AND TIPS:
  605.  
  606.           Print formatting
  607.             Each data field will begin at the row "Start-Column" on
  608.             your printer and continue for "Width" spaces. Make sure
  609.             a field does not overlap the next field's "Start-column"
  610.             location.  If you pick a size for COMMENTS which is less
  611.             than the actual NUMBER OF CHARACTERS in the COMMENTS field,
  612.             it will be continued on the next line WITH NO OTHER DATA.
  613.             Other fields, if too short for the data to fit on one
  614.             line, will be truncated (chopped off). You may specify
  615.             up to 255 lines/page for page length (60 is the default).
  616.             Allow 3 lines for the header (page number, column titles,
  617.             separator bar). By setting up your printer for condensed
  618.             print, 8 lines/inch (instead of 6) and judiciously select-
  619.             ing and formatting the items to print, you can make disk
  620.             sleeve inserts conveniently.
  621.  
  622.  
  623.             Distribution under the "Shareware" concept is encouraged.
  624.             Unless you have written permission from William C. Scott,
  625.             please do not upload any version of PmCat to Compuserve
  626.             (IMBSYS sig), GEnie, or The Source.  These are our primary
  627.             distribution points.  We ask your cooperation in keeping
  628.             them a place to obtain the latest PUBLIC release of PmCat.
  629.             ( Registrants always receive the latest WORKING version ...
  630.             sometimes the changes are not significant enough to warrant
  631.             another public release)
  632.  
  633.         Searching
  634.             The search acts only on those items focused on by the present
  635.             window. If you are at the first level window, a search will
  636.             cover all volumes, directories, subdirectories and filenames
  637.             if you search <F>ilenames, or comments associated with any
  638.             of the filenames, directories, subdirectories and volumes if
  639.             you select <C>omments (after selecting <F>ind ).  A quirk in
  640.             the program is that you can do an "instring search" (for
  641.             example, look for "asi" in the word Basic) by simply typing
  642.             in "asi" at the keyword prompt, IF you are searching Comments.
  643.             If you are searching <F>ilenames, you must use "*asi*" ...
  644.             note the leading and trailing asterisks, in order to accomp-
  645.             lish the same thing.  The double quotes I used here are not
  646.             to be used in entering the keyword or character string, of
  647.             course...simply type in the characters you want to look for,
  648.             and augment them with the `*' or `?' wildcards...but wild-
  649.             cards are valid ONLY when searching filenames.  Just in
  650.             case you aren't familiar with "wildcards", an entry of a
  651.             phrase string to look for, like, " ?asic " will look for
  652.             all five letter filenames beginning with any valid character
  653.             and having "asic" as the last four characters.  An entry of
  654.             " ?asi* " will look for any occurrence of filenames containing
  655.             "asi" as the second, third and fourth characters. The decision
  656.             not to incorporate wildcards in the comments searches was one
  657.             of those arbitrary decisions any programmer makes.  It slowed
  658.             the search to an unacceptable speed...so it was decided to
  659.             compromise with the "instring" type of search only.
  660.  
  661.  
  662.  
  663.  
  664.                                                                     Page 11
  665.  
  666.  
  667.         Sorting
  668.           The sorted display is TEMPORARY!  It is retained only as long
  669.           as you remain in the area of the PmCat where you view the
  670.           files.  The sorted display is created as an index which is
  671.           held in memory.  It cannot be saved to disk at this time.
  672.           This is another of those "compromises" we had make ... hope
  673.           it isn't too much of a problem for you.
  674.  
  675.         Drive error
  676.           If you pick a non-existent drive to read from, PmCat will
  677.           handle it gracefully.  If you fail to close the drive
  678.           door or place a disk in the selected drive, you will see
  679.           the familiar DOS message asking Abort, Retry, Ignore? ...
  680.           in a window.  Simply place a disk in the drive and close
  681.           the drive door and press [R] ... PmCat will recover.  If
  682.           you choose <A>bort, you will exit to DOS.
  683.  
  684.         Blinking text and boxes
  685.           If you find the boxes and text on the main screen, windows
  686.           or menu are blinking, and you don't want them to, go to the
  687.           Set Defaults option and set the pointer to the corresponding
  688.           BACKGROUND color ON THE LEFT HALF OF THE COLOR BAR.  Any of
  689.           the 16 colors may be chosen for text, but the background
  690.           allows only the 8 base colors.  The other 8 blocks (the right
  691.           half) will produce the same color background, but the text
  692.           and box borders will blink.  Some like to use this option to
  693.           make the Select Text (in the selector bar) blink.
  694.  
  695.  
  696.  
  697.                                                                     Page 12
  698.  
  699.                             About Our Marketing Process
  700.  
  701.               We chose this method of distribution out of financial
  702.               prudence.  Had we elected to spend the many thousands
  703.               of dollars in advertising, printing and fancy packaging
  704.               that a "normal" marketing approach requires, the price
  705.               of a program like PmCat would be surely be well over
  706.               $30.00 and likely never be looked at by many.  Please
  707.               don't be put off by the fact you may have obtained a
  708.               free copy of PmCat.  It is in every sense a "commercial"
  709.               product. It was primarily authored by Patrick Michaud
  710.               who will be receiving his PhD in Computer Science in
  711.               the summer of 1989.  Patrick is among the 'creme de
  712.               la creme' of young programmers ... he isn't just
  713.               "muddling through". He also has another fine program
  714.               in work and the method we use to market it will be
  715.               largely determined by the success of PmCat through
  716.               shareware channels.
  717.  
  718.               Please realize that PmCat didn't just "happen".  We have
  719.               spent a great deal of money for compilers, language tools
  720.               and hardware that is specifically dedicated to the develop-
  721.               ment of PmCat, not to even begin thinking about the many
  722.               hours of sitting at the keyboard, tearing out hair trying
  723.               to figure out why the obviously simple, isn't!  We must,
  724.               at the very least, recover our investment so that we can
  725.               continue to develop programs of this quality.
  726.  
  727.               By our distributing PmCat under the shareware concept,
  728.               you can obtain a copy of it for free or at minimal cost
  729.               through BBS's, user groups, etc.
  730.  
  731.               If there is something about it you perceive as a flaw,
  732.               please do let us know.  That is the only way we can
  733.               improve our products to your satisfaction.
  734.  
  735.               Based on the assumption you have a fair quantity of
  736.               diskettes (or even a hard drive) containing programs/
  737.               files you would like to keep track of, you have a need
  738.               for and have to this point not found *quite* what you
  739.               want in a disk cataloger. I sincerely hope PmCat can
  740.               fill this need for you.
  741.  
  742.              If it does, please take the time to sit back and consider
  743.              whether or not it is worth the $10 or $15 we ask you to
  744.              send for registration.
  745.  
  746.              There are now two levels of registration for PmCat.  The
  747.              $10 fee establishes you as a registered user, receive a
  748.              copy of the latest distribution version of PmCat, a copy
  749.              configured for maximum memory (but necessarily without
  750.              the DOS shell function and ensures you will be notified
  751.              of significant updates to PmCat and offered a copy of
  752.              those updates for a nominal fee. That fee is currently $4.
  753.              For $15.00 you will receive a copy of the very latest
  754.              version on 5.25 inch floppy disk.  This will include
  755.              multiple copies of PmCat with the different configurations
  756.              that might be necessary to more nearly fit your needs
  757.              exactly.  You will also have the option of obtaining
  758.              additional configurations for a very modest fee as noted
  759.              on the order form.
  760.  
  761.  
  762.  
  763.                                                                     Page 13
  764.  
  765.              If you wish to register PmCat and receive the benefits of
  766.              doing so: the additional configurations with full registra-
  767.              tion, entry on our mailing list and a sales receipt, please
  768.              send check or Money Order to the address below:
  769.  
  770.                                William C. Scott
  771.                                 #22 Cary Annex
  772.                               Coalgate, OK 74538
  773.  
  774.              We keep a customer file with the registered owner and
  775.              his/her serial number.  That serial number stays with
  776.              that owner through any and all updates and revisions of
  777.              PmCat.
  778.  
  779.          IN ORDER TO ENSURE YOU CAN FULLY EXAMINE THE POTENTIAL OF PMCAT,
  780.          THIS SHAREWARE DISTRIBUTION VERSION HAD TO BE RESTRICTED TO ONLY
  781.          250K OF MEMORY TO BE USED TO HOLD THE CATALOG.
  782.  
  783.              This was necessary because of the DOS shell option which
  784.              this newest version of PmCat has implemented.  If we create
  785.              PmCat with the compiler requesting 640K of memory, none
  786.              would be left for the DOS shell option which requires about
  787.              30-40K or so of RAM.  By restricting the amount of memory
  788.              PmCat requests from DOS when loaded it ensures that option
  789.              will be functional on the vast majority of configurations.
  790.  
  791.              Conversely, to create the maximum size catalog in memory,
  792.              you might prefer to forego the DOS shell option in order
  793.              to obtain the maximum storage space.  Too, we can't predict
  794.              how many memory resident programs a given user might be using
  795.              and so the amount of available memory on a given system is an
  796.              unknown factor for us.
  797.  
  798.          IF YOU DECIDE PMCAT WILL FIT YOUR NEEDS, WHEN YOU REGISTER, WE WILL
  799.          SEND YOU A DISK WITH 5 CONFIGURATIONS; 200K, 300K, 375K, 450K
  800.          AND NO RESTRICTION...AND NO DOS shell (in that one).
  801.  
  802.              You can choose from among those for the one that best suits you.
  803.  
  804.                                      or...
  805.  
  806.          IF YOU KNOW EXACTLY WHAT YOU WANT/NEED FOR A CATALOG SIZE (about 120
  807.          bytes per file with comments is used by PmCat...less 80 bytes per file
  808.          if no comments are used) OR DESIRE TO HAVE SOME OR ALL OF THE DEFAULT
  809.          SETTINGS DIFFERENT, WE WILL PLEASED TO CUSTOM CONFIGURE A COPY FOR YOU
  810.          FOR A MODEST $5.00 CHARGE (including the cost of the extra diskette
  811.          IF required).
  812.  
  813.  
  814.  
  815.                                                                     Page 14
  816.  
  817.                            Figuring your Configuring
  818.  
  819.        The options listed below are parameters that you might find more
  820.        convenient to have set to your own values. If you decide to register
  821.        PmCat fully and wish to opt for a custom configuration of memory,
  822.        or other parameters, please include this list with the appropriate
  823.        settings checked off.  We will configure one extra copy (in addition
  824.        to the 5 you will receive anyway), with these settings, for the same
  825.        $5 fee of recompiling to give you the memory you wish.
  826.  
  827.                       YES    NO     '+' indicates default setting
  828.        Auto-Sort     +___   ___
  829.        Titlescreen   +___   ___
  830.        Achive read   +___   ___
  831.        Exclude mask   ___  +___      ( defaults are blank )
  832.  
  833.          1.__________.____  2.__________.____  3.__________.____
  834.  
  835.          4.__________.____  5.__________.____  6.__________.____  ( 9 options )
  836.  
  837.          7.__________.____  8.__________.____  9.__________.____
  838.  
  839.        Include mask   ___  +___      ( *.com, *.exe, *.txt, *.doc, *.arc )
  840.  
  841.          1.__________.____  2.__________.____  3.__________.____
  842.  
  843.          4.__________.____  5.__________.____  6.__________.____   ( 9 options )
  844.  
  845.          7._________._____  8.__________.____  9.__________.____
  846.  
  847.        Catalog name _______________._______  ( CATALOG.CAT )
  848.  
  849.        .DEF file    _______________._______   ( PMCAT.DEF )
  850.  
  851.        Colors:  Screen text         _________(white)
  852.                 Screen background   _________(black)
  853.                 Window text         _________(lightgreen)
  854.                 Window background   _________(blue)
  855.                 Select text (bar)   _________(lightgray)
  856.                 Select background   _________(red)
  857.                 Menu text           _________(lightgreen)
  858.                 Menu background     _________(cyan)
  859.                 Menu highlights     _________(yellow)
  860.  
  861.        Background Options : Black,Blue,Green,Cyan,Red,Magenta,Brown,Light Gray
  862.  
  863.        Text Options : Black,Blue,Green,Cyan,Red,Magenta,Brown,Light Gray,
  864.                       Dark Gray,Light Blue,Light Green,Light Cyan,Light Red,
  865.                       Light Magenta,Yellow,White
  866.  
  867.        PLEASE CONSIDER CAREFULLY before you request a modified version.
  868.        Try the color settings and other defaults in your own system to be
  869.        sure they are exactly what you want and won't tire of.  Of course
  870.        ".DEF" files can be easily created to hold your values, too.
  871.  
  872.        To avoid possible confusion on our end as to who wants what, please
  873.        put your name and address on this form.
  874.  
  875.                Name:  _________________________________
  876.  
  877.                Addr:  _________________________________
  878.                                                               THANKS!
  879.  
  880.  
  881.                                                                     Page 15
  882.  
  883.  
  884.         IMPORTANT DETAIL:
  885.  
  886.            We have noted an apparent incompatibilty which is not the fault
  887.            of PmCat's code, but may, in certain instances cause your system
  888.            to lock, requiring a cold reboot.  The incompatibilty seems to
  889.            lie with either the Borland Turbo Pascal 'EXEC' command or
  890.            DOS itself or both.  If one attempts to SHELL to DOS using the
  891.            Turbo Pascal 'EXEC' command and DOS' 'PRINT' is resident in
  892.            memory, the problem occurs.  For this reason, we WON'T compile
  893.            a version of PmCat configured for BOTH maximum memory allocation
  894.            AND a DOS SHELL option. (The two are mutually exclusive, anyway)
  895.            Any version of PmCat (or any other program using the EXEC procedure)
  896.            that requests more memory than DOS says is available will be prone
  897.            to this problem.  The only way to ensure you have no problem is
  898.            NOT RUN PRINT before using PmCat, or ensure you have adequate
  899.            system memory to accomodate the program's request OR don't use
  900.            the <O>s option in PmCat if you have run PRINT.  We also noted
  901.            this problem when attempting to use NewSweep from within the <O>s
  902.            shell command.  If you use NewSweep, make sure you have about 50-60k
  903.            free in the shell before executing it.  Other programs might cause
  904.            similar problems. Please let us know if and when you run across
  905.            any other such incompatibilities.
  906.  
  907.            Under other circumstances, when one tries to shell to DOS and
  908.            there is inadequate memory, the operation is simply not permitted.
  909.            No problems.
  910.  
  911.            This may all sound confusing to some users, but fear not.  You
  912.            can gracefully use any configuration you wish of PmCat without
  913.            danger as long as you don't run PRINT before using PmCat...and
  914.            even then, things are fine unless you forget and attempt to
  915.            SHELL after having run PRINT.  So, you see, armed with this
  916.            knowledge, you will almost have to be trying to lock up your
  917.            system...<grin>
  918.  
  919.  
  920.  
  921.   SDN #WCS022789
  922.  
  923.  
  924.                          PmCat   REGISTRATION   Form
  925.  
  926.                                   Version 4.0
  927.  
  928.  
  929.   Check or money order payable to:
  930.  
  931.  
  932.                                           William C. Scott
  933.                                            #22 Cary Annex
  934.                                          Coalgate, OK 74538
  935.  
  936.  
  937.  
  938.   DATE:______________
  939.  
  940.   NAME:______________________________________________
  941.  
  942.   ADDR:______________________________________________
  943.  
  944.   CITY:_______________________________________  STATE:____ZIP:_________
  945.  
  946.  
  947.   Version # of PmCat you currently have:__________ (or month\yr on titlescreen)
  948.  
  949.   ID# of current copy of PmCat you have: __________________
  950.  
  951.   Where did you obtain PmCat?______________________________________________
  952.        (This helps us to know where to place future versions, first)
  953.  
  954.  
  955.   Full registration   (5 copies sent)       ___  @  ($15.00)      __________
  956.  
  957.   Simple registration                       ___  @  ($10.00)      __________
  958.  
  959.   Extra configurations                      ___  @   ($5.00)      __________
  960.  
  961.   Update to latest version
  962.    (Previously registered users only-       ___  @   ($5.00)      __________
  963.     new copy with same ID# and benefits)
  964.  
  965.  
  966.                                                  SUB-TOTAL        __________
  967.  
  968.  
  969.   Shipping       (outside of U.S.A. only)            ($4.00)      __________
  970.                    _________________________________________________________
  971.  
  972.  
  973.                                                      TOTAL        __________
  974.  
  975.  
  976.