CARECOM(R) ccd Version 1.5 Copyright (C) 1993 by CARECOM(R), Dipl.-Inform. Harald Muehlhoff, Germany CARECOM(R) ccd is a shareware utility that enables you to change directories quickly without completely specifying pathes. --- Main features: --------------------------------------------------------- - Compatible with MS-DOS(TM) and Microsoft(R) Windows NT(TM) - Compatible with networks for not creating (trying to create) files in other locations than its program/data directory. The directory trees and other data files can be made user local by setting an environment variable (Different users might "see" different parts of the directory hierarchies) - If a directory isn't found a directory tree rescan is started automatically (The user might not always be at fault! This feature can be disabled ;-) - You can partly qualify a path to make your search key less ambiguous, e.g. you are able to search for a directory "home" that is in a parent directory with a name ending with "et" (like sweet): "ccd et\home" - The search for inexact matches can be disabled. Registered version only: - Program output can be selectively disabled. - You can quickly go back to the directory you last changed from. - You can define a home directory that you can quickly "return" to. --- Requirements: ---------------------------------------------------------- - MS-DOS(TM) 3.0 or higher - OR - - Microsoft(R) Windows NT(TM) operating system with FAT or NTFS partitions (Tested with Preliminary Release March 1993; should run on the final release) --- How to install CARECOM(R) ccd: ----------------------------------------- 1. Copy the ccd files to a directory where you want them to remain permanently 2. Execute "install.bat". The installation batch file will give you detailed information on how to complete the installation of ccd. You may run the installation batch file under either MS-DOS(TM) or Windows NT(TM). Note: During operation ccd might create the following files in the directory specified by the environment variable "CCDDATADIR". If the environment variable is undefined, these files are stored in the ccd program directory (the directory that contains the files ccd2.exe and ccd2i386.exe). ccd.cfg home.ccd back.ccd dirtree.a ... dirtree.z Please make sure that you don't have any files with the same names in the ccd program directory. Note: If multiple users in a LAN want to use one copy of ccd (e.g. on a fileserver harddisk), please make sure that the environment variable CCDDATADIR is set to a different directory for every user. Include the set statement in the login script. --- ccd is shareware: ------------------------------------------------------ You may use ccd on a trial basis for a 15 day evaluation period. Please read the license agreement below for information on how to register. Please note that the options marked as registered version only will be ignored if used with an unregistered version of ccd. --- How to use CARECOM(R) ccd: --------------------------------------------- 1. Use it as a replacement for the dos command cd. In many cases using ccd will have the same effect as using cd, e.g.: cd .. ccd .. cd \home\sweet\home ccd \home\sweet\home Please note however that even with fully qualified names there are some differences: Let's assume your current drive is "A:". If you type "cd c:\home" the current directory for drive "C:" will be changed to "home"; but your current drive won't change. As the main reason for ccd is to bring you to a directory as fast as possible, typing "ccd c:\home" will change the current drive to "C:". 2. Use it to go directly to a directory without giving a fully qualified path or even a full filename Let's assume the following directory hierarchy: c:\ -- home -- sweet -- home | | |- dos +- food | +- cpp -- h If your current directory is "\" on drive "C:" you would have to type "cd home\sweet\food" to change to directory "food". Using ccd typing "ccd f" would do the job. If you want to change to directory "home" typing "ccd home" will bring you to either "c:\home" or "c:\home\sweet\home" depending on your current directory. Once you are in one of the "home"-directories typing "ccd home" - or just "ccd ho" - will bring you to the other one. To change to directory "h" you just have to enter "ccd h". Reentering "ccd h" will leave you in directory "h" because ccd found a `perfect match'. There could be many directories beginning with the letter "h"; if you want to go to directories beginning with "h" type "ccd h*". Typing this several times - or using the F3 function key to repeat the previous input - will bring you from "c:\cpp\h" to "c:\home" to "c:\home\sweet\home" and back to "c:\cpp\h" etc... The wildcard character "*" is allowed only as the last character of the search key, e.g. "h*". You can partly qualify a path to make your search key less ambiguous. By entering "ccd t\h" you specify that you're only looking for directories with names beginning with the letter "h" that are contained in directories ending with the letter "t". Therefore the only candidate in our example is the directory "c:\home\sweet\home". ^^^ Typing "ccd sweets" will bring you to the directory "c:\home\sweet" since this is the closest match. "ccd sx" would also take you to this directory because it is the only directory beginning with the letter "s". If you prefer an error message over this kind of matching, add the option "/exact match" - or "/ex" for short - to your ccd command line or configuration file. 3. Use ccd to return to the directory you last ccd'ed from (registered version only) Entering "ccd /b" or "ccd /back" will take you back to the directory you last changed away from. Let's assume your current directory is "\home\sweet\home". After typing "ccd d", you find yourself in the dos-directory. To return to "\home\sweet\home" you just have to enter "ccd /b". 4. Use ccd to return to your `home' directory (registered version only) Given that you are working on a project with most of the files stored in directory "\cpp" you could define "\cpp" as your `home' directory. Every time you want to return to this directory, just type "ccd /h" or "ccd /home". To define your home directory enter "ccd /define home \cpp". More options: Beside the options mentioned above, i.e. "/install", "/exact match", "/back", "/home" and "/define home", there are several other options: /rescan Force a rescan of the directory structure for the default /r or given drive. Normally the use of this option isn't required, for ccd automatically starts a rescan if it either doesn't find a `good' match for the given search key or if there is evidence that the directory structure has changed since the last - possibly automatic - rescan done by ccd. (Such evidence could be that the current directory isn't included in the directory list maintained by ccd.) Before accepting an inexact match like "c:\home\sweet" for search key "sx" (see 2.), a directory rescan will be performed if the option "/norescan" isn't given. /norescan Disable automatic rescan of directory structure. This /n option is most useful if added to the configuration file for installations with very large and seldomly changing directory hierarchies. This option can be overwritten by using the "/rescan" option. /case sensitive Perform case sensitive matching. This option is most /c useful with NTFS partitions. The case matching must be exact; e.g. "AbC" doesn't match "abC". More options (registered version only): /verbose Display all messages. /v /quiet Suppress all only informational messages. /q /mute Suppress all messages - including error messages - /m not specifically asked for (by including an option like "/help"). /disable backlog Don't save the current directory when changing away from it --- License Agreement: ----------------------------------------------------- The use of CARECOM(R) ccd - ccd for short - is subject to the following terms and conditions. ccd is copyrighted material. It is protected by international copyright laws. You may not make any changes or modifications to ccd. You may not decompile, disassemble, or otherwise reverse-engineer the software in any way. You may use ccd on a trial basis provided you do not violate the protection provided to the licensed software by the copyright laws, and you agree to the terms of the license agreement. If you continue to use ccd past a 15 day evaluation period you are obligated to purchase a license for its use. You may use ccd on a Local Area Network provided that a license is obtained for the number of users that may concurrently use the software. A license for the use of ccd can be obtained by filling out the enclosed regccd.frm and (e)mail/fax it to the address given below. CARECOM(R) Dipl.-Inform. Harald Muehlhoff Gustav-Vorsteher-Strasse 14 D-58300 Wetter/Ruhr Germany Fax: +49-2335-3821 CompuServe: 100112,2466 Internet: 100112.2466@compuserve.com (Support only) After registration you will receive a letter with a personal key that enables you to use all options in this and all future versions of ccd with the same major version number. Title to the licensed software is NOT transferred to the end user. The end user is granted an exclusive license to use the software on one computer or computer work station at any given time. --- Limited Warranty: ------------------------------------------------------ CARECOM(R) does not warrant that the licensed software will meet your requirements or that the operation of the software will be uninterrupted or error free. The warranty does not cover any media or documentation which has been subjected to damage or abuse by you or others. The software warranty does not cover any copy of the licensed software which has been altered or changed in any way. ANY IMPLIED WARRANTIES INCLUDING ANY WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE ARE LIMITED TO THE TERM OF THE EXPRESS WARRANTIES. Some States do not allow limitations on how long an implied warranty lasts, so the above limitation may not apply to you. The warranties set forth above have priority over any and all other express or implied warranties, whether oral, written, or implied, and the remedies set forth above are the sole and exclusive remedies. CARECOM(R) is not responsible for any problems or damage caused by the licensed software that may result from using the licensed software. This includes, but is not limited to, computer hardware, computer software, operating systems, and any computer or computing accessories. The end user agrees to hold CARECOM(R) harmless for any problems arising from the use of the software. CARECOM(R) SHALL NOT IN ANY CASE BE LIABLE FOR ANY SPECIAL, INCIDENTAL, CONSEQUENTIAL, INDIRECT OR OTHER SIMILAR DAMAGES ARISING FROM ANY BREACH OF THESE WARRANTIES EVEN IF CARECOM(R) OR ITS AGENTS OR DISTRIBUTORS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. Some states do not allow the exclusion or limitation of incidental or consequential damages, so the above limitation or exclusion may not apply to you. In no case shall CARECOM's liability exceed the license fees paid for the right to use the licensed software. --- ccd Distribution: ------------------------------------------------------ You are granted a limited license to copy ccd only for the trial use of others subject to the terms of this software license agreement described herein, and if the conditions described below are met: ccd MUST be copied in an unmodified form and MUST contain the following files: readme.txt install.bat regccd.frm ccd2i386.exe ccd2.exe The archive storage format may be changed as long as the other conditions are met. No fee, charge or other compensation may be accepted or requested by anyone without the express written permission of CARECOM(R). Distributors of public domain and user supported software, such as disk vending services, may not charge a fee for ccd itself. However you may include ccd on a diskette for which you charge a nominal distribution fee. The purchaser of said diskette must be informed in advance that the fee paid to acquire the diskette does NOT relieve said purchaser from paying the Registration Fee for ccd. Operators of electronic bulletin board systems (Sysops) may post ccd for downloading by their users without written permission only as long as the above conditions are met. A fee may be charged for access to the bbs as long as no specific fee is charged for downloading ccd files without first obtaining express written permission from CARECOM(R) to charge such a fee. The above constitutes the license agreement for ccd. It superceeds any and all previous license agreements. -------------- MS-DOS and Windows NT are trademarks of Microsoft Corporation. CARECOM is the house mark to identify all products and services which originate from CARECOM(R).