summaryrefslogtreecommitdiff
path: root/docs/narr/project.rst
diff options
context:
space:
mode:
Diffstat (limited to 'docs/narr/project.rst')
-rw-r--r--docs/narr/project.rst11
1 files changed, 11 insertions, 0 deletions
diff --git a/docs/narr/project.rst b/docs/narr/project.rst
index a050f8824..2ff8011ee 100644
--- a/docs/narr/project.rst
+++ b/docs/narr/project.rst
@@ -136,6 +136,17 @@ port 6543.
development easier, as changes to Python code under
:mod:`repoze.bfg` is not put into effect until the server restarts.
+.. note:: When :mod:`repoze.bfg` starts, it writes a ``.pck`` file.
+ In a typical setup this file will be written as
+ ``configure.zcml.pck`` in the same directory that your
+ application's ``configure.zcml`` is stored. This is temporary,
+ cached data that can help your :mod:`repoze.bfg` application start
+ slightly faster (its existence prevents the need to parse the XML
+ in the .zcml file). You can delete it at will as necessary; it
+ will be recreated. If it cannot be written due to filesystem
+ permissions, :mod:`repoze.bfg` will just reparse the .zcml file
+ every time it starts.
+
Viewing the Application
-----------------------