You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

100 line
2.5 KiB

  1. ========
  2. AUTOJUMP
  3. ========
  4. ----------------------------
  5. A ``cd`` command that learns
  6. ----------------------------
  7. 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.
  8. 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::
  9. j dirspec
  10. where dirspec is a few characters of the directory you want to jump to. It will jump to the most used directory whose
  11. name matches the pattern given in dirspec.
  12. Autojump supports tab completion. Try it!
  13. Examples
  14. ========
  15. ::
  16. j mp3
  17. could jump to ``/home/gwb/my mp3 collection``, if that is the directory in which you keep your mp3s. ::
  18. jumpstat</b>
  19. will print out something in the lines of::
  20. ...
  21. 54.5: /home/shared/musique
  22. 60.0: /home/joel/workspace/coolstuff/glandu
  23. 83.0: /home/joel/workspace/abs_user/autojump
  24. 96.9: /home/joel/workspace/autojump
  25. 141.8: /home/joel/workspace/vv
  26. 161.7: /home/joel
  27. Total key weight: 1077
  28. The "key weight" reflects the amount of time you spend in a directory.
  29. Author
  30. ======
  31. Joel Schaerer (joel.schaerer (at) laposte.net)
  32. Install script written by Daniel Jackoway
  33. License
  34. =======
  35. autojump is distributed under the terms of the GPL, version 3.
  36. Installation
  37. ============
  38. Auto Installation
  39. -----------------
  40. run::
  41. ./install.sh
  42. Enter your root password if it asks.
  43. Add the line::
  44. source /etc/profile
  45. to ``~/.bashrc`` if it isn't already there.
  46. Troubleshoot
  47. ------------
  48. If the script fails, you may need to do::
  49. chmod +x install.sh
  50. before the first step.
  51. Manual installation of autojump is very simple: copy
  52. - autojump to /usr/bin,
  53. - autojump.sh to /etc/profile.d,
  54. - autojump.1 to /usr/share/man/man1.
  55. Make sure to source ``/etc/profile`` in your ``.bashrc``::
  56. source /etc/profile
  57. Packaging
  58. =========
  59. For now gcarrier and I have packaged autojump for Arch Linux. It is available in [community]. To install, type::
  60. pacman -S autojump
  61. I would be very interested by packages for other distros. If you think you can help me with the packaging, please contact me!