CDP (Cliff's Directory Program) is Copyright (C) 1989 by Cliff Roberson dba GoodWare, 926 Leighton Way, Sunnyvale, CA. 94087 All Rights Reserved In the United States and Worldwide Getting Started With CDPSW -------------------------- The main purpose of this file is to enable you to have CDPSW running properly as fast as possible. Secondarily, it is to draw your attention to the notice above and the stipulations at the end of this file. Note that there are 3 versions of CDP, with the names CDP, CDPW2, and CDPSW. Each of these must be run under its proper name. If you rename the file to something else, it will lose its Help capability! CDPSW is shareware, and behaves slightly differently because of the shareware screens which it must display; but it has all the functionality of the "registered CDP. CDP is primarily for systems with a hard disk. It is overkill for a floppy-only system. CDP requires DOS 2.0 or higher. It requires up to 175KB of memory when it is started. But if it is resident as a TSR and swapping to EMS or a disk, then it effectively releases all but 9KB for use by other programs. ----------------------------- Special Note for the Overeager Who Have Certain Two-color Monitors: If you have a non-color monitor that shows colors as shades of dark, CDP may be fooled into thinking you have a color monitor. Compaqs and many laptops behave in that way. If the cursor is all wrong, etc., add a Y to the command line, for instance: CDPSW Y (and CDP will use more visible monochrome colors) Running CDP ----------- Use The Help The function keys F1, F2, and F3 offer voluminous help at any time. Use them!! F1 is contextual (about whatever function the menu cursor is on). F2 tells you all about cursors and how to navigate the menus. F3 tells you about the hot keys (you can do it with menus or you can do it with a single keystroke). Use the Help Keys! There are 340 help screens!! Installing CDPSW ---------------- If you simply unpack the CDP package to any directory (including root), you have essentially installed it. Unlike other programs, CDP does not require any SET statements or special paths. If CDPSW.EXE is on your path or in your logged directory, just type: CDPSW If you printed this file by having CDPSW do it, we apologize for repeating information you already have discoverd by yourself. If CDPSW is not on your path or in your directory, just type X:PATH\CDPSW where X:PATH is whatever is required to get to CDPSW. If You Can't Access the Help ---------------------------- CDP gets its help screens by reading file CDP.EXE itself. It will usually find and read itself with no problem. It will not be able to find itself if it has been renamed to anything else. (Similarly, CDPW2 gets its help from CDPW2.EXE.) The only known problem occurs if CDP is run from a network disk. CDP cannot read from a network disk. CDPSW, because of the way the shareware screens were implemented, must normally be run in the current directory. If you invoke it by X:PATH\CDPSW + it may be run from any directory. However, in that case it is more often unsuccesful in finding itself, and thus also will not find its help. So if you want to assure that CDPSW finds its help, you should run it from the directory it is contained in. CDP, the "registered" version, does not have this problem. If the help is lost, you can access it by logging CDPSW to the disk that CDPSW.EXE is contained on. CDP's Command Line (If You Need It) ----------------------------------- The full syntax of the CDP command line is: CDP [+] [D] [Y] [Z] [0-6] The brackets are not typed. They are a standard notation to imply that what is enclosed is optional. As you can see, all parameters are optional. + signifies that CDP is to come up immediately. It does not make itself resident in memory at that time. It only goes resident if you do a QUIT-QUIT (or ctrl-Q). Before you use CDPRENAM to personalize the registered CDP, it always goes resident. When CDP is resident, it waits in memory, EMS, or disk, for you to tap-tap Lshift-Lshift (strike the lshift key twice in rapid succession -- 1/2 sec or less apart). If you tap-tap Rshift-Rshift, CDP will come up in your currently logged DOS directory. You should omit the + if you install CDP via a batch file. NOTE: CDPSW, the shareware version, reverses the use of the +. If you omit the +, the begging (bugging??) shareware screen comes up. You may bypass that screen by using the +, but then CDPSW will put up a begging banner and go resident. This allows you to run the shareware version from a batch file. Please excuse this inconvenience; but we do want to draw your attention to the fact that we are trying to make a living from our software. The double-strike hotkey is not used by any common program that we know of. The banner shows how much memory CDP is using! And how much free memory there was and now is. D is the disk drive you wish CDP to work on when it first starts. If D is not present, CDP will start up on the disk that you were logged onto when you invoked CDP (even if from a batch file with the + option). This option holds only if you use Lshift-Lshift as the hot key. Rshift-Rshift always brings up CDP in the current DOS directory, wherever it is. Y is a special option that causes CDP to run as if your screen were monochrome. You don't need it for a color monitor. Z reverses the sides of the CDP screen. Normally, statistics, etc., are on the right and the directory tree is on the left. But typing Z allows it to be the other way around. (Note: CDP will not log onto a network disk, so unless you are very unusual, you will not lose access to any disk Y or Z.) 0-6 are options as to how CDP will take residency as a TSR. This allows you to allocate your memory and hard disks as best fits your system. 4 is the default assumption that CDP makes if you do not type in a number (swaps to as much LIM-EMS (up to 169K) as it can get (but must have at least 64k); uses first hard (or RAM) disk that has room enough (up to 226K) otherwise). Here are all the numbers: 0 ; do not swap on either EMS or disk (use memory) 1 ; swap using only 64K of EMS 2 ; swap using only 112K of EMS 3 ; swap using 176K of EMS 4 ; use as much EMS as possible; use disk if no EMS 5 ; use EMS if can get 176K; otherwise, use disk 6 ; use disk to swap -- ignore EMS CDP's Disk Domain ----------------- CDP shows one disk at a time on the monitor screen. CDPW2 is a 2nd version of CDP that has a second tree that can be used toshow a 2nd disk. CDPW2 requires an extra 5K of resident code, so CDPW2 requires 14K to be a resident TSR. The 2nd tree can only show directories. However, it is handy for the purpose of instant logging from a directory deep in a tree on one disk to a deep directory on another. CDPSW, the shareware version, does not have the 2nd tree. CDP gathers all the information about its logged disk and keeps it memory-resident, or swapped to EMS or disk with the code part of CDP. Most of the space CDP takes up is used for data, disk buffers, and saving the screen. CDP will refuse to run on a LOGICAL disk of over 132MB. It will run on smaller disks on the same system, so long as you do not try to log CDP to the big one. CDP can handle up to 2800 files and 200 directories on a single logical disk. You may have multiple physical disks of any size and multiple logical disks. We feel that a logical disk with more than 2800 files on it is unwise. Likewise, more than 64 MB on a logical disk. For those of you who do this, have fun waiting on DOS to wade through your convoluted jungle of directories and creep through your big FAT sectors. DOS (whatever version) does not suffer large disks gladly. CDP cannot work with network disks (although the 2nd tree will work on them). On a floppy disk, CDP uses INT 13h to manipulate the disk directly. That is why some anti-virus programs will tell you it is suspect as a virus or a Trojan. There are several INT 13s in the code. The number of them is 6, if you should wish to make sure some virus has not attached itself. Since the serial number security of CDP requires modifying the .EXE file, there is no standard checksum for CDP.EXE. On hard disks, CDP works directly through the hard disk driver, be it MS-DOS, SpeedStor, or whatever. Thus it does not conflict with DOS by using INT 21H calls after it is resident. This makes it the fastest and safest TSR around, in so far as its disk usage is concerned. You can bring up CDP while in the middle of a CHKDSK by typing Lshift-Lshift, and CDP will perform perfectly. You can view files in such a state, search them, sort them, etc. If you write on them or delete them it will confuse CHKDSK, but will cause no actual harm if you didn't use CHKDSK /F. If you don't delete or write on them, then when you make CDP go resident again with ^R, CHKDSK will finish performing its functions as if nothing at all had happened. NO OTHER TSR CAN DO ANYTHING RESEMBLING THIS. Because CDP has total knowledge of the disk it is working on, it can pop up instantly (especially from EMS or a RAM disk) without reloading disk information, UNLESS you have written on the disk. In that case, CDP knows that you have written -- but does not know what; so it must reload the disk again ( and it does that faster than other disk utilities). CDP can handle a 2nd disk (EXPORT, XCOPY, XKOMPARE, etc.), but in that case it only knows about a single path and file at a time. It simply does not have enough room to promise you that it can hold all information on two disks at a time (other directory managers are misleading when they say they can have more than one disk logged at a time -- they have partial information on several disks and when they do not get horribly confused, they often experience considerable delay getting to parts of disks not currently showing on their screen). On the other hand, CDP can perform entire XCOPY-type functions on entire disks, as well as perform compares on entire trees on different disks (no other program can do this). When you do log to another disk, CDP does it faster than other disk manager programs. CDP'S Find and Compare Functions -------------------------------- These are so good, that you simply must try them to believe them. For one thing, you can use CDP to scan all the .CDP files for references to particular words and subjects. It's a lot like hypertext, but more controlled. CDP finds strings in files faster than the various GREPs and it will search binary as well as Ascii files. It marks files with Boolean capabilities on the marking, and can then search the marked files internally almost instantly to show the complete context of a find. It can "shell" instantly to a word processor of your choice on any "found" files. You can instantly see a grep-like summary of finds by alt-V, and then browse from "found" file to "found" file with a single keystroke (alt-N), and see the found strings in the files by simply typing F (Find in View). The compare functions are the best way that I know of that one can assure that stuff is absolutely positively copied to a diskette with complete accuracy. The comparison can be on an entire diskette, or a selected subtree, or individual directories or files. The comparison can also be with respect only to date-time and size; extremely fast when all you want to know is whether all the files you are interested in are present on a given disk or in a given directory. CDP is the ONLY program that can do this. AND CDP can save the results of one or more comparisons and/or searches to a disk file for later perusal or just archiving. CDP's LIST function can give you an almost instant map of all directories and all files on your disk. And you can save that map into a file or print it! Very handy! I might add that if you put a map of each of your disks on each of your other disks, then you can see what's on disk F: while still working on disk C:. It's a pretty good way of finding what the path is when exporting to another disk. Anon that point, you can use the F4 key in CDP to remember a path on one disk; then later, while on another disk, you can recall the path by striking Rshift-Rshift. Also handy! Directory Switching & Finding Files ----------------------------------- If you have some tortuously long paths on your disk, avoid typing things like CD \elmer\is\somewher\down\there\with\good\foo Pop up CDP, cursor to the directory you want and hit ^D. You're there!! What other program can do that!! (Answer -- none!) If you just want to find a file called *elm*.*f* (note the freer use of * than in DOS) anywhere on your disk, do: ^S ; puts you in ShowAll mode ^F ; define a FileMatch *elm*.*f* ; type the file spec The results will appear instantly. Nuff Said! ---------- Consult BIGMAN.CDP to find out other useful stuff, including complete listing of the hot keys. And also how to use SET statements to automatically supply selected parameters rather than typing them on the command line. ***************************************** * Stipulations and Provisos * ***************************************** No guarantee is made of the correctness or non-harmfulness of the program CDP, under any circumstances. Nor is any recommendation made of its use for any particular purpose. Users will find fit purposes for CDP. No copying of this program in any form is allowed as an included part of any commercial product; nor is it to be copied for resale at a profit; except as authorized by the copyright holder, Cliff Roberson, or person(s) to whom he has given permission to copy CDP for the purpose of their profit. The program is distributed by the author as a gift or promotion; or "licensed" copies may be purchased by individuals or businesses for their own non-commercial use. A "licensed" copy of CDP is one which has been expressly prepared for a particular person or company. "Shareware" versions of CDP may be used by an individual free of charge for 30 days to determine if CDP is useful and valuable to him. A "shareware" copy of CDP is one that was not prepared for a particular recipient. "Shareware" copies have a "CDP serial number" that is one of a series starting with "1234567". The program screen bears the word "trial". Tampering with either the CDP serial number or the presence of the word "trial" is a violation of copyright. A person who uses a "shareware" version for more than 30 days is using it in violation of the author's copyright. Such versions are distributed ONLY under the condition that they be used by an individual for no more than 30 days. Those who possess an original copy of the program, received as a gift or purchased directly from the copyright holder or his designees, are permitted to copy the program from the media they received into a computer system to execute the program; such persons also may make backup copies as needed for their own convenience. A person may use the program on more than one computer system. He may also have copies on more than one system at a time. That is expressly permitted. But it is disallowed that more than one copy of a single original "licensed" copy of CDP be in use at a given time. This product should be treated as a paper book would be treated. Only one person or business at a time may use a copy of a purchased or "gifted" copy of the "registered" version of the program. Any person or business who simultaneously uses or allows use of two copies of the program violates this stipulation and proviso; and is subject to whatever laws apply regarding violation of copyright ownership. A copy of this program, CDP, that is received under the above stipulations and provisos, is the property of the receiver; but he is expressly denied any right to copy the program for distribution to others who do not adhere to those stipulations. In receiving a copy of CDP, the receiver acknowledges that it is a violation of copyright to make copies of CDP in a manner likely to result in copying or usage of CDP that will be contrary to the above stipulations and provisos. A person receiving a copy of CDP legitimately under these provisos and stipulations may dispose of it by resale or gift as he pleases, EXCEPT that at the time of such disposal he must divest himself of all other copies of CDP that he may have (unless he legitimately has more than one). It is also an obligation of a person selling or giving away a copy of CDP to impress upon and obligate the receiver to abide by these stipulations and provisos -- i.e., a receiver of a second-hand copy of CDP must agree that he is under the same obligation to respect copyright ownership of CDP as was the previous licensee; and that he, likewise, will be violating a copyright if he fail to abide by these stipulations and provisos.