home *** CD-ROM | disk | FTP | other *** search
/ Best Objectech Shareware Selections / UNTITLED.iso / boss / util / dos / 019 / pcd.doc < prev    next >
Text File  |  1991-10-31  |  9KB  |  218 lines
  1.  
  2.  *---------------------------------------------------------------------*
  3.  |    PCD - another quality, compact MSDos utility program from        |
  4.  |                      Phil Nickell - NSoft Co.                       |
  5.  *---------------------------------------------------------------------*
  6.  | PCD is a utility program designed to make changing directories much |
  7.  | quicker and easier.  This is especially significant with larger     |
  8.  | drives with multiple partitions.                                    |
  9.  *---------------------------------------------------------------------*
  10.  
  11.  
  12.    PCD works in a manner similar to Norton's NCD command (a commercial
  13.    product) and Led's Change Directory LCD command (another shareware
  14.    product).  Two main ideas used by PCD were 'borrowed' from NCD and
  15.    LCD.  I liked the 'fuzzy' searching used in NCD, and the
  16.    multiple-drive function of LCD.
  17.  
  18.    PCD, I believe, has these advantages over the others:
  19.  
  20.      * PCD executable file size and memory requirements are very small,
  21.        especially compared to Norton's product which has become bloated
  22.        in recent releases.
  23.  
  24.      * PCD is a 'quiet' utility with none of the flash & fury of
  25.        other products.  It just does its job and doesn't brag about it.
  26.  
  27.      * PCD works 'across all drives' in a manner similar to LCD. You
  28.        don't have to specify a drive letter when changing directories.
  29.  
  30.      * PCD does 'fuzzy' best-match directory finding similar to NCD by
  31.        using its directory database.  You can often specify just two or
  32.        three letters of the directory and PCD will take you there.
  33.  
  34.      * PCD - the price is right.  See below.
  35.  
  36.  
  37. ------------------------------------------------------------------------
  38. DISCLAIMER.  I strive to create a functional and reliable product, but
  39.              lawyers say that this disclaimer is necessary.
  40.  
  41.    I specifically disclaim all warranties, express or implied,
  42.    including but not limited to, any implied warranty or
  43.    merchantability or fitness for a particular purpose.  I shall not be
  44.    liable for damages of any kind resulting from the use of this
  45.    product.  Use this product at your own risk.  Please use PCD only if
  46.    you accept this disclaimer.
  47.  
  48.  
  49. SHAREWARE Pricing:
  50.  
  51.    $5.00.  Bottom Line!  This is minimum-priced shareware program that
  52.    sells for a very frugal $5. To keep the price this low I cannot
  53.    afford to send diskettes or printed documentation. I will reply with
  54.    a letter to acknowledge your purchase and to give you a record of
  55.    license.  PCD is copyright 1991 by Phillip M. Nickell, NSoft Co.
  56.  
  57.  
  58.             1 copy:        $5.00
  59.             2-10 copies:   $2.50 each
  60.             11-up:         $2.00 each up to an absolute maximum
  61.                                  of $100.00 for an unlimited quantity
  62.                                  site license or corporate license.
  63.  
  64.    Mail Checks payable to:    Phillip M. Nickell
  65.                   address:    NSoft Co.
  66.                               1027 19th Ave.
  67.                               Longmont, Co.  80501
  68.  
  69.  
  70.  
  71.  
  72. ------------------------------------------------------------------------
  73.  
  74. PCD Syntax:
  75.  
  76.           command                       explanation
  77.         -----------                   ---------------
  78.    PCD                          no parameters? You get a help screen.
  79.    PCD actual-directory-name    change to directory
  80.    PCD partial-directory-name   change to best-match directory
  81.    PCD md directory-name        create directory and update the database
  82.    PCD rd directory-name        delete directory and update the database
  83.    PCD /d [p]                   directory list from database. [paused]
  84.    PCD /scan  [drivelist]       scan drives and build directory database
  85.    PCD /qscan [drivelist]       scan drives (ignore directories
  86.                                 with extensions - much quicker)
  87.  
  88.  
  89.  
  90. INSTALLATION.
  91.  
  92.    PCD consists of the single executable file PCD.EXE.  Copy pcd.exe to
  93.    your hard drive.  It is a good idea to put it in a directory that is
  94.    searched by dos (i.e. it is 'in the path').  That's all. Please read
  95.    this .doc file that comes with pcd to fully understand the program
  96.    and its various options.
  97.  
  98.  
  99.  
  100. FIRST things first: Scanning directories.
  101.  
  102.    The first time you execute PCD, you must specify the /SCAN or the
  103.    /QSCAN parameter. This tells PCD to scan all of the available DOS
  104.    'hard drives' and construct a file named PCD.IDX in the root
  105.    directory of the first (lowest letter) hard drive.   If you use PCD
  106.    to create and remove directories it will keep the database file
  107.    properly updated. If you tend to use the DOS MD and RD commands to
  108.    create and delete directories, you will need to occasionally
  109.    re-scan your drives to update the database.
  110.  
  111.    If you only want PCD to 'know' about certain specific drives (i.e.
  112.    only non-network and non-ramdisk drives) you can specify a drive
  113.    letter list after the /SCAN or /QSCAN parameter.  To have PCD scan
  114.    only drives C:, D: and E: you would do this:
  115.  
  116.         PCD /SCAN CDE
  117.  
  118.    If you don't have subdirectories with extensions on their names
  119.    ( for example, D:\FILES.SAV\ ) then you can specify /QSCAN instead
  120.    of /SCAN.  This causes PCD to scan much faster.
  121.  
  122.  
  123.  
  124. CHANGING directories:
  125.  
  126.    Use PCD to quickly switch to another directory.  For example, if you
  127.    have a directory named D:\QMODEM\UPLOADS you can switch to it
  128.    quickly with the command:
  129.  
  130.         PCD UPLOADS
  131.  
  132.    If you only have one directory named UPLOADS on your drives you may
  133.    be able to switch to that same directory by using the command:
  134.  
  135.         PCD UP
  136.  
  137.    If you have two directories named UPLOADS, you can usually switch
  138.    between them by just executing PCD UPL again. Since you are
  139.    requesting a change of directory, the PCD fuzzy-matching algorithm
  140.    gives extra 'weight' to finding another directory with a similar
  141.    name rather than just staying in the current directory.
  142.  
  143.    Experience will tell you how much of a directory name you need to
  144.    specify to make sure you get there.  The more of a directory name
  145.    you specify the better the 'fuzzy matching' will work.  The matching
  146.    algorithm is designed to work best when you use the first few
  147.    characters of a subdirectory name.
  148.  
  149.    In all cases PCD will attempt to do an immediate change-directory to
  150.    find the exact directory you specify.  If that fails then PCD will
  151.    read the directory database file and use its best-guess matching
  152.    algorithm to satisfy your request.
  153.  
  154.  
  155.  
  156. LISTING contents of database
  157.  
  158.    The /d (directory list) command causes a list of the directories in
  159.    the database to be displayed.  Any character as a second parameter
  160.    will cause the screen display to be paused each 24 lines waiting for
  161.    a keypress.
  162.  
  163.         PCD /D                    display entire database
  164.         PCD /D P                  display entire database with pauses
  165.         PCD /D >DATA.LST          list of database is redirected to
  166.                                   the file data.lst
  167.  
  168.  
  169.  
  170. IMMEDIATE database update:
  171.  
  172.    When PCD is used to create and remove directories it will update the
  173.    database immediately.  This reduces the need to scan the drives to
  174.    update the database. For example, to create a subdirectory named
  175.    CHARTS on the C: drive you would do:
  176.  
  177.         PCD MD C:\CHARTS
  178.  
  179.    The directory will be created, and the pcd.idx database file will be
  180.    quickly updated to include the new directory.  This feature comes in
  181.    handy for users of command shells that allow aliasing, such as CED,
  182.    ALIAS or NDOS.  With  those utilities, you can change the standard
  183.    MD and RD commands to run PCD instead.  With ALIAS, you could set up
  184.    the aliases like this:
  185.  
  186.         ALIAS MD  PCD MD %1
  187.         ALIAS RD  PCD RD %1
  188.         ALIAS CD  PCD %1 %2
  189.  
  190.    It is possible to 'fool' PCD by creating directories with PCD and
  191.    removing them with dos, or vice-versa.  In these cases the PCD
  192.    database will not be updated properly and will not reflect the true
  193.    structure of the har