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

[eli.bendersky]

http://hg.python.org/cpython/rev/f315cfa22630
changeset:   78267:f315cfa22630
user:        Eli Bendersky <eliben at gmail.com>
date:        Tue Jul 24 19:51:06 2012 +0300
summary:
  Issue #15321: update PyPI upload doc to say --no-raw passed to rst2html.py. Patch by Chris Jerdonek

files:
  Doc/distutils/uploading.rst |  4 +++-
  1 files changed, 3 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,6 @@
     $ 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), running the command above without
+warnings is not sufficient for PyPI to convert the content successfully.

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