Issue #15321: update PyPI upload doc to say --no-raw passed to rst2html.py. Patch by Chris Jerdonek
diff --git a/Doc/distutils/uploading.rst b/Doc/distutils/uploading.rst
index 1b3cb58..dc1025f 100644
--- 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.