1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95
|
.. _environment-variables:
*********************
Environment Variables
*********************
.. contents::
:backlinks: none
.. envvar:: HOME
The user's home directory. On linux, :envvar:`~ <HOME>` is shorthand for :envvar:`HOME`.
.. envvar:: PATH
The list of directories searched to find executable programs
.. envvar:: PYTHONPATH
The list of directories that is added to Python's standard search list when
importing packages and modules
.. envvar:: MPLCONFIGDIR
This is the directory used to store user customizations to matplotlib, as
well as some caches to improve performance. If :envvar:`MPLCONFIGDIR` is not
defined, :file:`{HOME}/.matplotlib` is used by default.
.. _setting-linux-osx-environment-variables:
Setting environment variables in Linux and OS-X
===============================================
To list the current value of :envvar:`PYTHONPATH`, which may be empty, try::
echo $PYTHONPATH
The procedure for setting environment variables in depends on what your default
shell is. :program:`BASH` seems to be the most common, but :program:`CSH` is
also common. You should be able to determine which by running at the command
prompt::
echo $SHELL
BASH/KSH
--------
To create a new environment variable::
export PYTHONPATH=~/Python
To prepend to an existing environment variable::
export PATH=~/bin:${PATH}
The search order may be important to you, do you want :file:`~/bin` to
be searched first or last? To append to an existing environment
variable::
export PATH=${PATH}:~/bin
To make your changes available in the future, add the commands to your
:file:`~/.bashrc` file.
CSH/TCSH
--------
To create a new environment variable::
setenv PYTHONPATH ~/Python
To prepend to an existing environment variable::
setenv PATH ~/bin:${PATH}
The search order may be important to you, do you want :file:`~/bin` to be searched
first or last? To append to an existing environment variable::
setenv PATH ${PATH}:~/bin
To make your changes available in the future, add the commands to your
:file:`~/.cshrc` file.
.. _setting-windows-environment-variables:
Setting environment variables in windows
========================================
Open the :program:`Control Panel` (:menuselection:`Start --> Control Panel`),
start the :program:`System` program. Click the :guilabel:`Advanced` tab
and select the :guilabel:`Environment Variables` button. You can edit or add to
the :guilabel:`User Variables`.
|