Issue #15321: update PyPI upload doc to say --no-raw passed to rst2html.py. Patch...

diff --git a/Doc/distutils/uploading.rst b/Doc/distutils/uploading.rst
index 1b3cb589ecc6b5a5c884ef2f37a8adc92ff8cba0..dc1025fdc072ba20a8c134182f22d9229a9e007c 100644 (file)
--- a/Doc/distutils/uploading.rst
+++ b/Doc/distutils/uploading.rst
@@ -73,4 +73,6 @@ 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), running the command above without
+warnings is not sufficient for PyPI to convert the content successfully.