Thanks to visit codestin.com
Credit goes to github.com

Skip to content

Commit e78298a

Browse files
committed
Stripped leading 'sec:' from all section labels -- generates bad filenames,
bad link URLs in HTML, etc.
1 parent e9792c4 commit e78298a

2 files changed

Lines changed: 57 additions & 57 deletions

File tree

Doc/dist/dist.tex

Lines changed: 36 additions & 36 deletions
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@
1515
\tableofcontents
1616

1717
\section{Introduction}
18-
\label{sec:intro}
18+
\label{intro}
1919

2020
In the past, Python module developers have not had much infrastructure
2121
support 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

4343
Using the Distutils is quite simple, both for module developers and for
4444
users/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

7070
The setup script is usually quite simple, although since it's written in
7171
Python, 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

145145
If you're reading this document, you probably have a good idea of what
146146
modules, 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

172172
The following terms apply more specifically to the domain of
173173
distributing 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

197197
The setup script is the centre of all activity in building,
198198
distributing, and installing modules using the Distutils. The main
199199
purpose of the setup script is to describe your module distribution to
200200
the 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}
202202
above, the setup script consists mainly of a call to \function{setup()},
203203
and all information supplied to the Distutils is suppled as keyword
204204
arguments to \function{setup()}.
@@ -225,7 +225,7 @@ \section{Writing the Setup Script}
225225
)
226226
\end{verbatim}
227227
There 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
229229
meta-data, and the specification of pure Python modules by package,
230230
rather than by module. This is important since the Distutils consist of
231231
a 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

250250
The \option{packages} option tells the Distutils to process (build,
251251
distribute, 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

297297
For a small module distribution, you might prefer to list all modules
298298
rather than listing packages---especially the case of a single module
299299
that 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
301301
slightly more involved example:
302302
\begin{verbatim}
303303
py_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
345345
simplest 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

381381
Without any additional information, the \command{sdist} command puts a
382382
minimal 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
415415
exclude all directories matching \code{examples/sample?/build}. There
416416
are 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

419419
The order of commands in the manifest template very much matters:
420420
initially, 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

459459
The normal course of operations for the \command{sdist} command is as
460460
follows:
@@ -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

498498
A ``built distribution'' is what you're probably used to thinking of
499499
either 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

Comments
 (0)