Coig Change Directory
=====================

 CCCCC   CCCCC  DDDDD
C       C       D    D
C       C       D    D
C       C       D    D
 CCCCC   CCCCC  DDDDD

     Version 0.77a


Programmer  : Jose Maria Coig-O'Donnell Cavalle

Beta-testers: Carlos Carpio Garcia
              Jose Marco Vera Garcia
              Andres Asensio Ramos
              Luis Anton Canalos
              Juan Carlos Suarez Yanes

INDEX 
==============================================================================
        INTRODUCTION
        IMPROVEMENTS ON THIS VERSION
        REQUIREMENTS  
        GUARANTEE AND DISTRIBUTION
        INSTALLATION
        CONFIGURATION
        BASIC COMMANDS
        MOUSE SCROLL
        SCREEN SETUP                    
        DIRECTORY TREES
        DIRECTORY TREE EDITING          
        DIRECTORY MOVE           
        DRIVE AND DIRECTORY INFO             
        DIRECTORY SEARCH        
        DESCRIPTIONS 
        PROGRAMS EXECUTION     
        CONTACTING THE AUTHOR    
        GREETINGS       


INTRODUCTION
==============================================================================

Coig Change Directory (CCD) is a DOS directory navigator. It can be used on
Windows 95, too.

CCD is a clone of the famous Norton Change Directory (NCD), included
in the Norton Utilities for DOS, from Symantec, and has new features.

For those who don't know about NCD, this program scans the directory tree,
and prints it on the screen. You can move through it, using the cursor keys.
Pressing ENTER, it returns to DOS, in the directory selected. This way, we
can avoid the bother of using the CD instruction, specially when we have
a very complex directory structure. The program saves the directory tree on
the hard disk, so it is not necessary to rescan the drive every time we use
the program.

NCD can also do other actions, like create, erase, rename, or move directo-
ries.

CCD features almost every action NCD can do, but one or two that hasn't been
implemented yet, as this is not the final version.

A lot of new features has been added to CCD, so it can even be used as a shell.
Here are the most important ones:

        - CD-ROM support. CD-ROM directory trees can be saved in a specified
          directory on the hard disk, so they don't have to be rescaned each
          time they are accessed.
        - Tree Editing. Directories on the tree can be hidden, or moved
          vertically.
        - Partial Rescan. A specified directory can be rescaned, so it is
          not necessary to rescan the whole drive.
        - Descriptions. 4DOS file and directory descriptions are supported,
          as well as FILES.BBS and FILE_ID.DIZ files.
        - Program execution. An executable can be defined for each directory,
          so you can run your programs from CCD.
        - Drive usage graphic.

IMPROVEMENTS ON THIS VERSION
==============================================================================
        - v0.77a. Mouse support. Mouse scroll.
                  Loading time of directory trees greatly improved. Makes
                     searchs (directory list) faster.
                  Easier configuration save procedure.
        - v0.76a. Bilingual support. English and Spanish.
        - v0.75a. First public release.

REQUIREMENTS
==============================================================================

CCD should be able to run on any PC computer, with color monitor and graphic
card.

CCD has been designed for its use under DOS or Windows 95. It has also been
tested under Windows NT4, with FAT file system.

If you are using CCD under DOS, it is highly recommended the use of a cache
software, like SMARTDRV.


GUARANTEE AND DISTRIBUTION
==============================================================================

