Add reST targets to sections of the setup.cfg spec, improve wording
diff --git a/Doc/packaging/setupcfg.rst b/Doc/packaging/setupcfg.rst
index 1a394b5..9b09a4c 100644
--- a/Doc/packaging/setupcfg.rst
+++ b/Doc/packaging/setupcfg.rst
@@ -19,6 +19,8 @@
:local:
+.. _setupcfg-syntax:
+
Syntax
======
@@ -117,6 +119,8 @@
file**. This will be useful to let users publish a single file.
+.. _setupcfg-sections:
+
Description of sections and fields
==================================
@@ -149,6 +153,8 @@
on the command line.
+.. _setupcfg-section-global:
+
Global options
--------------
@@ -194,6 +200,9 @@
setup_hooks = _setuphooks.customize_config
+
+.. _setupcfg-section-metadata:
+
Metadata
--------
@@ -318,6 +327,8 @@
from the fields present in the file.
+.. _setupcfg-section-files:
+
Files
-----
@@ -325,7 +336,8 @@
packages_root
the root directory containing all packages and modules
- (default: current directory). *optional*
+ (default: current directory, i.e. the project's top-level
+ directory where :file:`setup.cfg` lives). *optional*
packages
a list of packages the project includes *optional*, *multi*
@@ -337,8 +349,8 @@
a list of scripts the project includes *optional*, *multi*
extra_files
- a list of patterns to include extra files *optional*,
- *multi*
+ a list of patterns for additional files to include in source distributions
+ (see :ref:`packaging-manifest`) *optional*, *multi*
Example::
@@ -747,8 +759,10 @@
{scripts} category.
-Extension sections
-------------------
+.. _setupcfg-section-extensions:
+
+Extension modules sections
+--------------------------
If a project includes extension modules written in C or C++, each one of them
needs to have its options defined in a dedicated section. Here's an example::
@@ -779,8 +793,10 @@
``--``.
-Command sections
-----------------
+.. _setupcfg-section-commands:
+
+Commands sections
+-----------------
To pass options to commands without having to type them on the command line
for each invocation, you can write them in the :file:`setup.cfg` file, in a
@@ -803,6 +819,11 @@
Option values given in the configuration file can be overriden on the command
line. See :ref:`packaging-setup-config` for more information.
+These sections are also used to define :ref:`command hooks
+<packaging-command-hooks>`.
+
+
+.. _setupcfg-extensibility:
Extensibility
=============
@@ -817,6 +838,8 @@
X-Debian-Name = python-distribute
+.. _setupcfg-changes:
+
Changes in the specification
============================
@@ -852,6 +875,8 @@
- May write optional fields.
+.. _setupcfg-acks:
+
Acknowledgments
===============