From 27c82826d669e4b381328643f84ccfff5bcba16e Mon Sep 17 00:00:00 2001 From: "Karl O. Pinc" Date: Sat, 24 Nov 2018 01:13:47 -0600 Subject: Add index entries for logging initialization --- docs/narr/logging.rst | 3 +++ docs/narr/startup.rst | 3 +++ 2 files changed, 6 insertions(+) diff --git a/docs/narr/logging.rst b/docs/narr/logging.rst index b12434317..8ae8469de 100644 --- a/docs/narr/logging.rst +++ b/docs/narr/logging.rst @@ -40,6 +40,9 @@ format `. This is the same format used as the Python The application-related and logging-related sections in the configuration file can coexist peacefully. The logging-related sections in the file configure logging when you run ``pserve``. +.. index:: + pair: logging; startup + On :ref:`startup ` the ``pserve`` command :ref:`configures logging ` 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`. diff --git a/docs/narr/startup.rst b/docs/narr/startup.rst index ff94f441e..e2a18cd60 100644 --- a/docs/narr/startup.rst +++ b/docs/narr/startup.rst @@ -68,6 +68,9 @@ Here's a high-level time-ordered overview of what happens when you press will have a single ``[app:main]`` section in it, and this will be the application served. +.. index:: + pair: logging; startup + .. _startup_logging_initialization: #. The framework finds all :mod:`logging` related configuration in the ``.ini`` -- cgit v1.2.3