Typographical Conventions
=========================

Literals, filenames and function arguments are presented using the
following style:

  ``argument1``

Warnings, which represent limitations and need-to-know information
related to a topic or concept are presented in the following style:

  .. warning::

     This is a warning.

Notes, which represent additional information related to a topic or
concept are presented in the following style:

  .. note::

     This is a note.

We present Python method names using the following style:

  :meth:`Python.method_name`

We present Python class names, module names, attributes and global
variables using the following style:

  :class:`Python.class_module_or_attribute.name`

References to glossary terms are presented using the following style:

  :term:`Repoze`

URLs are presented using the following style:

  `Repoze <http://repoze.org>`_

References to sections and chapters are presented using the following
style:

  :ref:`traversal_chapter`

Python code blocks are presented in the following style:

  .. code-block:: python
     :linenos:

     def foo(abc):
         pass

Blocks of XML markup are presented in the following style:

  .. code-block:: xml
     :linenos:

     <root>
       <!-- ... more XML .. -->
     </root>