summaryrefslogtreecommitdiff
path: root/docs/narr/project.rst
diff options
context:
space:
mode:
authorPaul Everitt <paul@agendaless.com>2013-10-09 13:53:21 -0400
committerPaul Everitt <paul@agendaless.com>2013-10-09 13:53:21 -0400
commitd6476034e0fed99ad8f24839cfd9a315a92e7c95 (patch)
tree7939755cd887cbf3cf31fbba93f9cbb580d3afc4 /docs/narr/project.rst
parentbd3d23330abfe39182b7c47f79f61f26e20d1221 (diff)
parent85aef4a4c0157a59bfd7ea9b3a58b842ac4de0f0 (diff)
downloadpyramid-d6476034e0fed99ad8f24839cfd9a315a92e7c95.tar.gz
pyramid-d6476034e0fed99ad8f24839cfd9a315a92e7c95.tar.bz2
pyramid-d6476034e0fed99ad8f24839cfd9a315a92e7c95.zip
Merge remote-tracking branch 'origin/master'
Diffstat (limited to 'docs/narr/project.rst')
-rw-r--r--docs/narr/project.rst12
1 files changed, 12 insertions, 0 deletions
diff --git a/docs/narr/project.rst b/docs/narr/project.rst
index 8b7c24725..d7292d187 100644
--- a/docs/narr/project.rst
+++ b/docs/narr/project.rst
@@ -259,6 +259,8 @@ single sample test exists.
single: reload
single: startup
+.. _running_the_project_application:
+
Running The Project Application
-------------------------------
@@ -600,6 +602,8 @@ server which listens on TCP port 6543. It is configured to listen on all
interfaces (``0.0.0.0``). This means that any remote system which has TCP
access to your system can see your Pyramid application.
+.. _MyProject_ini_logging:
+
The sections that live between the markers ``# Begin logging configuration``
and ``# End logging configuration`` represent Python's standard library
:mod:`logging` module configuration for your application. The sections
@@ -885,6 +889,14 @@ returns the HTML in a :term:`response`.
.. note:: Dictionaries provide values to :term:`template`\s.
+.. note:: When the application is run with the scaffold's :ref:`default
+ development.ini <MyProject_ini>` configuration :ref:`logging is set up
+ <MyProject_ini_logging>` to aid debugging. If an exception is raised,
+ uncaught tracebacks are displayed after the startup messages on :ref:`the
+ console running the server <running_the_project_application>`. Also
+ ``print()`` statements may be inserted into the application for debugging
+ to send output to this console.
+
.. note:: ``development.ini`` has a setting that controls how templates are
reloaded, ``pyramid.reload_templates``.