Commit e65c3f0b authored by Fred Drake's avatar Fred Drake

Removed obsolete \kwindex{} calls.

Added "module search path" to the index.

"Unix" ==> "\UNIX{}"
parent 7a82b556
...@@ -10,16 +10,17 @@ modules that needed to use site-specific modules would place ...@@ -10,16 +10,17 @@ modules that needed to use site-specific modules would place
longer necessary. longer necessary.
This will append site-specific paths to to the module search path. This will append site-specific paths to to the module search path.
\indexiii{module}{search}{path}
It starts by constructing up to four directories from a head and a It starts by constructing up to four directories from a head and a
tail part. For the head part, it uses \code{sys.prefix} and tail part. For the head part, it uses \code{sys.prefix} and
\code{sys.exec_prefix}; empty heads are skipped. For \code{sys.exec_prefix}; empty heads are skipped. For
the tail part, it uses the empty string (on Mac or Windows) or it uses the tail part, it uses the empty string (on Mac or Windows) or it uses
first \file{lib/python\var{version}/site-packages} and then first \file{lib/python\var{version}/site-packages} and then
\file{lib/site-python} (on Unix). For each of the distinct head-tail \file{lib/site-python} (on \UNIX{}). For each of the distinct
combinations, it sees if it refers to an existing directory, and if head-tail combinations, it sees if it refers to an existing directory,
so, adds to \code{sys.path}, and also inspected for path configuration and if so, adds to \code{sys.path}, and also inspected for path
files. configuration files.
\indexii{site-python}{directory} \indexii{site-python}{directory}
\indexii{site-packages}{directory} \indexii{site-packages}{directory}
...@@ -32,10 +33,6 @@ refers to a directory (rather than a file). No item is added to ...@@ -32,10 +33,6 @@ refers to a directory (rather than a file). No item is added to
\code{\#} are skipped. \code{\#} are skipped.
\index{package} \index{package}
\indexiii{path}{configuration}{file} \indexiii{path}{configuration}{file}
\kwindex{sys.prefix}
\kwindex{sys.exec_prefix}
\kwindex{prefix}
\kwindex{exec_prefix}
For example, suppose \code{sys.prefix} and \code{sys.exec_prefix} are For example, suppose \code{sys.prefix} and \code{sys.exec_prefix} are
set to \file{/usr/local}. The Python 1.5 library is then installed in set to \file{/usr/local}. The Python 1.5 library is then installed in
...@@ -61,7 +58,8 @@ and \file{bar.pth} contains: ...@@ -61,7 +58,8 @@ and \file{bar.pth} contains:
bar bar
\end{verbatim}\ecode \end{verbatim}\ecode
Then the following directories are added to sys.path, in this order: Then the following directories are added to \code{sys.path}, in this
order:
\bcode\begin{verbatim} \bcode\begin{verbatim}
/usr/local/python1.5/site-packages/bar /usr/local/python1.5/site-packages/bar
...@@ -75,11 +73,11 @@ Note that \file{bletch} is omitted because it doesn't exist; the ...@@ -75,11 +73,11 @@ Note that \file{bletch} is omitted because it doesn't exist; the
configuration file. configuration file.
After these path manipulations, an attempt is made to import a module After these path manipulations, an attempt is made to import a module
named \code{sitecustomize}, which can perform arbitrary site-specific named \code{sitecustomize}\refmodindex{sitecustomize}, which can
customizations. If this import fails with an \code{ImportError} perform arbitrary site-specific customizations. If this import fails
exception, it is silently ignored. with an \code{ImportError} exception, it is silently ignored.
\refmodindex{sitecustomize}
Note that for some non-Unix systems, \code{sys.prefix} and Note that for some non-\UNIX{} systems, \code{sys.prefix} and
\code{sys.exec_prefix} are empty, and the path manipulations are \code{sys.exec_prefix} are empty, and the path manipulations are
skipped; however the import of \code{sitecustomize} is still attempted. skipped; however the import of
\code{sitecustomize}\refmodindex{sitecustomize} is still attempted.
...@@ -10,16 +10,17 @@ modules that needed to use site-specific modules would place ...@@ -10,16 +10,17 @@ modules that needed to use site-specific modules would place
longer necessary. longer necessary.
This will append site-specific paths to to the module search path. This will append site-specific paths to to the module search path.
\indexiii{module}{search}{path}
It starts by constructing up to four directories from a head and a It starts by constructing up to four directories from a head and a
tail part. For the head part, it uses \code{sys.prefix} and tail part. For the head part, it uses \code{sys.prefix} and
\code{sys.exec_prefix}; empty heads are skipped. For \code{sys.exec_prefix}; empty heads are skipped. For
the tail part, it uses the empty string (on Mac or Windows) or it uses the tail part, it uses the empty string (on Mac or Windows) or it uses
first \file{lib/python\var{version}/site-packages} and then first \file{lib/python\var{version}/site-packages} and then
\file{lib/site-python} (on Unix). For each of the distinct head-tail \file{lib/site-python} (on \UNIX{}). For each of the distinct
combinations, it sees if it refers to an existing directory, and if head-tail combinations, it sees if it refers to an existing directory,
so, adds to \code{sys.path}, and also inspected for path configuration and if so, adds to \code{sys.path}, and also inspected for path
files. configuration files.
\indexii{site-python}{directory} \indexii{site-python}{directory}
\indexii{site-packages}{directory} \indexii{site-packages}{directory}
...@@ -32,10 +33,6 @@ refers to a directory (rather than a file). No item is added to ...@@ -32,10 +33,6 @@ refers to a directory (rather than a file). No item is added to
\code{\#} are skipped. \code{\#} are skipped.
\index{package} \index{package}
\indexiii{path}{configuration}{file} \indexiii{path}{configuration}{file}
\kwindex{sys.prefix}
\kwindex{sys.exec_prefix}
\kwindex{prefix}
\kwindex{exec_prefix}
For example, suppose \code{sys.prefix} and \code{sys.exec_prefix} are For example, suppose \code{sys.prefix} and \code{sys.exec_prefix} are
set to \file{/usr/local}. The Python 1.5 library is then installed in set to \file{/usr/local}. The Python 1.5 library is then installed in
...@@ -61,7 +58,8 @@ and \file{bar.pth} contains: ...@@ -61,7 +58,8 @@ and \file{bar.pth} contains:
bar bar
\end{verbatim}\ecode \end{verbatim}\ecode
Then the following directories are added to sys.path, in this order: Then the following directories are added to \code{sys.path}, in this
order:
\bcode\begin{verbatim} \bcode\begin{verbatim}
/usr/local/python1.5/site-packages/bar /usr/local/python1.5/site-packages/bar
...@@ -75,11 +73,11 @@ Note that \file{bletch} is omitted because it doesn't exist; the ...@@ -75,11 +73,11 @@ Note that \file{bletch} is omitted because it doesn't exist; the
configuration file. configuration file.
After these path manipulations, an attempt is made to import a module After these path manipulations, an attempt is made to import a module
named \code{sitecustomize}, which can perform arbitrary site-specific named \code{sitecustomize}\refmodindex{sitecustomize}, which can
customizations. If this import fails with an \code{ImportError} perform arbitrary site-specific customizations. If this import fails
exception, it is silently ignored. with an \code{ImportError} exception, it is silently ignored.
\refmodindex{sitecustomize}
Note that for some non-Unix systems, \code{sys.prefix} and Note that for some non-\UNIX{} systems, \code{sys.prefix} and
\code{sys.exec_prefix} are empty, and the path manipulations are \code{sys.exec_prefix} are empty, and the path manipulations are
skipped; however the import of \code{sitecustomize} is still attempted. skipped; however the import of
\code{sitecustomize}\refmodindex{sitecustomize} is still attempted.
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment