summaryrefslogtreecommitdiff
path: root/docs/conventions.rst
diff options
context:
space:
mode:
authorChris McDonough <chrism@agendaless.com>2009-12-28 23:17:55 +0000
committerChris McDonough <chrism@agendaless.com>2009-12-28 23:17:55 +0000
commit016a1fcd164a7389c072b9ef5c247039355bc6ec (patch)
treed17f789549fde69a29677500302804bdf85ecdeb /docs/conventions.rst
parent44f1df7b7cec671fec92ead513804e52e63eb76d (diff)
downloadpyramid-016a1fcd164a7389c072b9ef5c247039355bc6ec.tar.gz
pyramid-016a1fcd164a7389c072b9ef5c247039355bc6ec.tar.bz2
pyramid-016a1fcd164a7389c072b9ef5c247039355bc6ec.zip
Fix margin overruns.
Diffstat (limited to 'docs/conventions.rst')
-rw-r--r--docs/conventions.rst16
1 files changed, 16 insertions, 0 deletions
diff --git a/docs/conventions.rst b/docs/conventions.rst
index d0376a195..0bfe5e21e 100644
--- a/docs/conventions.rst
+++ b/docs/conventions.rst
@@ -67,3 +67,19 @@ printed line should actually be part of the command:
c:\bigfntut\tutorial> ..\Scripts\nosetests --cover-package=tutorial \
--cover-erase --with-coverage
+
+In printed versions of this book, Python modules classes, methods,
+functions, and attributes that are part of the :mod:`repoze.bfg`
+module are referenced in paragraph text. These are contracted to omit
+the ``repoze.bfg`` prefix to reduce redundancy and increase
+readability. Therefore, where you might expect:
+
+ .. code-block:: text
+
+ repoze.bfg.configuration.Configurator.add_view (pp. XXX)
+
+Instead a contracted version will be rendered:
+
+ .. code-block:: text
+
+ configuration.Configurator.add_view (pp. XXX)