Commit d7e44b61 authored by Berker Peksag's avatar Berker Peksag

Issue #17264: Fix cross refs and a markup error in extending/building.rst

parents 734423b8 705c0e38
...@@ -40,7 +40,7 @@ It is possible to export multiple modules from a single shared library by ...@@ -40,7 +40,7 @@ It is possible to export multiple modules from a single shared library by
defining multiple initialization functions. However, importing them requires defining multiple initialization functions. However, importing them requires
using symbolic links or a custom importer, because by default only the using symbolic links or a custom importer, because by default only the
function corresponding to the filename is found. function corresponding to the filename is found.
See :PEP:`489#multiple-modules-in-one-library` for details. See the *"Multiple modules in one library"* section in :pep:`489` for details.
.. highlightlang:: c .. highlightlang:: c
...@@ -88,7 +88,8 @@ distutils; this section explains building extension modules only. ...@@ -88,7 +88,8 @@ distutils; this section explains building extension modules only.
It is common to pre-compute arguments to :func:`setup`, to better structure the It is common to pre-compute arguments to :func:`setup`, to better structure the
driver script. In the example above, the ``ext_modules`` argument to driver script. In the example above, the ``ext_modules`` argument to
:func:`setup` is a list of extension modules, each of which is an instance of :func:`~distutils.core.setup` is a list of extension modules, each of which is
an instance of
the :class:`~distutils.extension.Extension`. In the example, the instance the :class:`~distutils.extension.Extension`. In the example, the instance
defines an extension named ``demo`` which is build by compiling a single source defines an extension named ``demo`` which is build by compiling a single source
file, :file:`demo.c`. file, :file:`demo.c`.
...@@ -119,7 +120,8 @@ example below. :: ...@@ -119,7 +120,8 @@ example below. ::
ext_modules = [module1]) ext_modules = [module1])
In this example, :func:`setup` is called with additional meta-information, which In this example, :func:`~distutils.core.setup` is called with additional
meta-information, which
is recommended when distribution packages have to be built. For the extension is recommended when distribution packages have to be built. For the extension
itself, it specifies preprocessor defines, include directories, library itself, it specifies preprocessor defines, include directories, library
directories, and libraries. Depending on the compiler, distutils passes this directories, and libraries. Depending on the compiler, distutils passes this
...@@ -150,8 +152,7 @@ Module maintainers should produce source packages; to do so, they run :: ...@@ -150,8 +152,7 @@ Module maintainers should produce source packages; to do so, they run ::
python setup.py sdist python setup.py sdist
In some cases, additional files need to be included in a source distribution; In some cases, additional files need to be included in a source distribution;
this is done through a :file:`MANIFEST.in` file; see the distutils documentation this is done through a :file:`MANIFEST.in` file; see :ref:`manifest` for details.
for details.
If the source distribution has been build successfully, maintainers can also If the source distribution has been build successfully, maintainers can also
create binary distributions. Depending on the platform, one of the following create binary distributions. Depending on the platform, one of the following
......
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