This issue is to improve the organization of the PyPI section of the Distutils documentation, now that the information has been combined into one page.

A patch is attached.

Improvements include:

(1) Creating a section for command options common to both register and upload.  Previously, this information was confined to the upload section, even though the information was applicable to both commands.
(2) Separating general information about PyPI (e.g. PyPI user permissions and the web interface) from the information about Distutils command usage.
(3) Consolidating information about the .pypirc file in the .pypirc section.  Previously, some of the .pypirc information was spread throughout the upload section, even though the information is equally applicable to the register command.

This looks good to me. It may also be worth changing example URLs to use "https" instead of "http", and mentioning the test PyPI server in the pypirc section: https://wiki.python.org/moin/TestPyPI

Chris, please proceed.

+1

New changeset 12536a991007 by R David Murray in branch '3.4':
#17325: Improve distutils PyPI documentation.
https://hg.python.org/cpython/rev/12536a991007

New changeset 8e4afcaa196c by R David Murray in branch 'default':
Merge: #17325: Improve distutils PyPI documentation.
https://hg.python.org/cpython/rev/8e4afcaa196c

New changeset 77098919f819 by R David Murray in branch '2.7':
#17325: Improve distutils PyPI documentation.
https://hg.python.org/cpython/rev/77098919f819

Committed.  I changed the urls as suggested by Antoine.  I also added a link to the test pypi page, though I'm not sure what I did is exactly what Antoine had in mind.