summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorKarl O. Pinc <kop@meme.com>2018-11-24 08:10:47 -0600
committerKarl O. Pinc <kop@meme.com>2018-11-24 08:10:47 -0600
commit6ca75ed314188de40a8676bf1258762bc9522b91 (patch)
tree872f9d4480740d81183d1efeb27ec4ff4b05ca8f /docs
parent27c82826d669e4b381328643f84ccfff5bcba16e (diff)
downloadpyramid-6ca75ed314188de40a8676bf1258762bc9522b91.tar.gz
pyramid-6ca75ed314188de40a8676bf1258762bc9522b91.tar.bz2
pyramid-6ca75ed314188de40a8676bf1258762bc9522b91.zip
Use numbered list instead of a paragraph per Steve Piercy
Diffstat (limited to 'docs')
-rw-r--r--docs/narr/logging.rst12
1 files changed, 8 insertions, 4 deletions
diff --git a/docs/narr/logging.rst b/docs/narr/logging.rst
index 8ae8469de..58bd2d4ec 100644
--- a/docs/narr/logging.rst
+++ b/docs/narr/logging.rst
@@ -43,10 +43,14 @@ The logging-related sections in the file configure logging when you run ``pserve
.. index::
pair: logging; startup
-On :ref:`startup <the_startup_process>` the ``pserve`` command :ref:`configures logging <startup_logging_initialization>` using the ``.ini`` file given to it.
-If the ``.ini`` file contains a ``[loggers]`` section (all of the cookiecutter-generated ``.ini`` files do) ``pserve`` calls the :func:`pyramid.paster.setup_logging` function.
-The :func:`setup_logging` function is a thin wrapper around the :func:`logging.config.fileConfig`.
-When ``setup_logging`` is passed the ``ini`` file given on the ``pserve`` command line it reads the file and configures logging.
+If the configuration ``.ini`` file, specified when invoking ``pserve``, contains a ``[loggers]`` section then on :ref:`startup <the_startup_process>` the following process takes place:
+
+#. The ``pserve`` command calls the :func:`pyramid.paster.setup_logging` function, passing the ``.ini`` file.
+
+#. ``setup_logging`` is a thin wrapper which calls the Python standard library's :func:`logging.config.fileConfig`.
+
+#. :func:`logging.config.fileConfig` reads the logging configuration from the ``.ini`` file and configures logging.
+
Default logging configuration is provided in both the default
``development.ini`` and the ``production.ini`` files. If you use our cookiecutter to generate a Pyramid project with the name of the package as ``hello_world``, then the logging configuration