----------------------------------------
                          DIRectory Tool
                                    v1.3

                              2005-02-15
                          Scott Lawrence
                      sdlpci@cis.rit.edu

----------------------------------------
                                    What

    DIRectory Tool, or ``dirt'' is a persistant, account-based
    directory stack mechanism . Unlike most shells' directory stacks,
    dirt's stacks remain between instantiations of your favorite shell,
    between multiple shells, and between logins .  Dirt also allows for
    multiple directory stacks . I use one for each project I'm
    currently working on.

    It does this by keeping the directory stacks in a directory in your
    home directory . Generally, it is ~/.dirt/ .  This directory will
    contain (once dirt is started) a few items of note:

	~/.dirt/		dir containing all of dirt's files
	~/.dirt/id		the id of the current directory stack
	~/.dirt/piles/		dir containing all of the directory stacks
	~/.dirt/piles/default	the default stack

    If you create a new stack by typing 
	dirt list burrito
    you will now have a file like so:
	~/.dirt/piles/burrito

    To get a list of your stacks, type:
	dirt list -list

    If you're using the included aliases, these commands are:
	ddirs burrito
    and
	ddirs -list

----------------------------------------
				     Old

    If you've used a previous version of DIRT, it is recommended that
    you run ``dirt migrate'' to convert over your old directory stacks
    to the new formats .

    This is for migrating the 1.0-1.1 as well as 1.2 versions .

----------------------------------------
				     Use

    It is suggested that you either use the included .sh or .csh
    aliases to make use of dirt more easily .  If you have another
    shell, model the commands off of the included ones, and send them
    in to me, so that I can include them in the distribution .
    Functionally, the common aliases are:

	ddirs	    dirt list		list available stacks/print list
	djump	    dirt jump		jump to item in list
	dpop	    dirt pop		pop the top off the stack, go there
	dpush	    dirt push		push cwd onto the stack
	dswap	    dirt swap		swap cwd with the top of the stack
	dtop	    dirt top		peek at the top of the stack, go there

    Other useful commands are:
	dirt help	- displays help/usage for the program

    It should be noted that as entries are pushed onto the stack, they
    appear at the bottom of the list . So, "top of stack" is the bottom
    of the list .  You can also jump to specific entries in your stack
    by doing the "dirt jump 3" to go to item 3 as displayed with "dirt list"
    or: "djump 3" to item 3 displayed with "ddirs" .

    Also, if you change directory lists by using "dirt list NEWLIST",
    your directory will not change.  It simply changes the list .