summaryrefslogtreecommitdiff
path: root/docs/narr/project.rst
diff options
context:
space:
mode:
authorChris McDonough <chrism@agendaless.com>2008-12-21 20:49:45 +0000
committerChris McDonough <chrism@agendaless.com>2008-12-21 20:49:45 +0000
commitb65d8eacda1da9105b027e8e02e95be13854061a (patch)
tree782bce7935f9bab4821baa49d59f42a43bd1a062 /docs/narr/project.rst
parent931387988788d33bfc9d6052d61611c9657e9905 (diff)
downloadpyramid-b65d8eacda1da9105b027e8e02e95be13854061a.tar.gz
pyramid-b65d8eacda1da9105b027e8e02e95be13854061a.tar.bz2
pyramid-b65d8eacda1da9105b027e8e02e95be13854061a.zip
- Updated paster template "ez_setup.py" to one that requires
setuptools 0.6c9. - Turn ``view_execution_permitted`` from the :mod:`repoze.bfg.view` module into a documented API. - Doc cleanups.
Diffstat (limited to 'docs/narr/project.rst')
-rw-r--r--docs/narr/project.rst11
1 files changed, 8 insertions, 3 deletions
diff --git a/docs/narr/project.rst b/docs/narr/project.rst
index 194c168c3..ad74fb8e0 100644
--- a/docs/narr/project.rst
+++ b/docs/narr/project.rst
@@ -332,6 +332,10 @@ changes will not require an application restart to be detected. See
production applications, as template rendering is slowed when it is
turned on.
+Various other settings may exist in this section having to do with
+debugging a :mod:`repoze.bfg` application. See
+:ref:`environment_chapter` for more information about these settings.
+
The ``[server:main]`` section of the configuration file configures a
WSGI server which listens on port 6543. It is configured to listen on
all interfaces (``0.0.0.0``). The ``Paste#http`` server will create a
@@ -392,7 +396,7 @@ that should point at your application project's URL (if any).
``packages=find_packages()`` causes all packages within the project to
be found when packaging the application. ``include_package_data``
will include non-Python files when the application is packaged (if
-those files are checked into version control). ``zip_safe` indicates
+those files are checked into version control). ``zip_safe`` indicates
that this package is not safe to ship as a zipped egg (it will unpack
as a directory, which is more convenient). ``install_requires`` and
``tests_require`` indicate that this package depends on the
@@ -468,8 +472,9 @@ registry`. It looks like so:
:language: xml
#. Lines 1-3 provide the root node and namespaces for the
- configuration language. ``bfg`` is the namespace for
- :mod:`repoze.bfg` -specific configuration directives.
+ configuration language. ``http://namespaces.repoze.org/bfg`` is
+ the default XML namespace. Add-on packages may require other
+ namespaces.
#. Line 6 initializes :mod:`repoze.bfg`-specific configuration
directives by including the ``repoze.bfg.includes`` package. This