summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorChris McDonough <chrism@agendaless.com>2010-08-30 21:05:46 +0000
committerChris McDonough <chrism@agendaless.com>2010-08-30 21:05:46 +0000
commita74dbdbdd3f7813d48c5ba1472cdbf945ffd5c69 (patch)
tree7dda3e0a70c87505c6a8e58daa96ba9d78e7e7e8
parent2b80b6c978d9d149f41cda541b6c23a68bd2bf0a (diff)
downloadpyramid-a74dbdbdd3f7813d48c5ba1472cdbf945ffd5c69.tar.gz
pyramid-a74dbdbdd3f7813d48c5ba1472cdbf945ffd5c69.tar.bz2
pyramid-a74dbdbdd3f7813d48c5ba1472cdbf945ffd5c69.zip
- The ZCML ``include`` directive docs were incorrect: they specified
``filename`` rather than (the correct) ``file`` as an allowable attribute.
-rw-r--r--CHANGES.txt7
-rw-r--r--docs/zcml/include.rst12
2 files changed, 13 insertions, 6 deletions
diff --git a/CHANGES.txt b/CHANGES.txt
index 392a6effc..e0e0700c2 100644
--- a/CHANGES.txt
+++ b/CHANGES.txt
@@ -51,6 +51,13 @@ Backwards Incompatibilities
- The ``get_renderer`` API in ``repoze.bfg.renderers`` now accepts a
``package`` argument.
+Documentation
+-------------
+
+- The ZCML ``include`` directive docs were incorrect: they specified
+ ``filename`` rather than (the correct) ``file`` as an allowable
+ attribute.
+
Internal
--------
diff --git a/docs/zcml/include.rst b/docs/zcml/include.rst
index 149ddb67a..f55caa07c 100644
--- a/docs/zcml/include.rst
+++ b/docs/zcml/include.rst
@@ -15,10 +15,10 @@ Attributes
``package``
A :term:`dotted Python name` which references a Python :term:`package`.
-``filename``
+``file``
An absolute or relative filename which references a ZCML file.
-The ``package`` and ``filename`` attributes can be used together or
+The ``package`` and ``file`` attributes can be used together or
separately as necessary.
Examples
@@ -36,28 +36,28 @@ Examples
.. code-block:: xml
:linenos:
- <include filename="other.zcml" />
+ <include file="other.zcml" />
.. topic:: Loading a File From a Subdirectory of the Current Package
.. code-block:: xml
:linenos:
- <include filename="subdir/other.zcml" />
+ <include file="subdir/other.zcml" />
.. topic:: Loading the File Named ``/absolute/path/other.zcml``
.. code-block:: xml
:linenos:
- <include filename="/absolute/path/other.zcml" />
+ <include file="/absolute/path/other.zcml" />
.. topic:: Loading the File Named ``other.zcml`` From a Package Explicitly
.. code-block:: xml
:linenos:
- <include package="some.package" filename="other.zcml" />
+ <include package="some.package" file="other.zcml" />
Alternatives
~~~~~~~~~~~~