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

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

     Versin 0.77a


Programacin: Jose Maria Coig-O'Donnell Cavalle

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

INDICE
==============================================================================
        INTRODUCCION
        REQUERIMIENTOS
        NUEVAS MEJORAS EN ESTA VERSION
        GARANTIA Y DISTRIBUCION
        INSTALACION
        CONFIGURACION
        MANEJO BASICO DEL CCD
        SCROLL CON EL RATON
        CONFIGURACION DE LA PRESENTACION
        ARBOLES DE DIRECTORIO
        EDICION DEL ARBOL DE DIRECTORIOS
        MOVIMIENTO DE DIRECTORIOS
        INFORMACION DE UNIDADES Y DIRECTORIOS
        BUSQUEDAS DE DIRECTORIOS
        DESCRIPCIONES
        EJECUCION DE PROGRAMAS
        COMUNICACION CON EL AUTOR
        AGRADECIMIENTOS


INTRODUCCION
==============================================================================

Coig Change Directory (CCD) es un navegador de directorios para DOS. Tambin
se puede utilizar bajo Windows 95.

El CCD es un clnico del excelente Norton Change Directory (NCD), incluido
en las Norton Utilities para DOS de Symantec, y tiene nuevas caractersticas.

Para aquellos que no conozcais el NCD, este programa escanea el rbol de
directorios, y lo presenta en pantalla. Mediante el cursor nos podemos
desplazar por el rbol, y pulsando ENTER saldremos al DOS en el directorio
seleccionado. De esta forma evitaremos el engorroso uso de la instruccin
CD del DOS, sobre todo cuando tengamos directorios de varios niveles. El
rbol de directorios queda grabado en el disco duro, de forma que no hay que
rescanearlo cada vez que ejecutamos el programa.

El NCD, adems, permite realizar acciones como crear directorios, borrarlos,
moverlos, copiarlos, renombrarlos, etc.

El CCD implementa casi todas las opciones del NCD (faltan una o dos, de poca
importancia, que estarn disponibles en la versin definitiva).

Adems, se aaden nuevas opciones, que mejoran mucho el programa, y que
permiten incluso usarlo como shell. Entre estas nuevas opciones se pueden
destacar las siguientes:

        - Soporte de CDs. Los arboles de directorios de los CDs se guardan en
          un directorio especificado, para no tener que rescanear los CDs cada
          vez que se use el CCD. 
        - Edicin del rbol. Se pueden ocultar directorios, y desplazarse
          verticalmente.
        - Rescaneo individual. Se puede rescanear un directorio por separado.
        - Descripciones. Se soportan descripciones de directorios y ficheros
          del 4DOS (DESCRIPT.ION), y ficheros FILES.BBS y FILE_ID.DIZ
        - Ejecucin de programas. Se puede definir, para cada directorio, un
          ejecutable, que puede ser invocado desde el propio CCD.
        - Grfica de espacio ocupado por los directorios.

NUEVAS MEJORAS EN ESTA VERSION
==============================================================================
        - v0.77a. Soporte de ratn. Scroll con el ratn.
                  Carga del rbol de directorios mucho ms rpida. Aceleracin
                     considerable de las bsquedas (lista de directorios).
                  Grabacin de configuracin ms sencilla.
        - v0.76a. Soporte bilinge espaol e ingls.
        - v0.75a. Primera distribucin pblica.

REQUERIMIENTOS
==============================================================================

El CCD debera poder ejecutarse en prcticamente cualquier PC, con monitor y
tarjeta de vdeo a color.

El CCD ha sido diseado para su ejecucin en DOS o Windows 95. Tambin ha sido
probado bajo Windows NT4, con sistema de archivos FAT.

Si va a ejecutar CCD bajo MS-DOS, es altamente recomendable el uso de un pro-
grama de cach, como SMARTDRV.


GARANTIA Y DISTRIBUCION
==============================================================================

El CCD no tiene garanta de ninguna clase. El autor del programa (Jos Mara
Coig-O'Donnell Cavall) no se hace responsable de ningn dao que el CCD pueda
causar, directa o indirectamente.

Esta es una versin ALFA del CCD. Algunas funciones an no estn implementadas,
aunque el programa es completamente operativo. El programa ha sido testeado
durante varios meses para encontrar posibles errores, y muy probablemente
tenga todava ms de un bug.

Este programa es FREEWARE. Slo puede ser distribuido de esta forma, libremen-
te, sin pedir dinero a cambio, sin ser modificado, y completo.

El CCD puede ser distribuido por cualquier publicacin informtica, previa
notificacin va E-MAIL, FIDONET o correo normal.

El autor se reserva la posibilidad de modificar las condiciones de distribu-
cin del CCD.


INSTALACION
==============================================================================

El CCD se distribuye con los siguientes ficheros:

        CCD.EXE     - Ejecutable principal del CCD.
        CCDTREE.EXE - Ejecutable secundario.
        LEEME.TXT   - Este fichero de texto.
        README.TXT  - Versin en ingls de este fichero de texto.
        WINCCD.BAT  - CCD para Windows 95

La instalacin es muy sencilla. Estos ficheros se pueden copiar a un directorio
cualquiera. Es muy importante que este directorio est en el PATH, para que
el programa pueda ser usado desde cualquier directorio. Como el CCD ocupa muy
poco espacio, se puede copiar incluso al directorio del DOS.

El CCD necesita tener un directorio donde poder grabar distintos tipos de
ficheros que va a utilizar y al que se refiere como "directorio de datos".
Este directorio puede ser el mismo que donde se instala el CCD, y se especifica
desde dentro del CCD.

El fichero WINCCD.BAT es un fichero por lotes destinado al uso del CCD bajo
Windows 95 (desde el escritorio, no desde una ventana DOS). Para poder usarlo
debe crear un acceso directo a este fichero en el escritorio, o en el men de
Windows 95. Lo que hace, bsicamente, es abrir en el escritorio la ventana del
directorio que seleccionemos en el CCD.


CONFIGURACION
==============================================================================

El siguiente paso es la configuracin del programa. El programa viene con unos
valores por defecto, pero necesita saber la ubicacin del directorio de datos.
El directorio de datos debe ser creado por el usuario. Si no desea utilizar el
mismo directorio donde ha instalado el programa crelo ahora.

El directorio de datos no es esencial para poder ejecutar el CCD, pero s es
necesario para poder utilizar muchas de sus caractersticas avanzadas.

Ejecute el CCD tecleando "CCD" desde la lnea de comandos.

Aparecer una ventana indicando que se est escaneando el disco duro. Tras unos
segundos, despus de haber terminado, aparecer la pantalla del programa.
Ahora vaya a la ventana de opciones. Para ello, pulse Alt-O, o seleccione la
opcin "Configuracin" del men "DISK".

En la ventana de opciones se pueden cambiar distintos aspectos del CCD. En la
columna izquierda se pueden cambiar los colores del programa.

Primero seleccione el idioma que desee, pulsando la tecla '6'. Podr elegir
entre espaol e ingls.

En la derecha encontramos, en primer lugar, el directorio de datos. Pulse la
tecla "1" para seleccionar esa opcin y teclee la ubicacin del directorio de
datos.

Ahora salga de la pantalla de opciones pulsando ESCAPE, y grabe la configura-
cin, pulsando ALT-G, o seleccionando la opcin "Guardar configuracin" del
men DISK.

La configuracin del programa se graba en un fichero llamado CCD.CFG, que se
guarda en el mismo directorio que el CCD.

Ahora el CCD est listo para su ejecucin. El resto de opciones sern explica-
das ms adelante.


MANEJO BASICO DEL CCD
==============================================================================

El CCD es muy fcil de manejar. Al teclear "CCD" desde la lnea de comandos
aparece la pantalla principal del programa, con el rbol de directorios.

El directorio sobre el que nos encontramos aparece resaltado. Podemos despla-
zarnos por el rbol utilizando las flechas de cursor, as como las teclas
RePg, AvPg, Inicio, y Fin. Tambin podemos utilizar el ratn.

Pulsando ENTER, haciendo un doble click con el ratn salimos del programa, y
vamos al directorio seleccionado.

Si pulsamos ESCAPE salimos del programa, pero no cambia el directorio.

Pulsando F1 o seleccionando el men "AYUDA", aparecer la lista de teclas del
programa.

Creacin de directorios:
        Para crear un directorio, sitese en el directorio donde va a crearlo,
        y pulse F7 o seleccione la opcin "Make" del men "DIRECTORY".

Eliminacin de directorios:
        Para eliminar un directorio, sitese en el directorio a borrar y pulse
        F8 o seleccione la opcin "Delete" del men "DIRECTORY". Por razones
        de seguridad, no se puede borrar de esta forma una rama de directorios.
        Para eliminar una rama completa pulse Alt-F8 o seleccione la opcin
        "Remove Tree".

Renombrar directorios:
        Para renombrar un directorio, sitese en el directorio y pulse F6 o
        seleccione la opcin "Rename" del men "DIRECTORY".

Cambiar unidad de disco:
        Para cambiar de unidad, pulse F3, o seleccione la opcin "Change Disk".


SCROLL CON EL RATON
==============================================================================

Para desplazarse ms comodamente por el rbol de directorios se puede utilizar
la funcin de scroll mediante el uso del ratn.

Existen dos opciones: scroll por situacin del ratn, o por movimiento del
mismo.

El modo de scroll est activo mientras presionemos el botn derecho del ratn.

En el scroll por situacin, el movimiento de la pantalla depende de la
posicin del cursor. Si el cursor est situado en la parte alta de la pantalla
sta hara un scroll en esa direccin. La velocidad del scroll depender de la
distancia del cursor al centro de la pantalla.

En el scroll por movimiento, lo que hacemos es "arrastrar" el rbol. Para
moverlo primero ponemos el cursor en una zona del mismo, pulsamos el botn
derecho del ratn, y sin soltarlo, movemos el ratn hacia donde queramos hacer
el scroll.

Usted puede elegir la opcin que ms le guste en la pantalla de opciones.
Si su ratn tiene 3 botones, podr utilizar los dos modos al mismo tiempo.
Use el botn derecho para el modo seleccionado, y el botn central para el
otro.


CONFIGURACION DE LA PRESENTACION
==============================================================================

Se puede cambiar la presentacin de pantalla para adecuarla ms a su gusto
personal.

Por defecto el programa est en un modo de texto de 50 lneas. Si prefiere
una letra ms grande, puede activar el modo de 25 lneas. Para hacerlo pulse
F9, o seleccione la opcin en el men "VIEW".

Tambin se pueden cambiar los colores de la pantalla, desde la pantalla de
opciones. En esta pantalla, pulsando las teclas de la "a" a la "s", podr
definir los colores de cada parte de la pantalla. Para seleccionar los colores
en sentido inverso, pulse la tecla MAYUSCULAS (teclas de la "A" a la "S").

Una vez configurada la presentacin que desee, no olvide grabarla, para que
siga presente la prxima vez que ejecute el CCD.


ARBOLES DE DIRECTORIO
==============================================================================

Cuando ejecutamos el CCD por primera vez en una unidad, se escanea el rbol
de directorios y se guarda en un fichero llamado "TREEINFO.CCD", en el direc-
torio raz. De esta forma no es necesario rescanear toda la unidad cada vez que
ejecutemos el CCD.

Una de las principales caractersticas del CCD es su soporte para CDs.
Obviamente, en un CD no podemos grabar el rbol de directorios en su directorio
raz, al tratarse de un soporte de slo lectura. Aqu entra en accin el direc-
torio de datos del CCD. El rbol de directorios del CD se graba en este direc-
torio.

Cuando ejecutemos de nuevo el CCD en ese CD, ste ser reconocido automtica-
mente, y se cargar el rbol de directorios correspondiente.

Esta caracterstica del CCD se pude utilizar no slo con los CDs, sino con
cualquier soporte de slo lectura, como pueden ser unidades de red en las que
no podamos escribir, o disquetes protegidos contra escritura.
                                                             
Si por alguna razn se modifica el rbol de directorios al margen del CCD
(p.e: creamos un directorio usando la instruccin MD, en vez de crearlo desde
el CCD, eliminamos un directorio usando DELTREE, o instalamos un programa) la
modificacin no se ver reflejada en el CCD. En el CCD aparecern directorios
que ya no existen, o no aparecern directorios que s existen.

Una forma de arreglar esto es hacer un rescaneo de la unidad. Para realizar un
rescaneo de la unidad pulse F2, o seleccione la opcin "Rescan Disk" en el
men "DISK".

Hacer un rescaneo de la unidad tiene algn que otro inconveniente. En primer
lugar, es un proceso relativamente lento, dependiendo del tamao de la unidad,
y su velocidad. Y por otra parte, un rescaneo total acabar con todos los cam-
bios que hayamos hecho en el rbol, como ordenarlo, u ocultar algunas de sus
ramas.

Para evitar esto tenemos otras posibilidades aparte del rescaneo total. La
primera es el rescaneo individual. Seleccionado un directorio, y pulsando
Alt-F2, o seleccionando la opcin "Rescan" en el men "DIRECTORY", se rescanea-
r nicamente la rama de ese directorio.

Adems, podemos aadir o eliminar directorios que sepamos que existen o que
ya no existen, respectivamente, al rbol, simplemente crendolos (F7) o borrn-
dolos (F8, Alt-F8).

La opcin "Comprobacin automtica", del men de opciones, ayuda un poco a
tener actualizado el rbol de directorios. Si la opcin est activada, compro-
bar si el directorio sobre el que nos encontramos existe realmente. Si no
fuera as, el directorio ser borrado automticamente del rbol de directorios.

La comprobacin slo se har una vez transcurrido un tiempo en el que estemos
parados, y que se especifica en la pantalla de opciones.


EDICION DEL ARBOL DE DIRECTORIOS
==============================================================================

El rbol de directorios puede ser modificado para trabajar ms agusto con l.

Podemos ocultar un directorio, pulsando Alt-H, o seleccionando la opcin
"HIDE" en el men "DIRECTORY". Esta opcin no elimina fsicamente el directo-
rio de la unidad. Slo hace que el directorio no aparezca en el rbol.

Esta opcin es muy til para ocultar aquellos directorios que no nos interesan,
y a los que no nos vamos a desplazar, como pueden ser subdirectorios de datos
de programas.

Pulsando Alt-S, o seleccionando la opcin "HIDE SUBDIRS" en el men "DIRECTORY"
ocultaremos todos los subdirectorios del directorio seleccionado.

Podemos adems desplazar directorios verticalmente en el rbol. Pulsando la
tecla "<" subiremos el directorio seleccionado, y pulsando ">" lo bajaremos.


MOVIMIENTO DE DIRECTORIOS
==============================================================================

Desde el CCD podemos mover un directorio fsicamente dentro del rbol de direc-
torios, igual que con la instruccin MOVE del DOS, pero mucho ms rpido,
aunque con la limitacin de que slo podremos moverlo dentro de una misma
unidad.

Para mover un directorio, seleccinelo pulsando Alt-C. A continuacin sitese
en el directorio donde quiere moverlo, y pulse Alt-M, o seleccione la opcon
"Move Directory" del men DIRECTORY.

En la versin definitiva del CCD se podrn mover directorios entre unidades,
as como copiarlos.


INFORMACION DE UNIDADES Y DIRECTORIOS
==============================================================================

El CCD permite obtener diferente informacin sobre las unidades y los directo-
rios.

En la pantalla principal, en la parte inferior, aparece el nombre de la eti-
queta de volumen de la unidad actual.

Podemos saber el espacio libre en la unidad, as como la capacidad total y el
espacio ocupado, pulsando Alt-F, o seleccionando la opcin "Free Space" en el
men DISK.

Con la opcin "File List" (F4) aparece una lista de los ficheros del directo-
rio seleccionado. Pulsando Alt-F4 aparecern slo los ficheros ejecutables.

Por ltimo, la opcin "Tree Size" (F5) permite conocer el espacio que ocupa
un directorio en el disco. Se da el espacio nominal, as como el espacio real
ocupado, al tener en cuenta el tamao del cluster de la unidad.

Esta opcin presenta adems una grfica sencilla del espacio ocupado por cada
directorio, a partir del directorio seleccionado. Por detrs de cada directo-
rio aparecer una barra que indicar el tamao del directorio con respecto
a sus "hermanos" (subdirectorios del directorio padre). Pulsando F5 en el di-
rectorio raz de una unidad, se calcular la grfica para toda la unidad.

Esta opcin es muy til a la hora de buscar de dnde podemos sacar espacio li-
bre, ya que nos permite saber qu directorios estn ocupando ms.


BUSQUEDAS DE DIRECTORIOS
==============================================================================

Si queremos ir a un directorio en concreto, podemos hacerlo ms rpido que uti-
lizando los cursores.

Simplemente tecleando el nombre del directorio al que queremos ir (lo que es-
cribamos aparecer en la parte inferior de la pantalla, en el apartado "Speed
Search"), el CCD cambiar a ese directorio.

Normalmente bastar con teclear los primeros caracteres del directorio para
llegar a l. Si esto no basta, o existen varios directorios con el mismo nom-
bre, podemos ir cambiando entre ellos pulsando la tecla de ESPACIO.

El CCD tambin se puede utilizar desde lnea de comandos, utilizando parmetros
en vez de utilizar las teclas de los cursores.

Tecleando desde la lnea de comandos
        CCD cadena
el CCD cambiar al directorio que empiece con esa cadena.

En el caso de que existan varios directorios que empiecen por esa cadena, el
comportamiento del CCD viene dado por la opcin "Lista de directorios", confi-
gurable en la pantalla de opciones.

Si la lista de directorios est activada (por defecto), aparecer en pantalla
un men con todos los directorios cuyo nombre empiece por la cadena, de todas
las unidades.

Si la lista de directorios est desactivada, el CCD cambiar al primer direc-
torio que encuentre en el rbol que empiece por esa cadena. La bsqueda se
hace partiendo del directorio actual, y en sentido descendente. As, si en el
primer intento no vamos al directorio deseado, volviendo a escribir
"CCD cadena" iremos al siguiente directorio que empiece por la cadena.

En el CCD se pueden definir directorios "favoritos". Pulsando Alt-F sobre un
directorio podremos asignarle una cadena por la que podr ser reconocido
unvocamente. Si escribimos luego CCD cadena, siendo cadena la asignada al
directorio, el CCD cambiar a ese directorio, aunque existan ms directorios
que comiencen por esa cadena. Esta informacin se guarda en un fichero llamado
FAVORITE.CCD, en el directorio de datos. 


DESCRIPCIONES
==============================================================================

El CCD puede manejar las descripciones de directorios de ficheros y directorios
en sus formatos ms extendidos.

Una forma usual de describir un programa es mediante un fichero llamado
FILE_ID.DIZ, situado en el directorio del programa, que contiene una descrip-
cin del programa.

Otra forma es mediante el fichero DESCRIPT.ION o el fichero FILES.BBS. Estos
ficheros contienen, en cada lnea de texto, el nombre de un fichero o directo-
rio y su descripcin.

Con el CCD se puede ver el contenido de estos ficheros, pulsando Alt-I en el
directorio deseado.

El CCD tiene una opcin llamada "Descripcin automtica", que est activada por
defecto, y que se puede cambiar en la pantalla de opciones.

Si esta opcin est activada, el CCD comprobar si existe una descripcin del
el directorio actual, que se deber encontrar en un fichero DESCRIPT.ION o
FILES.BBS en el directorio padre. En caso de existir una descripcin sta
aparecer en la parte inferior de la pantalla.

Esta opcin puede ralentizar el programa si es usada en unidades lentas (p.e:
CD-ROM de simple o doble velocidad), y especialmente si no utilizamos un cach
como SMARTDRV o NCACHE (bajo Windows 95 no hace falta, ya que est implementado
en el propio sistema). Para evitar este inconveniente, en la pantalla de opcio-
nes podemos definir el nmero de dcimas de segundo que el programa esperar
antes de buscar la descripcin. De esta forma, mientras recorremos el rbol
el CCD no buscar descripciones de todos los directorios por los que vayamos
pasando, sino que lo har nicamente cuando nos hayamos detenido durante el
tiempo especificado.

En ordenadores con un acceso rpido a sus unidades, se puede dejar ese tiempo
a 0 sin ningn problema.

Desde el CCD podemos adems poner descripciones a los directorios. El formato
que utiliza el CCD es mediante el uso del fichero DESCRIPT.ION, que tambin
utiliza el 4DOS.

Pulsando Alt-P, o eligiendo la opcin "Set Description" en el men "DIRECTORY"
podremos poner la descripcin para el directorio seleccionado.

El soporte para CDs del CCD tambin incluye las descripciones. Podemos poner
descripciones a los directorios de los CDs de la misma forma que haramos
en una unidad cualquiera. Como las descripciones no se pueden grabar en el CD,
el CCD las guarda en un fichero propio, llamado DIRDESC.CCD, que se guarda
en el directorio de datos.


EJECUCION DE PROGRAMAS
==============================================================================

Para cada directorio podemos definir el nombre de un ejecutable. Una vez defi-
nido, pulsando Ctrl-ENTER se ejecutar el programa. Cuando termina la ejecucin
del programa, se devuelve el control al CCD.

Para definir un ejecutable sitese sobre el directorio deseado y pulse Alt-E.

Aparecer una ventana donde se le pedir el nombre del ejecutable (teclee el
nombre completo, incluyendo su extensin).

A continuacin deber introducir los parmetros que desee utilizar. Puede de-
jar esta lnea en blanco si no necesita parmetros.

Despus debe seleccionar si quiere que se produzca una pausa al terminar la
ejecucin del programa, antes de volver al CCD. Esto puede ser til para
ver posibles mensajes de error, o informacin impresa por el programa.
Puede escoger entre hacer la pausa, no hacerla, o hacerla dependiendo del
cdigo de error devuelto por el programa (ERRORLEVEL).

Por ltimo debe decidir si el programa se debe ejecutar mediante el intrprete
de comandos. Esto consume algo ms de memoria, pero puede ser necesario para
algn programa. Si no consigue ejecutar un programa, pruebe a activar esta
opcin.

Esta informacin se guarda en un fichero llamado CCDEXE.DAT, en el directorio
seleccionado. Para el soporte de CDs, la informacin se guarda, en cambio, en
un fichero llamado DIREXE.CCD en el directorio de datos.


COMUNICACION CON EL AUTOR
==============================================================================

El CCD todava no est terminado. Quedan cosas por hacer, y errores por arre-
glar.

Si tienes alguna sugerencia, alguna idea que te gustara que implementara el
CCD, o descubres algn error, por favor contacta conmigo de alguna de estas
maneras:

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

Puedes conseguir la ltima versin del CCD en:

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

AGRADECIMIENTOS
==============================================================================

Agradezco especialmente el apoyo y el magnfico trabajo de mis beta-testers.

Carlos Carpio Garca, Jose Marco Vera Garca, Andres Asensio Ramos, Luis
Anton Canalis y Juan Carlos Suarez Yanes han contribudo formidablemente a la
realizacin del CCD, tanto probando y detectando (alguno incluso sufriendo)
mltiples bugs, como aportando muy buenas ideas.

