DragonFly On-Line Manual Pages

Search: Section:  

autojump(1)        A faster way to navigate your filesystem        autojump(1)


NAME

       autojump - a faster way to navigate your filesystem


SYNOPSIS

       j dirspec

       jumpstat


DESCRIPTION

       One of the most used shell commands is "cd". A quick survey among my
       friends revealed that between 10 and 20% of all commands they type are
       actually cd commands! Unfortunately, jumping from one part of your
       system to another with cd requires to enter almost the full path, which
       isn't very practical and requires a lot of keystrokes.

       autojump is a faster way to navigate your filesystem. It works by
       maintaining a database of the directories you use the most from the
       command line. The jumpstat command shows you the current contents of
       the database. You need to work a little bit before the database becomes
       useable. Once your database is reasonably complete, you can "jump" to a
       directory by typing:

       j dirspec

       where dirspec is a few characters of the directory you want to jump to.
       It will jump to the most used directory whose name matches the pattern
       given in dirspec. Note that autojump isn't meant to be a drop-in
       replacement for cd, but rather a complement. Cd is fine when staying in
       the same area of the filesystem; autojump is there to help when you
       need to jump far away from your current location.

       Autojump supports autocompletion. Try it!


EXAMPLES

       j mp3

       could jump to "/home/gwb/my mp3 collection", if that is the directory
       in which you keep your mp3s.

       jumpstat

       will print out something in the lines of:

       54.5:     /home/shared/musique

       60.0:     /home/joel/workspace/coolstuff/glandu

       83.0:     /home/joel/workspace/abs_user/autojump

       97.9:     /home/joel/workspace/autojump

       141.8:    /home/joel/workspace/vv

       161.7:    /home/joel

       Total key weight: 1079

       The "key weight" reflects the amount of time you spend in a directory.


BUGS

       No known bugs at this time.


AUTHOR

       Joel Schaerer (joel.schaerer@laposte.net)


LICENSE

       autojump is free software: you can redistribute it and/or modify it
       under the terms of the GNU General Public License as published by the
       Free Software Foundation, either version 3 of the License, or (at your
       option) any later version.

       autojump is distributed in the hope that it will be useful, but WITHOUT
       ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
       FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
       for more details.

       You should have received a copy of the GNU General Public License along
       with autojump.  If not, see <http://www.gnu.org/licenses/>.

1.0                            10 February 2009                    autojump(1)

Search: Section: