1515\tableofcontents
1616
1717\section {Introduction }
18- \label {sec: intro }
18+ \label {intro }
1919
2020In the past, Python module developers have not had much infrastructure
2121support for distributing modules, nor have Python users had much support
@@ -38,7 +38,7 @@ \section{Introduction}
3838
3939
4040\section {Concepts \& Terminology }
41- \label {sec: concepts }
41+ \label {concepts }
4242
4343Using the Distutils is quite simple, both for module developers and for
4444users/administrators installing third-party modules. As a developer,
@@ -65,7 +65,7 @@ \section{Concepts \& Terminology}
6565
6666
6767\subsection {A simple example }
68- \label {sec: simple-example }
68+ \label {simple-example }
6969
7070The setup script is usually quite simple, although since it's written in
7171Python, there are no arbitrary limits to what you can do. If all you
@@ -140,7 +140,7 @@ \subsection{A simple example}
140140
141141
142142\subsection {General Python terminology }
143- \label {sec: python-terms }
143+ \label {python-terms }
144144
145145If you're reading this document, you probably have a good idea of what
146146modules, extensions, and so forth are. Nevertheless, just to be sure
@@ -167,7 +167,7 @@ \subsection{General Python terminology}
167167
168168
169169\subsection {Distutils-specific terminology }
170- \label {sec: distutils-term }
170+ \label {distutils-term }
171171
172172The following terms apply more specifically to the domain of
173173distributing Python modules using the Distutils:
@@ -192,13 +192,13 @@ \subsection{Distutils-specific terminology}
192192
193193
194194\section {Writing the Setup Script }
195- \label {sec: setup-script }
195+ \label {setup-script }
196196
197197The setup script is the centre of all activity in building,
198198distributing, and installing modules using the Distutils. The main
199199purpose of the setup script is to describe your module distribution to
200200the Distutils, so that the various commands that operate on your modules
201- do the right thing. As we saw in section~\ref {sec: simple-example }
201+ do the right thing. As we saw in section~\ref {simple-example }
202202above, the setup script consists mainly of a call to \function {setup()},
203203and all information supplied to the Distutils is suppled as keyword
204204arguments to \function {setup()}.
@@ -225,7 +225,7 @@ \section{Writing the Setup Script}
225225 )
226226\end {verbatim }
227227There are only two differences between this and the trivial one-file
228- distribution presented in section~\ref {sec: simple-example }: more
228+ distribution presented in section~\ref {simple-example }: more
229229meta-data, and the specification of pure Python modules by package,
230230rather than by module. This is important since the Distutils consist of
231231a couple of dozen modules split into (so far) two packages; an explicit
@@ -245,7 +245,7 @@ \section{Writing the Setup Script}
245245
246246
247247\subsection {Package directories }
248- \label {sec: package-dirs }
248+ \label {package-dirs }
249249
250250The \option {packages} option tells the Distutils to process (build,
251251distribute, install, etc.) all pure Python modules found in each package
@@ -292,12 +292,12 @@ \subsection{Package directories}
292292
293293
294294\subsection {Listing individual modules }
295- \label {sec: listing-modules }
295+ \label {listing-modules }
296296
297297For a small module distribution, you might prefer to list all modules
298298rather than listing packages---especially the case of a single module
299299that goes in the `` root package'' (i.e., no package at all). This
300- simplest case was shown in section~\ref {sec: simple-example }; here is a
300+ simplest case was shown in section~\ref {simple-example }; here is a
301301slightly more involved example:
302302\begin {verbatim }
303303py_modules = ['mod1', 'pkg.mod2']
@@ -312,7 +312,7 @@ \subsection{Listing individual modules}
312312
313313
314314\section {Writing the Setup Configuration File }
315- \label {sec: setup-config }
315+ \label {setup-config }
316316
317317\XXX {not implemented yet!}
318318
@@ -338,9 +338,9 @@ \section{Writing the Setup Configuration File}
338338
339339
340340\section {Creating a Source Distribution }
341- \label {sec: source-dist }
341+ \label {source-dist }
342342
343- As shown in section~\ref {sec: simple-example }, you use the
343+ As shown in section~\ref {simple-example }, you use the
344344\command {sdist} command to create a source distribution. In the
345345simplest case,
346346\begin {verbatim }
@@ -376,7 +376,7 @@ \section{Creating a Source Distribution}
376376
377377
378378\subsection {The manifest and manifest template }
379- \label {sec: manifest }
379+ \label {manifest }
380380
381381Without any additional information, the \command {sdist} command puts a
382382minimal set of files into the source distribution:
@@ -414,7 +414,7 @@ \subsection{The manifest and manifest template}
414414\file {examples} directory matching \code {*.txt} or \code {*.py}, and
415415exclude all directories matching \code {examples/sample?/build}. There
416416are several other commands available in the manifest template
417- mini-language; see section~\ref {sec: sdist-cmd }.
417+ mini-language; see section~\ref {sdist-cmd }.
418418
419419The order of commands in the manifest template very much matters:
420420initially, we have the list of default files as described above, and
@@ -454,7 +454,7 @@ \subsection{The manifest and manifest template}
454454
455455
456456\subsection {Manifest-related options }
457- \label {sec: manifest-options }
457+ \label {manifest-options }
458458
459459The normal course of operations for the \command {sdist} command is as
460460follows:
@@ -493,7 +493,7 @@ \subsection{Manifest-related options}
493493
494494
495495\section {Creating Built Distributions }
496- \label {sec: built-dist }
496+ \label {built-dist }
497497
498498A `` built distribution'' is what you're probably used to thinking of
499499either as a `` binary package'' or an `` installer'' (depending on your
@@ -594,72 +594,72 @@ \section{Creating Built Distributions}
594594\end {tableii }
595595
596596\section {Examples }
597- \label {sec: examples }
597+ \label {examples }
598598
599599
600600\subsection {Pure Python distribution (by module) }
601- \label {sec: pure-mod }
601+ \label {pure-mod }
602602
603603
604604\subsection {Pure Python distribution (by package) }
605- \label {sec: pure-pkg }
605+ \label {pure-pkg }
606606
607607
608608\subsection {Single extension module }
609- \label {sec: single-ext }
609+ \label {single-ext }
610610
611611
612612\subsection {Multiple extension modules }
613- \label {sec: multiple-ext }
613+ \label {multiple-ext }
614614
615615
616616\subsection {Putting it all together }
617617
618618
619619
620620\section {Extending the Distutils }
621- \label {sec: extending }
621+ \label {extending }
622622
623623
624624\subsection {Extending existing commands }
625- \label {sec: extend-existing }
625+ \label {extend-existing }
626626
627627
628628\subsection {Writing new commands }
629- \label {sec: new-commands }
629+ \label {new-commands }
630630
631631
632632
633633\section {Reference }
634- \label {sec: ref }
634+ \label {ref }
635635
636636
637637\subsection {Building modules: the \protect\command {build} command family }
638- \label {sec: build-cmds }
638+ \label {build-cmds }
639639
640640\subsubsection {\protect\command {build} }
641- \label {sec: build-cmd }
641+ \label {build-cmd }
642642
643643\subsubsection {\protect\command {build\_ py} }
644- \label {sec: build-py-cmd }
644+ \label {build-py-cmd }
645645
646646\subsubsection {\protect\command {build\_ ext} }
647- \label {sec: build-ext-cmd }
647+ \label {build-ext-cmd }
648648
649649\subsubsection {\protect\command {build\_ clib} }
650- \label {sec: build-clib-cmd }
650+ \label {build-clib-cmd }
651651
652652
653653\subsection {Installing modules: the \protect\command {install} command family }
654- \label {sec: install-cmd }
654+ \label {install-cmd }
655655
656656
657657\subsection {Cleaning up: the \protect\command {clean} command }
658- \label {sec: clean-cmd }
658+ \label {clean-cmd }
659659
660660
661661\subsection {Creating a source distribution: the \protect\command {sdist} command }
662- \label {sec: sdist-cmd }
662+ \label {sdist-cmd }
663663
664664
665665\XXX {fragment moved down from above: needs context!}
@@ -694,7 +694,7 @@ \subsection{Creating a source distribution: the \protect\command{sdist} command}
694694
695695\subsection {Creating a `` built'' distribution: the
696696 \protect\command {bdist} command family }
697- \label {sec: bdist-cmds }
697+ \label {bdist-cmds }
698698
699699
700700\subsubsection {\protect\command {blib} }
0 commit comments