[Zope3-checkins] CVS: Zope3/lib/python/Zope/App/Publisher/Browser - meta.zcml:1.10

[Martijn Faassen]

Update of /cvs-repository/Zope3/lib/python/Zope/App/Publisher/Browser
In directory cvs.zope.org:/tmp/cvs-serv22454

Modified Files:
	meta.zcml 
Log Message:
Minor tweaks and additional documentation.


=== Zope3/lib/python/Zope/App/Publisher/Browser/meta.zcml 1.9 => 1.10 ===
--- Zope3/lib/python/Zope/App/Publisher/Browser/meta.zcml:1.9	Wed Dec  4 14:04:07 2002
+++ Zope3/lib/python/Zope/App/Publisher/Browser/meta.zcml	Thu Dec  5 08:06:52 2002
@@ -4,8 +4,7 @@
 
     <directive 
         name="view" 
-        handler="Zope.App.Publisher.Browser.metaConfigure.view"
-    >
+        handler="Zope.App.Publisher.Browser.metaConfigure.view" >
       <attribute
           name="name"
           description="The name of the view. 
@@ -90,20 +89,21 @@
              name="name" 
              description="The name of a sub page of a view.
 
-             The name attribute is always required for the 'page' directive. 
-             It is common to use an extension for the name, such as '.html'." />
+                 The name attribute is always required for the 'page'
+                 directive. It is common to use an extension for the name, 
+                 such as '.html'." />
          <attribute
              name="attribute"
              description="The name of the view attribute implementing the page.
 
-             This refers to the attribute (method) on the view that is 
-             implementing a specific sub page." />
+                 This refers to the attribute (method) on the view that is 
+                 implementing a specific sub page." />
          <attribute
              name="permission"
              description="The permission needed to use this page.
  
-             XXX Should we deprecate this? Could always be the same as
-             the main view." />
+                 XXX Should we deprecate this? Could always be the same as
+                 the main view." />
          <attribute
              name="layer" 
              description="XXX deprecated" />
@@ -113,9 +113,10 @@
              name="name"
              description="The name of the page that is the default.
 
-             The named page will be used as the default if no name is
-             specified explicitly in the path. If no defaultPage directive
-             is supplied, the default page will be the first page listed." />
+                 The named page will be used as the default if no name is
+                 specified explicitly in the path. If no defaultPage 
+                 directive is supplied, the default page will be the
+                 first page listed." />
          <attribute
              name="attribute"
              description="XXX deprecated" />
@@ -167,9 +168,9 @@
         name="resource"
         handler="Zope.App.Publisher.Browser.metaConfigure.resource">
       <attribute
-          name="factory" />
-      <attribute
           name="name" />
+      <attribute
+          name="factory" />
        <attribute
           name="layer" />
        <attribute
@@ -182,8 +183,7 @@
           name="allowed_interface" />
        <attribute
           name="allowed_attributes" />
-       <subdirective name="page"
-       > 
+       <subdirective name="page"> 
          <attribute
              name="name" />
          <attribute
@@ -203,8 +203,7 @@
           name="name" />
       <attribute
           name="default_language" />
-      <subdirective name="translation"
-      >
+      <subdirective name="translation">
         <attribute
             name="language" />
         <attribute
@@ -216,19 +215,23 @@
 
     <directive
         name="skin"
-        handler="Zope.App.Publisher.Browser.metaConfigure.skin"
-    >
+        handler="Zope.App.Publisher.Browser.metaConfigure.skin">
       <attribute
-          name="name" />
+          name="name"
+          description="The name of the skin." />
       <attribute
-          name="layers" />
+          name="layers"
+          description="A list of names of layers. 
+
+              This should be in order of lookup. Usually one of the layers
+              has the same name as the skin, and the last skin should be
+              'default', unless you want to completely override all views." />
     </directive>
 
     <directive
         name="menu"
         handler="
-            Zope.App.Publisher.Browser.GlobalBrowserMenuService.menuDirective"
-    >
+            Zope.App.Publisher.Browser.GlobalBrowserMenuService.menuDirective">
       <attribute
           name="name" />
       <attribute