home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 570.lha / ccd_v2.4 / ccd.doc.pp / ccd.doc
Encoding:
Text File  |  1991-10-24  |  7.4 KB  |  216 lines
  1.  
  2.                         CCD - Cedric's CD utility
  3.  
  4.                                              Cedric BEUST
  5.                                              13, bd du Ponant
  6.                                              83700, ST-RAPHAEL
  7.                                              FRANCE
  8.  
  9.                                              email: beust@taloa.unice.fr
  10.  
  11.  
  12. [Warning: this doc is slightly out of date by now. Refer to the file
  13.  Versions for more recent informations]
  14.  
  15.  
  16.       WHAT IS CCD?
  17.       ------------
  18.  
  19.   ccd is an attempt to have the equivalent to M*-DOS ncd (Norton's cd).
  20. This smart utility is most precious for hard disk users: it allows to cd
  21. to a directory without having to specify the whole path.
  22.  
  23.   For example, if you have a directory dh0:dp/matt/netdcc, just issue the
  24. command
  25.  
  26.        (0).3:51PM> ccd netdcc
  27.  
  28. and there you are!
  29.  
  30.  
  31.       LEGAL STUFF
  32.       -----------
  33.  
  34.   Why bother? Nobody ever reads it, anyway...
  35.  
  36.   Okay, this program is *not* in public domain. It is freeware, and I hold
  37. the copyright on the source, documentation and executable (uh... not so
  38. sure this can be done).
  39.  
  40.   Clearly, that means that you are free (and welcomed) to give the whole
  41. distribution to anyone you want, provided
  42.  
  43. * You don't earn any money doing so
  44. * You don't modify any of the files in the distribution without a prior
  45.   consent from me
  46.  
  47.   And now, on to more interesting things.
  48.  
  49.  
  50.       TO MAKE IT WORK...
  51.       ------------------
  52.  
  53.   ccd is very easy to install.
  54.  
  55. 1) put the ccd command in your c: directory
  56.  
  57. 2) assign CCD: to the directory you would like the config file to go (see
  58.    below for further explanations about this file); I suggest you choose s:
  59.  
  60. 3) run 'ccd -u dh0: dh1: dh2:' for example, if you often cd into these
  61.    directories (or subdirectories of theirs). This will create the
  62.    configuration file
  63.  
  64. 4) et voila!
  65.  
  66.  
  67.       OPTIONS OF CCD
  68.       --------------
  69.  
  70.   ccd -c <dir> <dir>            e.g    ccd -u DH0: DH1:
  71.  
  72.          Create the file CCD:.ccdconfig with the recursive
  73.          list of directories in each volume given
  74.  
  75.   ccd -a <name>                 e.g    ccd -a sys
  76.  
  77.          List all ambiguities, i.e. all the paths that contain
  78.          the name you gave.
  79.  
  80.   ccd -n <name>                 e.g    ccd -n c:
  81.  
  82.          Change to dir name without expanding the pathname. In
  83.          the example given, the displayed dir will be 'c:'.
  84.  
  85.   ccd <name>                    e.g    ccd c:
  86.  
  87.           Change to what is closest to the name you gave. The
  88.           displayed dir would be for example 'DH0:C'.
  89.  
  90.   ccd
  91.  
  92.           Bring up the graphic representation of your directories.
  93.           This is a beta version so far, so there is little you can
  94.           do (mainly, just click on the directory you wish to cd to).
  95.  
  96.  
  97.       HOW DOES IT WORK?
  98.       -----------------
  99.  
  100.   The current version (2.0 beta) is still very crude. I just wanted to
  101. write something that would work quick and dirty. The configuration file is
  102. a mere recurrent list of all the subdirectories that exist in the root
  103. volumes you specified. When you invoke ccd, it simply parses this file,
  104. looking for the fragment of path you gave. If it finds one, it returns the
  105. entire line it read in the file.
  106.  
  107.   Since the version 1.4, you can specify just a part of the directory. For
  108. example, you could ask a 'ccd sys' to change to (...)/system.
  109.  
  110.   Of course, there may be ambiguities. Assume I want to cd to a 'lib'
  111. directory, but that several of them exist in the list I provided. By
  112. default, ccd will cd into the first one, but maybe that's not what you
  113. wanted. There are two ways to solve this problem.
  114.  
  115.   First, I ask the ambiguities of the name I'm looking for:
  116.  
  117. (0).3:51PM> ccd -a lib 
  118. dh0:lattice/lib 
  119. dh1:DP/netdcc/include/lib
  120. dh1:DP/gcc/lib 
  121. dh1:uucp1/lib
  122.  
  123.   If I want to cd to dh1:DP/gcc/lib, I just have to type
  124.  
  125. (0).4:01PM> ccd lib 3 
  126. Current directory now dh1:DP/gcc/lib
  127.  
  128.   I confess it may be a bit cumbersome to use, but nevertheless, it might
  129. be shorter than typing the whole path anyway. The second way can also be
  130. used to make this task lighter: in case of ambiguities, you will probably
  131. notice that you cd to one directory more often than the others. So, since
  132. ccd changes to the first one it finds in the config file, you could use
  133. this feature and edit the CCD:.ccdconfigfile to put this directory before
  134. the other ones.
  135.  
  136.   One other problem you might face is that ccd can't find a directory
  137. whereas you know it exists. The solution is, of course, that this
  138. directory was created after you built the configuration file (the same
  139. goes for deletion of directories as well). When this happens, all you have
  140. to do is re-run 'ccd -u <dirs>' in order to update this file. If your hard
  141. disk is very slow and you know it's gonna take some time, you can add the
  142. new directory manually in the file as well (on my Quantum HD, updating the
  143. file for about 30M of directories takes less than 30 secs...).
  144.  
  145. CAVEAT:   The -u name is badly chosen, since ccd actually rebuilds the
  146.           config file from scratch. I'm thinking about renaming this
  147.           option -r.
  148.  
  149.  
  150.       CONSIDERATIONS ON THIS PROGRAM
  151.       ------------------------------
  152.  
  153.   As I told before, this is a very early version and I have many ideas of
  154. improvement. Among them:
  155.  
  156. o     Modify the Createdir() and DeleteFile() vectors in the dos.library in
  157.       order to save the user from updating the file themselves. This way,
  158.       whenever a directory is created/deleted, the configuration file is
  159.       automatically updated.
  160.  
  161. o     Create a more user-friendly interface, maybe even a graphic one,
  162.       that would display the tree on the screen if no argument is given. The
  163.       user would then just have to click on the directory they want to
  164.       change to (done since 2.0 beta).
  165.  
  166.   However, I wonder about the interest of such improvements. For example,
  167. some users could not appreciate to see dos.library vectors modified, and
  168. this could be mistaken with a virus in action... The graphic interface
  169. would increase the program size (which is already rather big for such a
  170. little command), and so on...
  171.  
  172.   That's why I need to hear feedbacks from you! Please, let me know what
  173. you think of ccd. You can reach me either by snail-mail or email
  174. (preferably by email, it's soooo faster :-)).
  175.  
  176.  
  177.       THANKS
  178.       ------
  179.  
  180. -->  Cedric NEROT,
  181.                    aka Sr, aka Cedric the 2nd,
  182.                    it was an idea of his, and since he's taller and
  183.                    stronger than me, I have to give his name. In
  184.                    retaliation, I hid a virus in his version (snigger,
  185.                    snigger). And he will never read the doc, anyway.
  186.  
  187. --> Pierre ARDICHVILI,
  188.                    for numerous advice, mainly regarding PAL/NTSC detection
  189.                    and better '-u' handling.
  190.  
  191. --> David MOLINIER,
  192.                    for beta-testing and pointing out a few bugs to me.
  193.  
  194. --> PowerWindows,
  195.                    well, their authors actually. How precious!!!
  196.  
  197. -->  Matt DILLON,
  198.                    for providing us with such a neat compiler! And for the
  199.                    help along the way... And for uucp. And for dmouse. And
  200.                    for the Cosby Show. And for the electric tooth brush.
  201.                    And for the space shuttle. And for... ouch! [sacked by
  202.                    audience]
  203.  
  204. -->  abcd!Leon,
  205.                    for pointing out to me the 'ccd /' bug that was fixed
  206.                    on from the version 1.4 (sorry, Leon, my mails to you
  207.                    bounced each time I tried, so I don't know more from
  208.                    you...)
  209.  
  210.  
  211. ---    Cedric BEUST
  212. ---    Nice, May 8th, 1991
  213.  
  214.  
  215.  
  216.