diff options
| author | Chris McDonough <chrism@plope.com> | 2011-01-18 12:27:56 -0500 |
|---|---|---|
| committer | Chris McDonough <chrism@plope.com> | 2011-01-18 12:27:56 -0500 |
| commit | 8b4146009da0b612e8e001e68cd5f6f63d361c53 (patch) | |
| tree | 5de4e743b2c007c0d5202db7be883d21cfe2bc88 /docs/zcml/include.rst | |
| parent | 566004501e8a28c0ba8f8c882ca5ea0742e5d285 (diff) | |
| parent | c9c3c487bcaedeca97bb6463a00188b0dc01203a (diff) | |
| download | pyramid-8b4146009da0b612e8e001e68cd5f6f63d361c53.tar.gz pyramid-8b4146009da0b612e8e001e68cd5f6f63d361c53.tar.bz2 pyramid-8b4146009da0b612e8e001e68cd5f6f63d361c53.zip | |
Merge branch 'zcmlless'
Diffstat (limited to 'docs/zcml/include.rst')
| -rw-r--r-- | docs/zcml/include.rst | 71 |
1 files changed, 0 insertions, 71 deletions
diff --git a/docs/zcml/include.rst b/docs/zcml/include.rst deleted file mode 100644 index f55caa07c..000000000 --- a/docs/zcml/include.rst +++ /dev/null @@ -1,71 +0,0 @@ -.. _include_directive: - -``include`` ------------ - -The ``include`` directive includes configuration from an external ZCML -file. Use of the ``include`` tag allows a user to split configuration -across multiple ZCML files, and allows package distributors to provide -default ZCML configuration for specific purposes which can be -included by the integrator of the package as necessary. - -Attributes -~~~~~~~~~~ - -``package`` - A :term:`dotted Python name` which references a Python :term:`package`. - -``file`` - An absolute or relative filename which references a ZCML file. - -The ``package`` and ``file`` attributes can be used together or -separately as necessary. - -Examples -~~~~~~~~ - -.. topic:: Loading the File Named ``configure.zcml`` from a Package Implicitly - - .. code-block:: xml - :linenos: - - <include package="some.package" /> - -.. topic:: Loading the File Named ``other.zcml`` From the Current Package - - .. code-block:: xml - :linenos: - - <include file="other.zcml" /> - -.. topic:: Loading a File From a Subdirectory of the Current Package - - .. code-block:: xml - :linenos: - - <include file="subdir/other.zcml" /> - -.. topic:: Loading the File Named ``/absolute/path/other.zcml`` - - .. code-block:: xml - :linenos: - - <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" file="other.zcml" /> - -Alternatives -~~~~~~~~~~~~ - -None. - -See Also -~~~~~~~~ - -See also :ref:`helloworld_declarative`. - |