[wwwsearch-commits] r18438 - wwwsearch/ClientForm/trunk

[jjlee at codespeak.net]

Author: jjlee
Date: Wed Oct 12 00:59:33 2005
New Revision: 18438

Modified:
   wwwsearch/ClientForm/trunk/ClientForm.py
Log:
Tweak docs

Modified: wwwsearch/ClientForm/trunk/ClientForm.py
==============================================================================
--- wwwsearch/ClientForm/trunk/ClientForm.py	(original)
+++ wwwsearch/ClientForm/trunk/ClientForm.py	Wed Oct 12 00:59:33 2005
@@ -47,6 +47,7 @@
 #   necessary -- HTML spec. doesn't require it, and Mozilla Firebird 0.6
 #   doesn't seem to do it.
 #  Add charset parameter to Content-type headers?  How to find value??
+# mailto submission & enctype text/plain
 # I'm not going to fix this unless somebody tells me what real servers
 #  that want this encoding actually expect: If enctype is
 #  application/x-www-form-urlencoded and there's a FILE control present.
@@ -1602,8 +1603,8 @@
         If name is specified, then the item must have the indicated name.
 
         If label is specified, then the item must have a label whose
-        whitespace-compressed text substring-matches the indicated label
-        string (eg. label="please choose" will match
+        whitespace-compressed, stripped, text substring-matches the indicated
+        label string (eg. label="please choose" will match
         "  Do  please  choose an item ").
 
         If id is specified, then the item must have the indicated id.
@@ -1911,10 +1912,13 @@
         """Set the value of control by item labels.
 
         value is expected to be an iterable of strings that are substrings of
-        the item labels that should be selected.  Ambiguous labels are accepted
-        without complaint if the form's backwards_compat is True; otherwise,
-        it will not complain as long as all ambiguous labels share the same
-        item name (e.g. OPTION value).
+        the item labels that should be selected.  Before substring matching is
+        performed, the original label text is whitespace-compressed
+        (consecutive whitespace characters are converted to a single space
+        character) and leading and trailing whitespace is stripped.  Ambiguous
+        labels are accepted without complaint if the form's backwards_compat is
+        True; otherwise, it will not complain as long as all ambiguous labels
+        share the same item name (e.g. OPTION value).
 
         """
         if isstringlike(value):