diff options
| author | Jason R. Coombs <jaraco@jaraco.com> | 2017-01-07 13:23:43 -0500 |
|---|---|---|
| committer | Jason R. Coombs <jaraco@jaraco.com> | 2017-01-07 13:23:43 -0500 |
| commit | 3c182f9f1eea89040fbfc88d1ccbed31ece6a00b (patch) | |
| tree | d609cf9cc00bfc24fb5c63ec0c3783c4da27f7db | |
| parent | 9c4d84f53e96b023c79ef54b8092a8c1440212ab (diff) | |
| download | python-setuptools-git-3c182f9f1eea89040fbfc88d1ccbed31ece6a00b.tar.gz | |
Remove documentation for upload_docs command, deprecated in v27.
| -rw-r--r-- | docs/setuptools.txt | 62 |
1 files changed, 0 insertions, 62 deletions
diff --git a/docs/setuptools.txt b/docs/setuptools.txt index 5c72445b..2a494fca 100644 --- a/docs/setuptools.txt +++ b/docs/setuptools.txt @@ -2273,68 +2273,6 @@ password from the keyring. New in 20.1: Added keyring support. -.. _upload_docs: - -``upload_docs`` - Upload package documentation to PyPI -====================================================== - -PyPI now supports uploading project documentation to the dedicated URL -https://pythonhosted.org/<project>/. - -The ``upload_docs`` command will create the necessary zip file out of a -documentation directory and will post to the repository. - -Note that to upload the documentation of a project, the corresponding version -must already be registered with PyPI, using the distutils ``register`` -command -- just like the ``upload`` command. - -Assuming there is an ``Example`` project with documentation in the -subdirectory ``docs``, e.g.:: - - Example/ - |-- example.py - |-- setup.cfg - |-- setup.py - |-- docs - | |-- build - | | `-- html - | | | |-- index.html - | | | `-- tips_tricks.html - | |-- conf.py - | |-- index.txt - | `-- tips_tricks.txt - -You can simply pass the documentation directory path to the ``upload_docs`` -command:: - - python setup.py upload_docs --upload-dir=docs/build/html - -If no ``--upload-dir`` is given, ``upload_docs`` will attempt to run the -``build_sphinx`` command to generate uploadable documentation. -For the command to become available, `Sphinx <http://sphinx.pocoo.org/>`_ -must be installed in the same environment as distribute. - -As with other ``setuptools``-based commands, you can define useful -defaults in the ``setup.cfg`` of your Python project, e.g.: - -.. code-block:: ini - - [upload_docs] - upload-dir = docs/build/html - -The ``upload_docs`` command has the following options: - -``--upload-dir`` - The directory to be uploaded to the repository. - -``--show-response`` - Display the full response text from server; this is useful for debugging - PyPI problems. - -``--repository=URL, -r URL`` - The URL of the repository to upload to. Defaults to - https://pypi.python.org/pypi (i.e., the main PyPI installation). - ----------------------------------------- Configuring setup() using setup.cfg files |
