[Python-checkins] python/dist/src/Doc/dist dist.tex,1.91,1.92

[fdrake at users.sourceforge.net]

Update of /cvsroot/python/python/dist/src/Doc/dist
In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv17007

Modified Files:
	dist.tex 
Log Message:
- fix markup bugs
- more consistent markup
- elaborate a couple of points


Index: dist.tex
===================================================================
RCS file: /cvsroot/python/python/dist/src/Doc/dist/dist.tex,v
retrieving revision 1.91
retrieving revision 1.92
diff -u -d -r1.91 -r1.92
--- dist.tex	21 Mar 2005 20:56:27 -0000	1.91
+++ dist.tex	22 Mar 2005 04:09:37 -0000	1.92
@@ -1738,14 +1738,20 @@
 command \command{upload} pushes the distribution files to PyPI.
 
 The command is invokes immediately after building one or more distribution
-files, e.g. as
+files.  For example, the command
 
 \begin{verbatim}
 python setup.py sdist bdist_wininst upload
 \end{verbatim}
 
+will cause the source distribution and the Windows installer to be
+uploaded to PyPI.  Note that these will be uploaded even if they are
+built using an earlier invocation of \file{setup.py}, but that only
+distributions named on the command line for the invocation including
+the \command{upload} command are uploaded.
+
 The \command{upload} command uses the username and password stored in
-in the file \file{$HOME/.pypirc}, see \ref{pypirc}.
+in the file \file{\$HOME/.pypirc}, see section~\ref{pypirc}.
 
 \chapter{Examples}
 \label{examples}
@@ -2087,9 +2093,12 @@
 
 \section{Adding new distribution types}
 
-Commands that create distributions (i.e. files in the dist directory)
-need to add (command, filename) pairs to \var{self.distribution.dist_files}
-so that \command{upload} can upload it to PyPI.
+Commands that create distributions (files in the \file{dist/}
+directory) need to add \code{(\var{command}, \var{filename})} pairs to
+\code{self.distribution.dist_files} so that \command{upload} can
+upload it to PyPI.  The \var{filename} in the pair contains no path
+information, only the name of the file itself.  In dry-run mode, pairs
+should still be added to represent what would have been created.
 
 \chapter{Command Reference}
 \label{reference}