convert from a howto to a manual

freddrake · freddrake · commit 211a2eb78464 · 2004-03-22T21:44:43.000Z
diff --git a/Doc/dist/dist.tex b/Doc/dist/dist.tex
@@ -1,4 +1,4 @@
-\documentclass{howto}
+\documentclass{manual}
 \usepackage{distutils}
 
 % $Id$
@@ -40,7 +40,7 @@
 %end{latexonly}
 
 
-\section{Introduction}
+\chapter{An Introduction to Distutils}
 \label{intro}
 
 This document covers using the Distutils to distribute your Python
@@ -76,7 +76,7 @@ \section{Concepts \& Terminology}
 without having to run a single setup script or compile a line of code.
 
 
-\subsection{A Simple Example}
+\section{A Simple Example}
 \label{simple-example}
 
 The setup script is usually quite simple, although since it's written
@@ -178,7 +178,7 @@ \subsection{A Simple Example}
 \end{verbatim}
 
 
-\subsection{General Python terminology}
+\section{General Python terminology}
 \label{python-terms}
 
 If you're reading this document, you probably have a good idea of what
@@ -217,7 +217,7 @@ \subsection{General Python terminology}
 \end{description}
 
 
-\subsection{Distutils-specific terminology}
+\section{Distutils-specific terminology}
 \label{distutils-term}
 
 The following terms apply more specifically to the domain of
@@ -245,7 +245,7 @@ \subsection{Distutils-specific terminology}
 \end{description}
 
 
-\section{Writing the Setup Script}
+\chapter{Writing the Setup Script}
 \label{setup-script}
 
 The setup script is the centre of all activity in building,
@@ -812,7 +812,7 @@ \subsection{Debugging the setup script}
 will now print detailed information what it is doing, and prints the
 full traceback in case an exception occurs.
 
-\section{Writing the Setup Configuration File}
+\chapter{Writing the Setup Configuration File}
 \label{setup-config}
 
 Often, it's not possible to write down everything needed to build a
@@ -949,7 +949,7 @@ \section{Writing the Setup Configuration File}
 \end{seealso}
 
 
-\section{Creating a Source Distribution}
+\chapter{Creating a Source Distribution}
 \label{source-dist}
 
 As shown in section~\ref{simple-example}, you use the
@@ -1142,7 +1142,7 @@ \subsection{Manifest-related options}
 \programopt{-f} for \longprogramopt{force-manifest}.
 
 
-\section{Creating Built Distributions}
+\chapter{Creating Built Distributions}
 \label{built-dist}
 
 A ``built distribution'' is what you're probably used to thinking of
@@ -1531,7 +1531,7 @@ \subsubsection{The Postinstallation script}
   documentation for the \class{IShellLink} interface.
 \end{funcdesc}
 
-\section{Registering with the Package Index}
+\chapter{Registering with the Package Index}
 \label{package-index}
 
 The Python Package Index (PyPI) holds meta-data describing distributions
@@ -1584,10 +1584,10 @@ \section{Registering with the Package Index}
 
 
 
-\section{Examples}
+\chapter{Examples}
 \label{examples}
   
-\subsection{Pure Python distribution (by module)}
+\section{Pure Python distribution (by module)}
 \label{pure-mod}
 
 If you're just distributing a couple of modules, especially if they
@@ -1638,7 +1638,7 @@ \subsection{Pure Python distribution (by module)}
 package rather than listing them individually.
 
 
-\subsection{Pure Python distribution (by package)}
+\section{Pure Python distribution (by package)}
 \label{pure-pkg}
 
 If you have more than a couple of modules to distribute, especially if
@@ -1760,7 +1760,7 @@ \subsection{Pure Python distribution (by package)}
 directory.)
 
 
-\subsection{Single extension module}
+\section{Single extension module}
 \label{single-ext}
 
 Extension modules are specified using the \option{ext\_modules} option.
@@ -1793,29 +1793,29 @@ \subsection{Single extension module}
 \end{verbatim}
 
 
-%\subsection{Multiple extension modules}
+%\section{Multiple extension modules}
 %\label{multiple-ext}
 
 
-%\subsection{Putting it all together}
+%\section{Putting it all together}
 
 
-%\section{Extending the Distutils}
+%\chapter{Extending the Distutils}
 %\label{extending}
 
 
-%\subsection{Extending existing commands}
+%\section{Extending existing commands}
 %\label{extend-existing}
 
 
-%\subsection{Writing new commands}
+%\section{Writing new commands}
 %\label{new-commands}
 
 %\XXX{Would an uninstall command be a good example here?}
 
 
 
-\section{Reference}
+\chapter{Command Reference}
 \label{reference}
 
 
@@ -1835,7 +1835,7 @@ \section{Reference}
 %\label{build-clib-cmd}
 
 
-\subsection{Installing modules: the \protect\command{install} command family}
+\section{Installing modules: the \protect\command{install} command family}
 \label{install-cmd}
 
 The install command ensures that the build commands have been run and then
@@ -1846,11 +1846,11 @@ \subsection{Installing modules: the \protect\command{install} command family}
 %\subsubsection{\protect\command{install\_lib}}
 %\label{install-lib-cmd}
 
-\subsubsection{\protect\command{install\_data}}
+\subsection{\protect\command{install\_data}}
 \label{install-data-cmd}
 This command installs all data files provided with the distribution.
 
-\subsubsection{\protect\command{install\_scripts}}
+\subsection{\protect\command{install\_scripts}}
 \label{install-scripts-cmd}
 This command installs all (Python) scripts in the distribution.
 
@@ -1859,7 +1859,7 @@ \subsubsection{\protect\command{install\_scripts}}
 %\label{clean-cmd}
 
 
-\subsection{Creating a source distribution: the
+\section{Creating a source distribution: the
             \protect\command{sdist} command}
 \label{sdist-cmd}
 
@@ -1898,18 +1898,18 @@ \subsection{Creating a source distribution: the
 \XXX{Windows and Mac OS support not there yet}
 
 
-%\subsection{Creating a built distribution: the
+%\section{Creating a built distribution: the
 %  \protect\command{bdist} command family}
 %\label{bdist-cmds}
 
 
-%\subsubsection{\protect\command{bdist}}
+%\subsection{\protect\command{bdist}}
 
-%\subsubsection{\protect\command{bdist\_dumb}}
+%\subsection{\protect\command{bdist\_dumb}}
 
-%\subsubsection{\protect\command{bdist\_rpm}}
+%\subsection{\protect\command{bdist\_rpm}}
 
-%\subsubsection{\protect\command{bdist\_wininst}}
+%\subsection{\protect\command{bdist\_wininst}}
 
 
 \input{sysconfig}