CCD has no guarantee of any type whatsoever. In no event will the author of
this program (Jos Mara Coig-O'Donnell Cavall) liable to you for any damages
arising out to the use of this program.

Please take note that this is an alfa version. Some options are not implemen-
ted yet, but the program is completely operative. CCD has been tested for some
months for findings bugs, and it surely has a few bugs more.

This program is FREEWARE. It can only be distributed this way, freely, without
asking for money, without beeing modificated, and complete form.

CCD can be distributed on any publication, upon notification to the author,
via E-MAIL, FIDONET, or normal mail.

The author reserves himself the posibility of changing any distribution
condition.


INSTALLATION
==============================================================================

CCD comes with the following files:

        CCD.EXE     - Program executable.
        CCDTREE.EXE - Secondary program executable.
        LEEME.TXT   - Spanish version of this text file.
        README.TXT  - This text file.
        WINCCD.BAT  - CCD for Windows 95

Installing CCD is very simple. This files can be copied to any directory of
your choice. It's very important that this directory is in the PATH, so it can
be invoked from any directory. As CCD gets very little space on your disk, you
can copy it to your DOS directory.

CCD needs a directory where to copy different files it needs. From now on, we
will call it "data directory". This directory can be the same where CCD is
installed. You must specify this directory once inside CCD.

WINCCD.BAT is a batch file for using CCD on Windows 95 (the desktop, not a
DOS window). To use it, just creat a shortcurt on your desktop or Start Menu.
When executed, CCD will be executed, and once you select the directory you
want to go, its folder will open on the desktop.


CONFIGURATION
==============================================================================

The next step is configuring the program. CCD has a default configuration, but
it needs you to specify the data directory. This directory is not created by
CCD, so please create it first, unless you are using the same CCD directory.

The data directory is not needed to run CCD, but if you don't set it up, some
advanced features won't be activated.

Execute CCD now, by typing "CCD" on the command prompt.

As this is the first time you run CCD, a message will appear, saying the
driving is beeing scaned. After a few seconds, the program screen will appear.
Now, go to the options window. Press Alt-O, or select "Configuration" on the
"DISK" menu.

On the options window you can change multiple aspects of CCD. On the left
column, you can set up the screen colors.

First, you may select the program language. You can set it to "Engglish" or
"Spanish", pressing the '6' key.

On the right we can see, in first place, the data directory. Press "1" to
select that option, and insert the whole path to the data directory.

Now exit the options window pressing ESC, and save the configuration, pressing
ALT-G, or selecting "Save Configuration" from the DISK menu.

The program configuration will be saved on the file CCD.CFG, on the directory
CCD is installed.

Now CCD is ready to work. The other options will be explained after.


BASIC COMMANDS
==============================================================================

CCD is very easy to use. By typing "CCD" on the command prompt we go to the
program main screen, where we can see the directory tree.

The directory where we are will appear in other color. We can move through the
tree, by using the cursor keys, page keys, and start and end keys. Mouse is
also supported.

Pressing ENTER, or double-clicking with then mouse, we exit the program, going
to the selected directory.

Pressing ESC we exit the program, but we stay on the directory we were before.

Pressing F1 or selecting the "HELP" menu, a list of the program keys will
appear.

Creating directories:
        Go to the directory where you want to create the new one, and press
        F7, or select "Make" on "DIRECTORY" menu.

Erasing directories:
        Go to the directory you want to eliminate, and press F8 or select
        "Delete" on "DIRECTORY" menu. Because of security reasons, you can't
        erase a whole branch of directories this way. To erase a directory with
        all its subdirectories, press Alt-F8, or select the option "Remove Tree".

Renaming directories:
        Go to the directory you want to rename, and press F6 or select "Rename"
        on the "DIRECTORY" menu.

Changing Drive:
        Press F3, or select "Change Disk", on the "DISK" menu.


MOUSE SCROLL
==============================================================================

You can move along the directory tree more easily using the mouse to scroll.

You can choose between two scroll modes: situation scroll or movement scroll.

The scroll mode is active while we are pressing the mouse right button.

In the situation scroll, the screen movement depends on the cursor position.
if the cursor is situated in the upper area of the screen, the screen will
move that direction. The scroll speed depends on thow far is the cursor from
the centre of the screen.

In the movement scroll, we "drag" the directory tree. First, hold the right
button, and the move the mouse towards the direction we want the tree to move
to.

You can choose the one you prefer in the options screen. If your mouse has
three buttons, you can use the two scroll modes at the same time. Use the
right button for the selected mode, and the center button for the other one.


SCREEN SETUP
==============================================================================

You can configure the screen presentation, to make it more confortable to you.

By default the program run on a text mode of 50 lines. If you prefer a bigger
font, you can select the 25 lines mode. To do it, press F9, or select it on
the "VIEW" menu.

You can also change the screen colors, from the options window. Pressing keys
'a' through 's', you can define colors for each part of the screen. To select
colors in inverse order, use the SHIFT key ('A' through 'S').

Once you get the screen as you like, save the configuration.


DIRECTORY TREES
==============================================================================

When CCD is executed for the first time on a drive, the directory tree is
scanned, and saved in a file called "TREEINFO.CCD" in the root directory,
so it is not necessary to rescan the drive each time you use CCD.

One of the main improvements that CCD features is the CD-ROM support.
Obviously, we can not save the directory tree on a CD-ROM root directory, as
it is a READ-ONLY device. What CCD does is save the directory tree on its
data directory.

The next time we use CCD on that CD-ROM, it will be recognised automatically,
and it's directory tree will be loaded.

This feature of CCD can be also used with any other READ-ONLY drive, such
as a network drive where we have no write access, or a write-protected floppy
disk.

If the directory structure is modified from outside CCD (creating a directory
using the MD instruction, or installing a new program, or deleting a directo-
ry using DELREE), the data stored on the saved directory tree will not be
correct. It will appear directory that not exist fisically, or not appear
directories that really exists.

This can be fixed rescanning the drive, so the information is updated. To
rescan a drive, press F2, or select "Rescan Disk" on "DISK" menu.

Rescaning a drive has some problems. First of all, rescanning is a relatively
slow process. This depends on the size and the speed of the drive. Second, a
rescan will reset all the changes done to the directory tree, like sorting or
hiding directories.

We have two solutions to this problem. The first one is to do a partial rescan.
This rescans only one directory. To do a partial rescan, go to the directory
of your choice, and press Alt-F2, or select "Rescan" on the "DIRECTORY" menu.

The second one is to manually delete or create the directories, as we would
do it normally.

The option "automatic check", in the options window, help to have the direc-
tory tree updated. If this this option is turned on, CCD will check if the
directory we are on really exists. If it doesn't, is removed from the direc-
tory tree automatically.

This check is done only when you don't touch a key during a period of time,
that you can set on the options window.


DIRECTORY TREE EDITING
==============================================================================

The directory tree can be modified to work more confortably with it.

We can hide a directory, pressing Alt-H, or selecting "HIDE" on the "DIRECTO-
RY" menu. This option does not delete the directory fisically from the drive.
It just makes it doesn't appear on the tree.

This option is very useful to hide those directories that aren't of any inte-
rest to us, like data subdirectories from some programs.

By pressing Alt-S, or selecting "Hide Subdirs" on the "DIRECTORY" menu, we can
hide all the subdirectories of the directory we are on.

We can also move directories up and down through the directory tree. Pressing
'<' the directory will go up, and '>' will make it go down the tree.


DIRECTORY MOVE
==============================================================================

CCD can move directories inside the directory tree. It works like the DOS
command "MOVE", but much more fast. The only limitation is that directories
can only be moved within the same drive.

To move a directory, select it pressing Alt-C. Then, go to the directory
you want to move it in, and press Alt-M or select "Move Directory" on the
"DIRECTORY" menu.

On the definitive version of CCD it will also be implemented moving directo-
ries between different drives, and copying directories.


DRIVE AND DIRECTORY INFO
==============================================================================

You can obtain information about drives and directories.

Below the main screen, appears the volume label of the actual drive.

To check the free space on the drive, and the capacity and used space, press
Alt-F, or select "Free Space" on the "MENU" disk.

By selecting "File List" (F4), you can see a list of the files in the current
directory. Pressing Alt-F4 only the executable files will appear.

Finally, the "Tree Size" option (F5) allows you to know the space each direc-
tory gets on your disk. The nominal space is reported, as well as the real
space occupied, depending on the cluster size of the drive.

This option also presents a simple graphic representing the drive space
occupied by each directory, starting at the selected directory. On each
directory background, a bar will appear, representing the directory disk
usage, relative to its "brothers". By pressing F5 on the root directory, you
can obtain this graphic for the whole drive.

This option is very useful when looking where to obtain free space on the
drive, because it tells us which directories are using more space.


DIRECTORY SEARCH
==============================================================================

The are some methods to quickly go to a specified directory, faster than using
the cursor keys.

By typing the directory name we want to go CCD will go to that directory.
Usually, just a few characters will be enough for CCD to go to the directory
we want. If this is not enough, or are some directories with the same name
we can change through them using the SPACE key.

CCD can also be used from the command line, using parameters.

By typing
        CCD string
from the command prompt, CCD will change to the directory whose name starts
with the string.

In case there are some directories starting with that string, the CCD behaviour
is determined by the "Directory List" option, at the options window.

If this option is activated (by default), a menu with all the directories
starting with the string will appear.

If the option is deactivated, CCD will change to the first directory starting
with the string. The search is done starting from the current directory. If
we don't go to the desired directory on the first try, we can write "CCD
string" again, to go the next directory.

We can also define "favorite" directories. Pressing Alt-F on a directory
we can assign a string to it. If we type "CCD string" after that, CCD will
go directly to that directory, even if there are more directories starting
with that string. This is information is stored in a file called FAVORITE.CCD,
on the data directory.


DESCRIPTIONS
==============================================================================

CCD can handle file and directory descriptions, in its more used formats.

A usual way of describing a program is by a file called FILE_ID.DIZ,
containing the program description.

The other method is by using the file DESCRIPT.ION, or FILES.BBS. This files
contain, in each line of text, the name of a file or directory, and its
description.

We can see the these files by pressing Alt-I on a directory.

CCD has an option called "Automatic Description", activated by default. You
can change it on the options window.

When this option is activated, CCD will check if exists a description of the
selected directory, which must be present on the file DESCRIPT.ION or
FILES.BBS on the parent directory. If it exists, the description will appear
on the screen, below the directory tree.

In some cases, this option may slow down the program, if used on slow drives,
like single or double speed CD-ROMs, or floppies, or if we are not using a
cache software, like SMARTDRV (this is not necessary if we are using Windows
95). To solve this problem, on the options menu we can define a period of time
CCD will wait for us to press a key before looking for the description. This
way, the program will not try to read each directory we go through when moving
by the directory tree.

If you have a fast drive, you can leave that time to 0.

We can also set descriptions to the directories from CCD. CCD uses the
DESCRIPT.ION file, which is compatible with 4DOS.

To set a description to a directory, press Alt-P, or select "Set Description",
on the DIRECTORY menu.

CCD CD-ROM support also includes descriptions. We can set descriptions to
directories of a CD, the same way we se them to normal directories. As these
descriptions can't be saved to the CD, CCD saved them to a file called
DIRDESC.CCD, on the data directory.


PROGRAMS EXECUTION
==============================================================================

We can define an executable file for each directory. Then, by pressing
CTRL-ENTER on that directory, the program will be executed. Once the program
terminates, it resturns to CCD.

To define an executable file, go to the directory and press Alt-E.

A window will appear. First type the executable file name, with its extension.

After that, type the optional parameters you want to use. You can leave this
blank, if you are not using any parameters.

Then you must select if you want CCD to make a pause after terminating the
program, before returning to the main screen. This can be useful to see
error messages, or information returned by the program executed. You can
seelct do do the pause, not to do, or do it only if the program returns
an error code (ERRORLEVEL).

Finally you must select if the program is to be executed through the
command processor. This gets some memory, but may be necessary for some
programs. If you can't run a program from CCD, try turning this option on.

This information is saved on a filled called CCDEXE.DAT, on the selected
directory. When using this feaure on CD-ROMs, the data is saved on a file
called DIREXE.CCD on the data directory.


CONTACTING THE AUTHOR  
==============================================================================

CCD isn't finished yet. There many feautes to implement, and bugs to fix.

If you have any suggestion, or find a bug, please contact me at one of the
following directions:

        Internet: alu1499@csi.ull.es
                  coig@geocities.com
        Fidonet:  Jose Coig (2:340/12.25)

You can obtain the newest release of CCD at:

        http://www.geocities.com/SiliconValley/Pines/9581

        
GREETINGS
==============================================================================

My beta-testers have done a really good work on this project.

Carlos Carpio Garcia, Jose Marco Vera Garcia, Andres Asensio Ramos, Luis
Anton Canalis and Juan Carlos Suarez Yanes have contributed greatly to the
realization of CCD, testing it and detecting (even suffering) multiple bugs.
They have apported a lot of really good ideas, too.
