Improve path_helper documentation

This commit is contained in:
Sorin Ionescu 2012-05-23 15:18:17 -04:00
parent 075f516763
commit 614bbcfe5c

View File

@ -31,14 +31,27 @@ version is 4.3.10.
### Mac OS X ### Mac OS X
If you have administrator privileges, you must fix an Apple misconfiguration in If you have administrator privileges, you must fix an Apple-introduced problem
Mac OS X 10.7 Lion by renaming `/etc/zshenv` to `/etc/zprofile`, or Zsh will in Mac OS X 10.5 Leopard by executing the following command, or BASH and Zsh
have the wrong `PATH` when executed non-interactively by scripts. will have the wrong `PATH` when executed non-interactively.
sudo chmod ugo-x /usr/libexec/path_helper
`path_helper` is intended to make it easier for installers to add new paths to
the environment without having to edit shell configuration files by adding
a file with a path to the */etc/paths.d* directory.
Unfortunately, `path_helper` always reads paths from */etc/paths* set by Apple
then paths from */etc/paths.d* set by third party installers, and lastly paths
from the `PATH` environment variable set by the parent process, which
ultimately is set by the user with `export PATH=...` Thus, it reorders path
priorities, and user */bin* directories meant to override system */bin*
directories end up at the tail of the array.
### Troubleshooting ### Troubleshooting
If you are not able to find certain commands after switching to *Oh My Zsh*, If you are not able to find certain commands after switching to *Oh My Zsh*,
modify the `PATH` variable in `environment.zsh` then open a new Zsh terminal modify the `PATH` variable in *environment.zsh* then open a new Zsh terminal
window or tab. window or tab.
## Usage ## Usage
@ -48,15 +61,15 @@ accompanying README files to learn of what is available.
### Modules ### Modules
1. Browse `modules/` to see what is available. 1. Browse */modules* to see what is available.
2. Load the modules you need in `~/.zshrc` then open a new Zsh terminal 2. Load the modules you need in *~/.zshrc* then open a new Zsh terminal
window or tab. window or tab.
### Themes ### Themes
1. For a list of themes, type `prompt -l`. 1. For a list of themes, type `prompt -l`.
2. To preview a theme, type `prompt -p name`. 2. To preview a theme, type `prompt -p name`.
3. Load the theme you like in `~/.zshrc` then open a new Zsh terminal window 3. Load the theme you like in *~/.zshrc* then open a new Zsh terminal window
or tab. or tab.
![sorin theme][2] ![sorin theme][2]