From f37c0c73fef929a3bf3239bc10fd8ca0d63bcd9c Mon Sep 17 00:00:00 2001 From: Eli Bendersky Date: Thu, 2 Aug 2012 02:56:39 +0300 Subject: Issue #15321: update PyPI upload doc to say --no-raw passed to rst2html.py --- Doc/distutils/uploading.rst | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/Doc/distutils/uploading.rst b/Doc/distutils/uploading.rst index 1b3cb58..bfb392e 100644 --- a/Doc/distutils/uploading.rst +++ b/Doc/distutils/uploading.rst @@ -73,4 +73,8 @@ check the ``long_description`` from the command line:: $ 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. + -- cgit v0.12