summaryrefslogtreecommitdiffstats
path: root/Doc/distutils
diff options
context:
space:
mode:
authorTarek Ziadé <ziade.tarek@gmail.com>2009-02-16 21:49:12 (GMT)
committerTarek Ziadé <ziade.tarek@gmail.com>2009-02-16 21:49:12 (GMT)
commit0d0506ecef273135cf5c13ad5be2ad6448a155eb (patch)
tree122c0fd75c413ac96bc90b82b5ebcc0e2571fe77 /Doc/distutils
parent25e26a02f4bd5500cf29e3b298ddc2447e07abd1 (diff)
downloadcpython-0d0506ecef273135cf5c13ad5be2ad6448a155eb.zip
cpython-0d0506ecef273135cf5c13ad5be2ad6448a155eb.tar.gz
cpython-0d0506ecef273135cf5c13ad5be2ad6448a155eb.tar.bz2
Merged revisions 69692 via svnmerge from
svn+ssh://pythondev@svn.python.org/python/trunk ........ r69692 | tarek.ziade | 2009-02-16 22:38:01 +0100 (Mon, 16 Feb 2009) | 1 line Fixed #2279: distutils.sdist.add_defaults now add files listed in package_data and data_files ........
Diffstat (limited to 'Doc/distutils')
-rw-r--r--Doc/distutils/setupscript.rst19
-rw-r--r--Doc/distutils/sourcedist.rst12
2 files changed, 31 insertions, 0 deletions
diff --git a/Doc/distutils/setupscript.rst b/Doc/distutils/setupscript.rst
index 9ae2e4d..6fed2fa 100644
--- a/Doc/distutils/setupscript.rst
+++ b/Doc/distutils/setupscript.rst
@@ -427,6 +427,7 @@ The versions identified by the qualifiers are those that are obsoleted by the
distribution being described. If no qualifiers are given, all versions of the
named module or package are understood to be obsoleted.
+.. _distutils-installing-scripts:
Installing Scripts
==================
@@ -449,6 +450,12 @@ way. From the PyXML setup script::
scripts=['scripts/xmlproc_parse', 'scripts/xmlproc_val']
)
+All the scripts will also be added to the ``MANIFEST``
+file if no template is provided. See :ref:`manifest`.
+
+.. versionadded:: 2.7
+
+.. _distutils-installing-package-data:
Installing Package Data
=======================
@@ -491,6 +498,13 @@ The corresponding call to :func:`setup` might be::
)
+All the files that match ``package_data`` will be added to the ``MANIFEST``
+file if no template is provided. See :ref:`manifest`.
+
+.. versionadded:: 2.7
+
+.. _distutils-additional-files:
+
Installing Additional Files
===========================
@@ -525,6 +539,11 @@ without specifying a target directory, but this is not recommended, and the
files directly in the target directory, an empty string should be given as the
directory.
+All the files that match ``data_files`` will be added to the ``MANIFEST``
+file if no template is provided. See :ref:`manifest`.
+
+.. versionadded:: 2.7
+
.. _meta-data:
diff --git a/Doc/distutils/sourcedist.rst b/Doc/distutils/sourcedist.rst
index 960cc0a..5c0e5d0 100644
--- a/Doc/distutils/sourcedist.rst
+++ b/Doc/distutils/sourcedist.rst
@@ -74,6 +74,7 @@ source distribution:
:meth:`get_source_files` method in :file:`build_clib.py`! **\*\***)
* scripts identified by the :option:`scripts` option
+ See :ref:`distutils-installing-scripts`.
* anything that looks like a test script: :file:`test/test\*.py` (currently, the
Distutils don't do anything with test scripts except include them in source
@@ -83,6 +84,17 @@ source distribution:
* :file:`README.txt` (or :file:`README`), :file:`setup.py` (or whatever you
called your setup script), and :file:`setup.cfg`
+* all files that matches the ``package_data`` metadata.
+ See :ref:`distutils-installing-package-data`.
+
+ .. versionadded:: 2.7
+
+* all files that matches the ``data_files`` metadata.
+ See :ref:`distutils-additional-files`.
+
+ .. versionadded:: 2.7
+
+
Sometimes this is enough, but usually you will want to specify additional files
to distribute. The typical way to do this is to write a *manifest template*,
called :file:`MANIFEST.in` by default. The manifest template is just a list of