File: environment_variables_faq.rst

package info (click to toggle)
matplotlib 1.1.1~rc2-1
  • links: PTS, VCS
  • area: main
  • in suites: wheezy
  • size: 66,076 kB
  • sloc: python: 90,600; cpp: 69,891; objc: 5,231; ansic: 1,723; makefile: 171; sh: 7
file content (95 lines) | stat: -rw-r--r-- 2,469 bytes parent folder | download | duplicates (2)
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`.