[Zope3-checkins] CVS: Zope3/doc/zcml/namespaces.zope.org/zope - content.stx:1.5 grant.stx:1.3 implements.stx:1.3 include.stx:1.4

[Philipp von Weitershausen]

Update of /cvs-repository/Zope3/doc/zcml/namespaces.zope.org/zope
In directory cvs.zope.org:/tmp/cvs-serv9224/zope

Modified Files:
	content.stx grant.stx implements.stx include.stx 
Log Message:
Updated ZCML documentation. It was waaaaay behind (we're talking lightyears
here).

I vote that from now on, documentation needs to updated while gedonning,
at least before a MileStone release. We can't tell people "RTFM" when the
docs are totally useless.

Also, I think these ZCML docs should be generated from the schemas
describing the directives. I could write a tool to do that when I find
time.


=== Zope3/doc/zcml/namespaces.zope.org/zope/content.stx 1.4 => 1.5 ===
--- Zope3/doc/zcml/namespaces.zope.org/zope/content.stx:1.4	Fri Aug 30 18:39:17 2002
+++ Zope3/doc/zcml/namespaces.zope.org/zope/content.stx	Mon Dec 15 05:14:19 2003
@@ -30,7 +30,7 @@
   allow
   
     Use only one of the following attributes to declare what part
-    of this class is publicly viewable (that is, requires the Zope.Public
+    of this class is publicly viewable (that is, requires the zope.Public
     permission).
   
     * attributes, space-separated list of attribute names 
@@ -61,28 +61,28 @@
     
   A content directive that contains security assertions::
   
-    <content class=".Contact.">
-      <allow interface=".IContact.IViewContact" />
-      <require permission="Zope.ManageContent" interface=".IContact." />
+    <content class=".contact.Contact">
+      <allow interface=".interfaces.IContactInfo" />
+      <require permission="zope.ManageContent" interface=".interfaces.IContact" />
     </content>
     
   A content directive that makes an interface implementation assertion::
   
-    <content class=".Contact.">
-      <implements interface=".IContact." />
+    <content class=".contact.Contact">
+      <implements interface=".interfaces.IContact" />
     </content>
     
   A rather full content directive::
   
-    <content class=".Contact.">
-      <implements interface=".IContact." />
+    <content class=".contact.Contact">
+      <implements interface=".interfaces.IContact" />
       <factory
-          permission="ZopeProducts.Contact.ManageContacts"
+          permission="contact.ManageContacts"
           title="Personal Contact Information" />
       <require
-          permission="Zope.View"
-          interface=".IContact.IContactInfo." />
+          permission="zope.View"
+          interface=".interfaces.IContactInfo." />
       <require
-          permission="ZopeProducts.Contact.ManageContacts"
+          permission="contact.ManageContacts"
           attributes="update"/>
     </content>


=== Zope3/doc/zcml/namespaces.zope.org/zope/grant.stx 1.2 => 1.3 ===
--- Zope3/doc/zcml/namespaces.zope.org/zope/grant.stx:1.2	Mon Jun 10 19:27:38 2002
+++ Zope3/doc/zcml/namespaces.zope.org/zope/grant.stx	Mon Dec 15 05:14:19 2003
@@ -38,7 +38,7 @@
 
   Here are some examples of using the grant directive::
   
-    <grant permission="Zope.View" principal="Bob" />
+    <grant permission="zope.View" principal="zope.Bob" />
   
-    <grant role="Zope.Manager" principal="Bob" />
+    <grant role="zope.Manager" principal="zope.Bob" />
     


=== Zope3/doc/zcml/namespaces.zope.org/zope/implements.stx 1.2 => 1.3 ===
--- Zope3/doc/zcml/namespaces.zope.org/zope/implements.stx:1.2	Mon Jun 10 19:27:38 2002
+++ Zope3/doc/zcml/namespaces.zope.org/zope/implements.stx	Mon Dec 15 05:14:19 2003
@@ -13,8 +13,8 @@
   
 Example::
 
-  <content class=".Contact.">
-    <implements interface=".IContact." />
+  <content class=".contact.Contact">
+    <implements interface=".interfaces.IContact" />
   </content>
 
 


=== Zope3/doc/zcml/namespaces.zope.org/zope/include.stx 1.3 => 1.4 ===
--- Zope3/doc/zcml/namespaces.zope.org/zope/include.stx:1.3	Thu Dec 12 11:46:43 2002
+++ Zope3/doc/zcml/namespaces.zope.org/zope/include.stx	Mon Dec 15 05:14:19 2003
@@ -14,15 +14,15 @@
 
   Including the Contact zcml file from the ZopeProducts.Contact package::
 
-    <include package=".Contact" file="Contact.zcml" />
+    <include package=".contact" file="contact.zcml" />
 
   Another spelling of the same thing::
 
-    <include package="ZopeProducts.Contact" file="Contact.zcml" />
+    <include package="zopeproducts.contact" file="contact.zcml" />
 
   Including every package in ZopeProducts::
 
-    <include package="ZopeProducts.*" />
+    <include package="zopeproducts.*" />
 
   Including meta.zcml from every subpackage of the current package::