[Python-checkins] CVS: python/dist/src/Doc/dist dist.tex,1.33,1.33.4.1

[Fred L. Drake]

Update of /cvsroot/python/python/dist/src/Doc/dist
In directory usw-pr-cvs1:/tmp/cvs-serv14367/dist

Modified Files:
      Tag: release21-maint
	dist.tex 
Log Message:
Add more explanation of how data_files is used (esp. where the files end up
in the installation and how that location is determined).


Index: dist.tex
===================================================================
RCS file: /cvsroot/python/python/dist/src/Doc/dist/dist.tex,v
retrieving revision 1.33
retrieving revision 1.33.4.1
diff -C2 -d -r1.33 -r1.33.4.1
*** dist.tex	1 Mar 2001 18:35:43 -0000	1.33
--- dist.tex	8 Mar 2002 22:02:26 -0000	1.33.4.1
***************
*** 633,638 ****
  data files, anything which does not fit in the previous categories.
  
! \option{data\_files} specify a sequence of \code{(directory, files)}
! pairs in the following way:
  
  \begin{verbatim}
--- 633,638 ----
  data files, anything which does not fit in the previous categories.
  
! \option{data\_files} specifies a sequence of (\var{directory},
! \var{files}) pairs in the following way:
  
  \begin{verbatim}
***************
*** 644,647 ****
--- 644,658 ----
  Note that you can specify the directory names where the data files
  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