Blob


1 If you use the shell a lot, you may find this advice useful, in case you didn't already knew it. There's an environment variable called CDPATH, used by most shell I know and others cli tools, whose raison d'être is to simplify ‘cd’-ing around.
3 As various environmental variables in UNIX, its value is a list of directories separated by colons, just like PATH. For instance, this is what I currently have in my ‘~/.kshrc’:
5 ```
6 export CDPATH=.:$HOME/w:/usr/ports
7 ```
9 With that in place, no matter where my current working directory is, I can ‘cd games/godot’ and jump to ‘/usr/ports/games/godot’!
11 A note of warning: ‘.’ (the dot aka your current working directory) should be present in your $CDPATH, otherwise you won't be able to ‘cd’ into directories not found in your $CDPATH (you can still use ‘cd ./$somedir’, but isn't probably what you want).
13 ## Programs that I know respect $CDPATH
15 Since the entry would be too short otherwise, here's some programs that I know respect $CDPATH, and how they behave.
17 ### ksh (OpenBSD pdksh)
19 Just as I showed you up there. When you ‘cd’ into a directory inside your $CDPATH it will print your new current working directory:
21 ```
22 $ cd games/godot
23 /usr/ports/games/godot
24 ```
26 It will not, however, autocomplete.
28 ### bash
30 It will behave just like ksh.
32 ### zsh
34 zsh respects $CDPATH but it doesn’t seem to do completions :(
36 ### rc
38 9ports’ rc does not seem to inherit $CDPATH, but you can set it (unsurprisingly) with
40 ```
41 cdpath=(. /usr/ports)
42 ```
44 in your ‘~/lib/profile’. Other versions of rc (I'm talking about the one you get with the rc package on FreeBSD) do inherit it, so double check!
46 Additionally, rc prints the ‘pwd’ only if you're ‘cd’-ing into something that's not within the current directory. So:
48 ```
49 % pwd
50 /home/op
51 % echo $cdpath
52 . /usr/ports
53 % cd bin # won't print /home/op/bin
54 % cd games
55 /usr/ports/games
56 %
57 ```
59 ### csh & tcsh
61 ```
62 set cdpath = (. /usr/ports)
63 ```
65 for the rest, behaves exactly like `rc`. I don't really use csh, nor tcsh, so I can't make further comments.
67 ### fish
69 I've installed fish just for this post. It does respect $CDPATH and, unlike other shells, is also able to do proper autocompletion out-of-the-box!
71 ### vi (nvi)
73 vi will inherit your $CDPATH (but make sure you're exporting it in the environment!). You can also ‘:set cdpath=…’ if you wish. You cannot edit a file like ‘:e games/godot/Makefile’ and expect vi to open ‘/usr/ports/games/godot/Makefile‘ though, you need first to ‘:cd games/godot‘ and then ‘:e Makefile’!
75 ### bonus: Emacs
77 Emacs vanilla ‘M-x cd’ respects your $CDPATH, you just have to delete the default text in the minibuffer. It also does proper autocompletion! Additionally, eshell respects $CDPATH too! Not every other Emacs packages will, however. For instance, ivy doesn't seem to care about it.
79 On the other hand, with Emacs you have other ways to quickly jump around.