summaryrefslogtreecommitdiff
path: root/docs/narr/logging.rst
diff options
context:
space:
mode:
authorMichael Merickel <michael@merickel.org>2015-02-11 12:32:26 -0600
committerMichael Merickel <michael@merickel.org>2015-02-11 12:32:35 -0600
commit6e9e2dbb364f371b034b681dd44e6e6b831c5760 (patch)
treeb7d8c623706f5df330d9c72d4e1c9d84dd47b6cd /docs/narr/logging.rst
parent14126cae5cf308ed466ed3eea576094e9c2193b4 (diff)
parent1dc1f28e1184960f5359c6c510d23a0e6e9dafe8 (diff)
downloadpyramid-6e9e2dbb364f371b034b681dd44e6e6b831c5760.tar.gz
pyramid-6e9e2dbb364f371b034b681dd44e6e6b831c5760.tar.bz2
pyramid-6e9e2dbb364f371b034b681dd44e6e6b831c5760.zip
Merge branch 'master' into feature.py3-coverage
Diffstat (limited to 'docs/narr/logging.rst')
-rw-r--r--docs/narr/logging.rst18
1 files changed, 9 insertions, 9 deletions
diff --git a/docs/narr/logging.rst b/docs/narr/logging.rst
index c16673ae6..921883091 100644
--- a/docs/narr/logging.rst
+++ b/docs/narr/logging.rst
@@ -254,16 +254,15 @@ level unless they're explicitly set differently. Meaning the ``myapp.views``,
``myapp.models`` (and all your app's modules') loggers by default have an
effective level of ``DEBUG`` too.
-For more advanced filtering, the logging module provides a `Filter
-<http://docs.python.org/lib/node423.html>`_ object; however it cannot be used
-directly from the configuration file.
+For more advanced filtering, the logging module provides a
+:class:`logging.Filter` object; however it cannot be used directly from the
+configuration file.
-Advanced Configuration
+Advanced Configuration
----------------------
-To capture log output to a separate file, use a `FileHandler
-<http://docs.python.org/lib/node412.html>`_ (or a `RotatingFileHandler
-<http://docs.python.org/lib/node413.html>`_):
+To capture log output to a separate file, use :class:`logging.FileHandler` (or
+:class:`logging.handlers.RotatingFileHandler`):
.. code-block:: ini
@@ -317,8 +316,9 @@ output, etc., but not web traffic. For web traffic logging Paste provides the
:term:`middleware`. TransLogger produces logs in the `Apache Combined Log
Format <http://httpd.apache.org/docs/2.2/logs.html#combined>`_. But
TransLogger does not write to files, the Python logging system must be
-configured to do this. The Python FileHandler_ logging handler can be used
-alongside TransLogger to create an ``access.log`` file similar to Apache's.
+configured to do this. The Python :class:`logging.FileHandler` logging
+handler can be used alongside TransLogger to create an ``access.log`` file
+similar to Apache's.
Like any standard :term:`middleware` with a Paste entry point, TransLogger can
be configured to wrap your application using ``.ini`` file syntax. First,