[Zope3-checkins] SVN: Zope3/trunk/src/zope/publisher/contenttype.py add to the module docstring and comments

[Fred L. Drake, Jr.]

Log message for revision 37583:
  add to the module docstring and comments

Changed:
  U   Zope3/trunk/src/zope/publisher/contenttype.py

-=-
Modified: Zope3/trunk/src/zope/publisher/contenttype.py
===================================================================
--- Zope3/trunk/src/zope/publisher/contenttype.py	2005-07-29 23:10:34 UTC (rev 37582)
+++ Zope3/trunk/src/zope/publisher/contenttype.py	2005-07-29 23:14:25 UTC (rev 37583)
@@ -13,12 +13,19 @@
 ##############################################################################
 """MIME Content-Type parsing helper functions.
 
+This supports parsing RFC 1341 Content-Type values, including
+quoted-string values as defined in RFC 822.
+
 """
 __docformat__ = "reStructuredText"
 
 import re
 
 
+# TODO: This still needs to support comments in structured fields as
+# specified in RFC 2822.
+
+
 def parse(string):
     major, minor, params = parseOrdered(string)
     d = {}
@@ -80,6 +87,7 @@
 
 
 def _quoted_string_match(string):
+    # This support RFC 822 quoted-string values.
     global _quoted_string_match
     _quoted_string_match = re.compile(
         '"(?:\\\\.|[^"\n\r\\\\])*"', re.DOTALL).match