Hi, again

Weather is getting worse and also my time, but I get to add some documentation
to metafora.
Here it is and extract of the fundamental part.

As before, suggestions/corrections either functional or semantical are
welcomed.


-Oscar Rambla


=================================================================
-metafora.py
=================================================================

 def form_css(request):
+    """
+    Here you can edit your form css style.
+
+    This is simple form handler function in that only form submit widgets
+    can be submitted
+
+    - When a form submit_widget submits, form parses widgets values
(has_error)
+      and errors if any are rendered. Otherwise form is processed.
+    """

 def edit_form(request):
+    """
+    Here you can introduce your form attributes.
+
+    This is a rather common form handler function that contains simple and
+    composite widgets.
+
+    - When a composite widget submits, widgets are parsed and errors are
+      cleared before rendering the page.
+    """

 def widget_handle(request, widget):
+    """
+    Here you can introduce your form widgets attributes.
+
+    This is a rather complex form handler function that contains simple and
+    composite widgets and an OptionSelect widget.
+
+    - When the OptionSelect widget submits, new widgets are created based
+      on the selection that might not be present in the request.
+      In this case I reset widgets value, otherwise it would be lost.
+      Errors are cleared before rendering the page.
+
+    """