[Zope3-checkins] SVN: Zope3/trunk/src/zope/app/form/interfaces.py add a note about what it means for setPrefix() to be called more than once

[Fred L. Drake, Jr.]

Log message for revision 33296:
  add a note about what it means for setPrefix() to be called more than once

Changed:
  U   Zope3/trunk/src/zope/app/form/interfaces.py

-=-
Modified: Zope3/trunk/src/zope/app/form/interfaces.py
===================================================================
--- Zope3/trunk/src/zope/app/form/interfaces.py	2005-07-13 12:02:58 UTC (rev 33295)
+++ Zope3/trunk/src/zope/app/form/interfaces.py	2005-07-13 14:07:13 UTC (rev 33296)
@@ -150,8 +150,13 @@
         """Set the name prefix used for the widget
 
         The widget name is used to identify the widget's data within
-        input data. For example, for HTTP forms, the widget name is
+        input data.  For example, for HTTP forms, the widget name is
         used for the form key.
+
+        It is acceptable to *reset* the prefix: set it once to read
+        values from the request, and again to redraw with a different
+        prefix but maintained state.
+                        
         """
 
 class IInputWidget(IWidget):