- modify z.a.folder.browser to use browser:containerViews

  (for conciseness and to set a good example)
- fix <browser:containerViews index="..."/> to create an index page instead
  of a contents page

(merged from Zope3 trunk revision 27485)

browser/ftests/index.txt

@@ -0,0 +1,18 @@
+The containerViews directive lets us associate some standard forms
+for containers with an interface.  There's an "index.html" view that
+provides a listing of the contained objects without provinding any way
+to manage them (though it allows us to visit them by clicking on
+links).
+
+We can get this view from the root folder easily::
+
+  >>> response = http(r"""
+  ... GET / HTTP/1.1
+  ... """)
+
+And we can check that there isn't a form (where the management
+operations would have buttons)::
+
+  >>> body = response.getBody().lower()
+  >>> "<form" in body
+  False

browser/ftests/test_contents.py

@@ -27,6 +27,8 @@
 from zope.app.annotation.interfaces import IAttributeAnnotatable
 from zope.app.dublincore.interfaces import IZopeDublinCore
 
+from zope.app.tests.functional import FunctionalDocFileSuite
+
 class File(Persistent):
     implements(IAttributeAnnotatable)
 
@@ -261,6 +263,7 @@ def test_paste_for_deleted_clipboard_item(self):
 def test_suite():
     suite = unittest.TestSuite()
     suite.addTest(unittest.makeSuite(Test))
+    suite.addTest(FunctionalDocFileSuite("index.txt"))
     return suite
 
 if __name__=='__main__':

browser/metaconfigure.py

@@ -66,7 +66,7 @@ def containerViews(_context, for_, contents=None, add=None, index=None):
 
     if index is not None:
         page(_context, name='index.html', permission=index, for_=for_, 
-             class_=Contents, attribute='contents')
+             class_=Contents, attribute='index')
 
     if add is not None:
         viewObj = view(_context, name='+', menu='zmi_actions',