From f37c0c73fef929a3bf3239bc10fd8ca0d63bcd9c Mon Sep 17 00:00:00 2001
From: Eli Bendersky <eliben@gmail.com>
Date: Thu, 2 Aug 2012 02:56:39 +0300
Subject: [PATCH] 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 1b3cb589ecc..bfb392e3b68 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.
+