From eb483b087b66077e23d664717d00c8005eedf38f Mon Sep 17 00:00:00 2001
From: Chris Jerdonek <chris.jerdonek@gmail.com>
Date: Sat, 22 Sep 2012 20:00:46 -0700
Subject: Improve README.md comment re: HTML in reST long description.

---
 README.md | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 5644b7b..24e3013 100644
--- a/README.md
+++ b/README.md
@@ -1,8 +1,12 @@
 Pystache
 ========
 
-<!-- We strip out 1-line HTML comments prior to passing to pandoc because -->
-<!-- PyPI rejects reST long descriptions that contain HTML. -->
+<!-- Since PyPI rejects reST long descriptions that contain HTML, -->
+<!-- HTML comments must be removed when converting this file to reST. -->
+<!-- For more information on PyPI's behavior in this regard, see: -->
+<!-- http://docs.python.org/distutils/uploading.html#pypi-package-display -->
+<!-- The Pystache setup script strips 1-line HTML comments prior -->
+<!-- to converting to reST, so all HTML comments should be one line. -->
 
 <!-- We leave the leading brackets empty here.  Otherwise, unwanted -->
 <!-- caption text shows up in the reST version converted by pandoc. -->
-- 
cgit v1.2.1