mirrors/cpython
1
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2025-07-31 15:14:22 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 9

Add more explanation of how data_files is used (esp. where the files end up

Browse source 
in the installation and how that location is determined).
This commit is contained in:
Fred Drake 2002-03-08 22:02:06 +00:00
parent 90d1006e92
commit 632bda3aa0
1 changed files with 13 additions and 2 deletions
Download patch file Download diff file Expand all files Collapse all files

15
Doc/dist/dist.tex vendored
View file

@ -632,8 +632,8 @@ The \option{data\_files} option can be used to specify additional
files needed by the module distribution: configuration files, files needed by the module distribution: configuration files,
data files, anything which does not fit in the previous categories. data files, anything which does not fit in the previous categories.
\option{data\_files} specify a sequence of \code{(directory, files)} \option{data\_files} specifies a sequence of (\var{directory},
pairs in the following way: \var{files}) pairs in the following way:
\begin{verbatim} \begin{verbatim}
setup(... setup(...
@ -644,6 +644,17 @@ setup(...
Note that you can specify the directory names where the data files Note that you can specify the directory names where the data files
will be installed, but you cannot rename the data files themselves. will be installed, but you cannot rename the data files themselves.
Each (\var{directory}, \var{files}) pair in the sequence specifies the
installation directory and the files to install there. If
\var{directory} is a relative path, it is interpreted relative to the
installation prefix (Python's \code{sys.prefix} for pure-Python
packages, \code{sys.exec_prefix} for packages that contain extension
modules). Each file name in \var{files} is interpreted relative to
the \file{setup.py} script at the top of the package source
distribution. No directory information from \var{files} is used to
determine the final location of the installed file; only the name of
the file is used.
You can specify the \option{data\_files} options as a simple sequence You can specify the \option{data\_files} options as a simple sequence
of files without specifying a target directory, but this is not recommended, of files without specifying a target directory, but this is not recommended,
and the \command{install} command will print a warning in this case. and the \command{install} command will print a warning in this case.