Curby's Directory Changer (CDC)
v1.00.00, 2006-06-03

=== Introduction

CDC keeps track of your directory history, thereby supplanting the
last directory memory built into the bash shell.

=== Installation

This file must be sourced from a bash initialization script.  It is
intended to be used as a CUVLIS (http://curby.net/filelib/cuvlis) 
plugin but can function in most bash environments.

=== Configuration

CDC is controlled by two variables found in the CDC source.  Default
values are shown below:

  - CUVLIS_CDC=16

This variable controls the maximum number of directories kept in the
history.  The default of 16 tracks the current working directory and
up to fifteen previous directories.

  - CUVLIS_CDC_PRETTY="ON"

This variable controls whether the `cl` command will print the
directory list with ANSI colors and formatting.

=== Usage

CDC adds three commands to bash: cdc, cdn, and cl.

  - CD/CDC

CDC's `cd` command is a transparent replacement for the bash builtin
`cd` command.  The `cdc` command is identical except it adds command-
line arguments to display a help message.  The primary purpose of
these commands is to update the history of directory traversals.

  - CDN

The `cdn n` command switches to the nth directory entry in the history
list, where 1 is the most recent previous directory.  An error is
returned if the specified entry doesn't exist.

  - C1, C2, ...

These are aliases to the `cdn` command.  For example, `c1` will
change to the previous directory, `c3` will move three steps back in
the history, etc.  These aliases take no commandline arguments.

  - CL

The `cl` command lists the current working directory and the history
of previous working directories.  It takes no commandline arguments.

=== Compatibility

CDC is believed to be compatible with most installations of bash. It
was primarily tested in bash version 2.05b.

=== Bugs

There are no known bugs.  Please send bug reports to Mike at
<kirbysdl@hotmail.com>.