Skip to content

Latest commit

 

History

History
49 lines (25 loc) · 1.8 KB

README.textile

File metadata and controls

49 lines (25 loc) · 1.8 KB

CD To Root

What?

This is an easy way to cd to the root of your project. I found that I frequently was typing things like cd ../../.. after delving into my project and wanting to get back to the root.

Currently, a project root is a directory with a .git/ directory in it or a .this_is_root file, but I’d like to make it more comprehensive soon.

Usage

At a command line, run:

$ a

Yep, that’s it. Just “a”.

Defining Root Directories

In the directory that you want to be identified as a root directory, run:

touch .this_is_root

or create a .this_is_root file in the directory through some other means. Any directory with a .this_is_root file will be considered a root directory even if it lacks a .git/ directory.

Install

Download the root.bash file, and add

source /path/to/root.bash

to your .bashrc file.

Future, Bugs, Etc

Future

As I said above, I want to make the definition of a root directory better. I implemented the .this_is_root files to manually set it, but I want to come up with a few more ways to automatically detect a lot of cases. If you have an idea of a good general case, either file an issue or fork it, implement it, and send a pull request.

Speaking of which,

Bugs

If you have a bug, feature request, suggestion, etc. please file an issue. (Go to the issues tab on the GitHub repo.) Or you can fork it and implement it yourself. Just send a pull request, and I’ll probably be happy to merge it in.

License

Copyright © Daniel Jackoway 2009

This project is released under the MIT License. See COPYING for the full text.