home *** CD-ROM | disk | FTP | other *** search
/ High Voltage Shareware / high1.zip / high1 / DIR15 / LCD_20.ZIP / LCD.DOC < prev    next >
Text File  |  1990-12-01  |  22KB  |  509 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.                          Led's Change Directory v2.0
  10.  
  11.                             Released Dec 1, 1990
  12.  
  13.                    A PC-DOS / MS-DOS Fast Directory Changer
  14.  
  15.  
  16.  
  17.                               _______
  18.                          ____|__     |               (tm)
  19.                       --|       |    |-------------------
  20.                         |   ____|__  |  Association of
  21.                         |  |       |_|  Shareware
  22.                         |__|   o   |    Professionals
  23.                       -----|   |   |---------------------
  24.                            |___|___|    MEMBER
  25.  
  26.  
  27.  
  28.  
  29.                      Written by Keith Ledbetter
  30.                                 4240 Ketcham Drive
  31.                                 Chesterfield, VA  23832
  32.                                 (804) 674-0780
  33.                                 (6:00pm - 10:00pm Eastern Time)
  34.  
  35.  
  36.                     Electronic mail on GEnie     : ORION.MICRO
  37.                                        CompuServe: 72240,1221
  38.  
  39.  
  40.  
  41.      Program and Documentation are Copyright (c) 1990 by Keith Ledbetter.
  42.                              All rights reserved.
  43.  
  44.  
  45.   Portions Copyright Borland, International.  LCD was written with Turbo C++.
  46.  
  47.  
  48.     This program is produced by a member of the Association of Shareware
  49. Professionals (ASP).  ASP wants to make sure that the shareware principle
  50. works for you. If you are unable to resolve a shareware-related problem with
  51. an ASP member by contacting the member directly, ASP may be able to help. The
  52. ASP Ombudsman can help you resolve a dispute or problem with an ASP member,
  53. but does not provide technical support for members' products. Please write to
  54. the ASP Ombudsman at P.O. Box 5786, Bellevue, WA 98006 or send a Compuserve
  55. message via easyplex to ASP Ombudsman 70007,3536.
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.    LCD Registration Form         Keith Ledbetter
  65.                                  4240 Ketcham Drive
  66.                                  Chesterfield, VA  23832
  67.  
  68.  
  69.    LCD Version 2.0x                            Quantity    Price
  70.  
  71.    Disk with branding utility ($15/copy):      _______   __________
  72.  
  73.         Total enclosed                                   __________
  74.  
  75.    Please make payment by check or money order (in US funds) payable
  76.    to "Keith Ledbetter".
  77.  
  78.    Please specify the diskette size(s) that are acceptable for you:
  79.  
  80.    ___ 5.25" 1.2MB   ___ 3.5" 1.44MB   ___ 5.25" 360KB   ___ 3.50" 720KB
  81.  
  82.  
  83.    Name    ________________________________________________________
  84.  
  85.    Company ________________________________________________________
  86.  
  87.    Address ________________________________________________________
  88.  
  89.            ________________________________________________________
  90.  
  91.    Phone   ________________________________________________________
  92.  
  93.  
  94.    Where did you get LCD?  _________________________________________
  95.  
  96.    Multi-System and Reseller Licenses:
  97.  
  98.         Site, corporate, network, and reseller licenses are available
  99.         for LCD.  Check the line on the order form or contact me for
  100.         more information.  The following schedule provides some
  101.         examples of multi-system license fees.  The fee includes one
  102.         master diskette which you may then copy and use on the number
  103.         of machines listed below:
  104.  
  105.                         # Users        Price
  106.                         -------       -------
  107.                            5        $   70.00   ($14 / copy)
  108.                           10           130.00   ($13 / copy)
  109.                           25           300.00   ($12 / copy)
  110.                           50           550.00   ($11 / copy)
  111.                          100         1,000.00   ($10 / copy)
  112.                        Unlimited     1,500.00
  113.  
  114.                           Led's Change Directory                    Page 1
  115.  
  116.  
  117. Definition of ShareWare
  118.  
  119.  
  120.  
  121.     Shareware distribution gives users a chance to try software before
  122.     buying it.  If you try a Shareware program and continue using it,
  123.     you are expected to register. Individual programs differ on details
  124.     -- some request registration while others require it, some specify
  125.     a maximum trial period. With registration, you get anything from the
  126.     simple right to continue using the software to an updated program with
  127.     printed manual.
  128.  
  129.     Copyright laws apply to both Shareware and commercial software,
  130.     and the copyright holder retains all rights, with a few specific
  131.     exceptions as stated below. Shareware authors are accomplished
  132.     programmers, just like commercial authors, and the programs are
  133.     of comparable quality. (In both cases, there are good programs
  134.     and bad ones!) The main difference is in the method of
  135.     distribution. The author specifically grants the right to copy
  136.     and distribute the software, either to all and sundry or to a
  137.     specific group. For example, some authors require written
  138.     permission before a commercial disk vendor may copy their
  139.     Shareware.
  140.  
  141.     Shareware is a distribution method, not a type of software. You
  142.     should find software that suits your needs and pocketbook,
  143.     whether it's commercial or Shareware. The Shareware system makes
  144.     fitting your needs easier, because you can try before you buy.
  145.     And because the overhead is low, prices are low also. Shareware
  146.     has the ultimate money-back guarantee -- if you don't use the
  147.     product, you don't pay for it.
  148.  
  149.                           Led's Change Directory                    Page 2
  150.  
  151.  
  152. Disclaimer - Agreement
  153.  
  154.  
  155.  
  156.     Users of LCD must accept this disclaimer of warranty:
  157.     "LCD is supplied as is.  The author disclaims all
  158.     warranties, expressed or implied, including, without limitation,
  159.     the warranties of merchantability and of fitness for any purpose.
  160.     The author assumes no liability for damages, direct or conse-
  161.     quential, which may result from the use of LCD."
  162.  
  163.     LCD is a "shareware program" and is provided at no charge
  164.     to the user for evaluation.  Feel free to share it with your
  165.     friends, but please do not give it away altered or as part of
  166.     another system.  The essence of "user-supported" software is to
  167.     provide personal computer users with quality software without
  168.     high prices, and yet to provide incentive for programmers to
  169.     continue to develop new products.  If you find this program
  170.     useful and find that you are using LCD and continue to use
  171.     LCD after a reasonable trial period, you must make a reg-
  172.     istration payment of $15 to Keith Ledbetter.  The $15
  173.     registration fee will license one copy for use on any one
  174.     computer at any one time.  You must treat this software just like
  175.     a book.  An example is that this software may be used by any
  176.     number of people and may be freely moved from one computer
  177.     location to another, so long as there is no possibility of it
  178.     being used at one location while it's being used at another.
  179.     Just as a book cannot be read by two different persons at the
  180.     same time.
  181.  
  182.     Commercial users of LCD must register and pay for their
  183.     copies of LCD within 30 days of first use or their license
  184.     is withdrawn.  Site-License arrangements may be made by con-
  185.     tacting Keith Ledbetter.
  186.  
  187.     Anyone distributing LCD for any kind of remuneration must
  188.     first contact Keith Ledbetter at the address below for authorization.
  189.     This authorization will be automatically granted to distributors
  190.     recognized by the (ASP) as adhering to its guidelines for
  191.     shareware distributors, and such distributors may begin offering
  192.     LCD immediately (However Keith Ledbetter must still be advised so
  193.     that the distributor can be kept up-to-date with the latest
  194.     version of LCD.).
  195.  
  196.     You are encouraged to pass a copy of LCD along to your
  197.     friends for evaluation.  Please encourage them to register their
  198.     copy if they find that they can use it.  All registered users
  199.     will receive a copy of the latest version of the LCD
  200.     system.
  201.  
  202.                           Led's Change Directory                    Page 3
  203.  
  204.  
  205. About the Program
  206.  
  207.  
  208.  
  209.  
  210.    LCD is a program designed to make changing directories much easier,
  211. especially when you have a large hard drive with lots of different partitions.
  212.  
  213.    LCD is a work-alike to Peter Norton's NCD command, but with one significant
  214. difference.   LCD works "across all drives" by maintaining the directory
  215. database of ALL drives on drive C:, instead of one database on each individual
  216. drive like NCD does.   This means that you don't have to specify a drive letter
  217. when changing across drives, like you do with NCD.
  218.  
  219.  
  220.  
  221. About the Syntax:
  222.  
  223.   LCD partial_directory_name : change to a directory
  224.   LCD md directory_name      : create directory; update database now
  225.   LCD rd directory_name      : delete directory; update database now
  226.   LCD /scan  [drivelist]     : scan drives and build directory database
  227.   LCD /escan [drivelist]     : scan drives (see directories with extensions)
  228.  
  229.  
  230.  
  231. Changing directories:
  232.  
  233.    LCD is used to quickly switch between directories across any of your
  234.    hard drives.  You simply invoke LCD and give it the full or partial name
  235.    of the directory you wish to change to.  For example, if you have a
  236.    directory named C:\PROCOMM\DOWNLOADS, you could switch to this directory
  237.    with the command:
  238.  
  239.                      C:> LCD down
  240.  
  241.    LCD will first try to do an immediate change to the directory name that
  242.    you specify.  If that change works, LCD simply exits immediately. If it
  243.    fails, then LCD looks into your directory database and tries to figure
  244.    out the directory name that you wanted by doing fuzzy comparisons.  If
  245.    more than one directory existed with the same partial name that you
  246.    gave to LCD, it will display a scrollable dialog box on the screen
  247.    containing all of the matches found.   Simply use the arrow keys to
  248.    highlight the path that you want to change to, then hit <Enter>.
  249.  
  250.  
  251.  
  252. Scanning directories:
  253.  
  254.    The first time you execute LCD, you must specify the /SCAN parameter
  255.    ("LCD /scan") which instructs LCD to scan all of your hard drives and
  256.    build a file called LCD.IDX in the root directory of drive C.  You will
  257.    need to periodically rescan all of your drives to add to the table any
  258.    new directories that you have created.
  259.  
  260.  
  261.                           Led's Change Directory                    Page 4
  262.  
  263.  
  264. About the Program
  265.  
  266.  
  267.    If you only want LCD to know about certain specific drives (ie: only
  268.    non-network drives), you can specify a drive list after the /SCAN
  269.    keyword.  To have LCD only scan drives C, E, F, and G, you'd do this:
  270.  
  271.                      C:> LCD /SCAN CEFG
  272.  
  273.    If you have subdirectories which have an extension in their name (for
  274.    example, C:\PROGRAMS.OLD\) then you must specify /ESCAN instead of
  275.    /SCAN.  This causes LCD to see those directories, but the scan time
  276.    will be almost 50% slower.
  277.  
  278.  
  279.  
  280. Direct database updating:
  281.  
  282.    You can also use LCD to create and remove directories with immediate
  283.    database updating.   This means that you don't have to continually
  284.    scan your drives to update the directory database.  LCD will create or
  285.    delete the directory specified, and then update the LCD.IDX database at
  286.    the same time.   For example, to create a directory on drive F: and put
  287.    that directory in the database, you'd do:
  288.  
  289.                      C:> LCD md f:\test
  290.  
  291.    This ability comes in especially handy for users of command shells that
  292.    allow aliasing, such as CED and 4DOS.  With these utilities, you can
  293.    change the standard MD and RD commands to invoke LCD instead.  With 4DOS,
  294.    you'd set up the aliases like this:
  295.  
  296.                      C:> alias md `lcd md %1`
  297.                      C:> alias rd `lcd rd %1`
  298.                      C:> alias cd `lcd %1`
  299.  
  300.  
  301.  
  302. The LCD environment variable:
  303.  
  304.    If you'd rather have LCD keep its LCD.IDX database somewhere other than
  305.    the root directory of drive C:, you can specify the drive you want used
  306.    in the LCD environment variable.  For example, if you'd rather keep the
  307.    LCD.IDX file on drive D:, you should put "SET LCD=D" in your AUTOEXEC.BAT
  308.    file.
  309.  
  310.                           Led's Change Directory                    Page 5
  311.  
  312.  
  313. About the Program
  314.  
  315.  
  316.  
  317.  
  318. Bulletin Board Numbers:
  319.  
  320.  
  321.   You can always find the latest versions of all of my PC utilities (such
  322. as WhereIs, LCD, DelDir, AdMenu, etc.) on the following BBS's:
  323.  
  324.  
  325.          Name               Location          Number
  326.    ------------------      ----------       ------------
  327.    Blue Ridge Express      East coast       804-790-1675  (21 lines)
  328.    Hard Disk Cafe          Midwest          618-684-3990  (file area "Z")
  329.    C & C                   Midwest          618-253-3608
  330.    ATT-PAC                 West coast       415-829-6062
  331.  
  332.  
  333.  
  334.                           Led's Change Directory                    Page 6
  335.  
  336.  
  337. Revision History
  338.  
  339.  
  340.  
  341.  v2.0  12/01/90   o Simply an oversight: v1.4 would update the directory
  342.                     database if you used LCD to create a directory on
  343.                     drive A: or B:.  LCD no longer updates the directory
  344.                     database if you use it to make or remove a directory
  345.                     on these drives (this was probably only apparent to
  346.                     those of us who "alias" MD and RD to use LCD.EXE).
  347.  
  348.  v1.5 - v1.9      o These version numbers were skipped.
  349.  
  350.  v1.4  11/24/90   o LCD can now be used as a TOTAL replacement for DOS's
  351.                     "cd", "rd", and "md" commands.  LCD will now try to
  352.                     immediately change to the directory name that you
  353.                     specify; if that fails, only then will it go to the
  354.                     directory database to search for fuzzy matches.  In
  355.                     other words, if you have the following two directories
  356.                     somewhere:
  357.  
  358.                                     C:\TELIX\DOWNLOAD
  359.                                     C:\PROCOMM\DOWNLOAD
  360.  
  361.                     and you are currently in the C:\PROCOMM directory, then
  362.                     "LCD download" will change you to the \PROCOMM\DOWNLOAD
  363.                     directory without invoking the dialog box.
  364.  
  365.                   o LCD can now create and delete directories itself, with
  366.                     immediate updating of the directory database at the
  367.                     same time.  The syntax is:
  368.  
  369.                                  LCD md directory_name
  370.                                  LCD rd directory_name
  371.  
  372.                     These commands are most useful when used with an
  373.                     aliasing shell like CED or 4DOS.  Since I use 4DOS,
  374.                     I have aliases set up as follows:
  375.  
  376.                                  alias cd `lcd %1`
  377.                                  alias md `lcd md %1`
  378.                                  alias rd `lcd rd %1`
  379.  
  380.                   o You can now set an environment variable named LCD to
  381.                     the drive that you'd like your LCD.IDX file stored on
  382.                     (for example, SET LCD=D tells LCD to maintain your
  383.                     database in the file D:\LCD.IDX).  If there is no LCD
  384.                     environment variable, the file will be kept on drive
  385.                     C: just like before.
  386.  
  387.                   o When in the scrollable dialog box, you now have use of
  388.                     the full movement keys (PgUp, PgDn, Home, End, arrow
  389.                     keys).  You can also press C through Z to immediately
  390.                     go to that drive's directories.  This is most useful
  391.                     when doing "LCD *" to see all names in the database.
  392.  
  393.                           Led's Change Directory                    Page 7
  394.  
  395.  
  396. Revision History
  397.  
  398.  
  399.  
  400.  v1.3  10/15/90   o Fixed a bug where LCD would get confused if you had a
  401.                     one-letter directory name, and that letter also occurred
  402.                     in its parent directory (ie: "c:\aRc\R").
  403.  
  404.                   o Of course, the above change can be a problem if (a) you
  405.                     have a one-character directory name, as in R, and you
  406.                     also have a lot of other directories that begin with R.
  407.                     So, I have changed LCD so that it understands an asterisk
  408.                     ('*') as a wildcard character.  Some examples are the
  409.                     easiest way to explain:
  410.  
  411.                         LCD r*      :   find all paths that BEGIN with the
  412.                                         letter 'r'.
  413.                         LCD *on     :   find all paths that have the word
  414.                                         "on" in them.
  415.                         LCD *       :   show me all paths in the database.
  416.  
  417.                  o   A few people wanted to be able to change to either
  418.                      (a) the parent directory, or (b) the root directory
  419.                      while still using LCD.  LCD will now allow this,
  420.                      so you can do:
  421.  
  422.                          LCD ..              ;go up one level
  423.                          LCD \               ;go to the root.
  424.  
  425.  v1.2  10/11/90   o  A lot of people (in fact, everyone who has contacted
  426.                      me) have suggested that LCD should give the highest
  427.                      priority to the first positions of the pathname
  428.                      specified.  In other words, if you have the following
  429.                      two paths on your hard drive:
  430.  
  431.                               c:\testing\programs
  432.                               c:\atest\data
  433.  
  434.                      then "LCD TEST" should change to the \testing\
  435.                      directory immediately.   v1.2 now does this.
  436.  
  437.                   o Overall, the matching logic in v1.2 has been greatly
  438.                     improved.  It now does a much better job of figuring
  439.                     out what you really wanted it to do.  But, it will
  440.                     probably help if you know exactly how LCD does it's
  441.                     searching.  In a nutshell, here is what LCD does:
  442.  
  443.                         1.  Look for an EXACT match on the directory name
  444.                             specified.  If more than one found, display
  445.                             the dialog box. If none found, go to step 2.
  446.  
  447.                         2.  Look for a "fuzzy" match on the name. By LCD's
  448.                             standards, a fuzzy match is the name you
  449.                             specified followed by any extra data.  For
  450.                             example, if you specify "LCD data", then all
  451.  
  452.                           Led's Change Directory                    Page 8
  453.  
  454.  
  455. Revision History
  456.  
  457.  
  458.                             of the following would match:
  459.  
  460.                                 c:\data1
  461.                                 c:\database
  462.                                 f:\dataset
  463.  
  464.                             If more than one match found, display the
  465.                             dialog box. If none found, go to step 3.
  466.  
  467.                         3.  At this point, LCD just looks for the partial
  468.                             string anywhere in a path name, preceeded or
  469.                             followed by any characters.
  470.  
  471.                   o Since so very few people use extensions on their
  472.                     directory names, I changed the logic to once again
  473.                     use "*." for directory searches instead of "*.*".
  474.                     This speeds the /SCAN function up by about 50%.  If
  475.                     you have directory names with extensions on them,
  476.                     then you must use the /ESCAN switch instead of /SCAN.
  477.                     Operation is the same, except that LCD will then use
  478.                     the slower scanning method.
  479.  
  480.  v1.1  10/04/90   o Since the .IDX file is stored a little differently,
  481.                     you MUST do a /SCAN before using LCD v1.1 (this is
  482.                     for those of you currently using v1.0).
  483.  
  484.                   o LCD is now much smarter on "fuzzy" directory names.
  485.                     For example, "lcd pcp" will now change you to your
  486.                     "d:\pcplus" directory always, even if you have
  487.                     "pcplus\downloads" and "pcplus\uploads", etc.
  488.  
  489.                   o When LCD can't figure out which directory you really
  490.                     want, it will now pop up a scrollable dialog box with
  491.                     all of the matches found in it.  You simply move the
  492.                     highlight bar to the directory that you want, and then
  493.                     press <Enter>.
  494.  
  495.                     A lot of people requested something like this, and I
  496.                     wasn't sure how I was going to like it at first.  But,
  497.                     after playing with it for a couple of days, I think it
  498.                     was a good idea.  It's much more logical than LCD trying
  499.                     to "cycle" through all of the matches one invocation at
  500.                     a time.
  501.  
  502.                   o A few people also complained about LCD not seeing
  503.                     directories that have an extension on them
  504.                     (ie: MYDATA.DIR).  I still can't sneak by anybody on
  505.                     this issue!  So, LCD v1.1 now sees directories with
  506.                     extensions;  you will notice that the /SCAN function
  507.                     takes around twice as long to run now.
  508. End of document.
  509.