ProfitPress Mega CDROM2 …eeware (MSDOS)(1992)(Eng)/ProfitPress-MegaCDROM2.B6I/UTILITY/FILE/CDPSW51D.ZIP/SMALLMAN.CDP

Text File | 1990-08-23 | 17.1 KB | 378 lines

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*<ENTER>        ; 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.