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