Fix documentation warnings. Add more documents for the sphinx builder.

src/z3c/form/browser/README.txt

@@ -1,6 +1,6 @@
-======
-README
-======
+===============
+Browser support
+===============
 
 The ``z3c.form`` library provides a form framework and widgets. This document
 ensures that we implement a widget for each field defined in

src/z3c/form/browser/index.txt

@@ -0,0 +1,34 @@
+Browser support documentation
+=============================
+
+Contents:
+
+.. toctree::
+   :maxdepth: 2
+
+   button
+   checkbox
+   file
+   file-testing
+   image
+   multi
+   object
+   objectmulti
+   orderedselect
+   password
+   radio
+   select
+   select-source
+   submit
+   text
+   textarea
+   textlines
+   README
+
+
+Indices and tables
+==================
+
+* :ref:`genindex`
+* :ref:`modindex`
+* :ref:`search`

src/z3c/form/converter.txt

@@ -726,8 +726,7 @@ The same is true when getting the field value:
   <z3c.form.term.CollectionTermsVocabulary object ...>
 
 
-Corner case:
-Just in case the field has more ``_type``s:
+Corner case: Just in case the field has a sequence as ``_type``:
 
   >>> class myField(zope.schema.List):
   ...     _type = (list, tuple)
@@ -935,7 +934,7 @@ Converting Missing value to Widget value returns '':
   >>> tlc.toWidgetValue(tlc.field.missing_value)
   u''
 
-Just in case the field has more ``_type``s:
+Just in case the field has sequence as its ``_type``:
 
   >>> class myField(zope.schema.List):
   ...     _type = (list, tuple)

src/z3c/form/index.txt

@@ -23,7 +23,10 @@ Contents:
    adding
    value
    error
-   browser/README
+   hint
+   testing
+   object-caveat
+   browser/index
 
 Indices and tables
 ==================