summaryrefslogtreecommitdiff
path: root/docs/narr/project.rst
diff options
context:
space:
mode:
authorChris McDonough <chrism@plope.com>2013-10-14 11:23:24 +0200
committerChris McDonough <chrism@plope.com>2013-10-14 11:23:24 +0200
commita87c1972615f98e99b06f9ea335a12104f67e6e0 (patch)
tree4b9f81e2ccf3a3590e539808b72ca443778b3359 /docs/narr/project.rst
parent4223668ee4c0d0ac0e981f3241d56ffa805ba6d1 (diff)
parent55917fe91b4344008da352e262dc2135629405d6 (diff)
downloadpyramid-a87c1972615f98e99b06f9ea335a12104f67e6e0.tar.gz
pyramid-a87c1972615f98e99b06f9ea335a12104f67e6e0.tar.bz2
pyramid-a87c1972615f98e99b06f9ea335a12104f67e6e0.zip
Merge branch 'master' of github.com:Pylons/pyramid
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``.