[Checkins] SVN: z3c.unconfigure/trunk/s cosmetics
Philipp von Weitershausen
philikon at philikon.de
Wed Aug 6 05:22:50 EDT 2008
Log message for revision 89431:
cosmetics
Changed:
U z3c.unconfigure/trunk/setup.py
U z3c.unconfigure/trunk/src/z3c/unconfigure/README.txt
-=-
Modified: z3c.unconfigure/trunk/setup.py
===================================================================
--- z3c.unconfigure/trunk/setup.py 2008-08-06 09:17:57 UTC (rev 89430)
+++ z3c.unconfigure/trunk/setup.py 2008-08-06 09:22:49 UTC (rev 89431)
@@ -5,6 +5,8 @@
return open(os.path.join(os.path.dirname(__file__), *rnames)).read()
long_description = (
+ 'Documentation\n' +
+ '=============\n\n' +
read('src', 'z3c', 'unconfigure', 'README.txt')
+ '\n' +
read('CHANGES.txt')
Modified: z3c.unconfigure/trunk/src/z3c/unconfigure/README.txt
===================================================================
--- z3c.unconfigure/trunk/src/z3c/unconfigure/README.txt 2008-08-06 09:17:57 UTC (rev 89430)
+++ z3c.unconfigure/trunk/src/z3c/unconfigure/README.txt 2008-08-06 09:22:49 UTC (rev 89431)
@@ -1,11 +1,17 @@
+Introduction
+------------
+
This package allows you to disable specific bits of ZCML configuration
that may occur in other packages. For instance, let's consider a
-simple ZCML directive that prints strings:
+simple ZCML directive that prints strings and a silly one that prints
+lolcat messages:
>>> zcml("""
... <print msg="Hello World!" />
+ ... <lolcat who="I" canhas="cheezburger" />
... """)
Hello World!
+ I can has cheezburger?
Now let's say this directive were used a bunch of times, but we wanted
to prevent one or two of its occurrences. To do that we simply repeat
@@ -21,7 +27,7 @@
... <print msg="LOL!" />
...
... <unconfigure>
- ... <lolcat who="I" canhas="cheezburger?" />
+ ... <lolcat who="I" canhas="cheezburger" />
... <print msg="LOL!" />
... </unconfigure>
... </configure>
@@ -35,11 +41,14 @@
>>> zcml("""
... <configure>
... <unconfigure>
- ... <print msg="I can has cheezburger?" />
+ ... <lolcat who="I" canhas="cheezburger" />
... </unconfigure>
... </configure>
... """)
+Where to place "unconfiguration"
+--------------------------------
+
What's a good place to add the ``unconfigure`` directives, you may
ask. Certainly, the example from above is a not very realistic
because both the original directives and the filters are in one file.
More information about the Checkins
mailing list