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

diff --git a/Doc/distutils/uploading.rst b/Doc/distutils/uploading.rst
index 936402b5ba32958661207f56ec9fa50c135216dc..12ee32856e86a30158a4127a521e881346f38fe8 100644 (file)
--- a/Doc/distutils/uploading.rst
+++ b/Doc/distutils/uploading.rst
@@ -74,4 +74,9 @@ and 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.
+:mod:`docutils` will display a warning if there's something wrong with your
+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.
+