[Python-checkins] cpython (3.2): Issue #15321: update PyPI upload doc to say --no-raw passed to rst2html.py

[eli.bendersky]

http://hg.python.org/cpython/rev/014b36383a54
changeset:   78377:014b36383a54
branch:      3.2
parent:      78366:2638ce032151
user:        Eli Bendersky <eliben at gmail.com>
date:        Thu Aug 02 02:56:39 2012 +0300
summary:
  Issue #15321: update PyPI upload doc to say --no-raw passed to rst2html.py

files:
  Doc/distutils/uploading.rst |  6 +++++-
  1 files changed, 5 insertions(+), 1 deletions(-)


diff --git a/Doc/distutils/uploading.rst b/Doc/distutils/uploading.rst
--- a/Doc/distutils/uploading.rst
+++ b/Doc/distutils/uploading.rst
@@ -73,4 +73,8 @@
     $ python setup.py --long-description | rst2html.py > output.html
 
 :mod:`docutils` will display a warning if there's something wrong with your
-syntax.
+syntax.  Because PyPI applies additional checks (e.g. by passing ``--no-raw``
+to ``rst2html.py`` in the command above), being able to run the command above
+without warnings does not guarantee that PyPI will convert the content
+successfully.
+

-- 
Repository URL: http://hg.python.org/cpython