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 .