Pylons/colander — Issue #38: Documentation fails to build
Author: Arfrever
Created: 2012-02-18 04:24:58+00:00
State: open

```
$ make html
mkdir -p _build/html _build/doctrees
sphinx-build -b html -d _build/doctrees -W . _build/html
Running Sphinx v1.1.2
Cloning into '_themes'...
remote: Counting objects: 315, done.
remote: Compressing objects: 100% (239/239), done.
remote: Total 315 (delta 146), reused 199 (delta 74)
Receiving objects: 100% (315/315), 455.44 KiB | 264 KiB/s, done.
Resolving deltas: 100% (146/146), done.
running test
running egg_info
creating colander.egg-info
writing requirements to colander.egg-info/requires.txt
writing colander.egg-info/PKG-INFO
writing top-level names to colander.egg-info/top_level.txt
writing dependency_links to colander.egg-info/dependency_links.txt
writing manifest file 'colander.egg-info/SOURCES.txt'
reading manifest file 'colander.egg-info/SOURCES.txt'
writing manifest file 'colander.egg-info/SOURCES.txt'
running build_ext
..................................................................................................................................................................................................................................................................................................
----------------------------------------------------------------------
Ran 290 tests in 0.123s

OK
loading pickled environment... not yet created
building [html]: targets for 10 source files that are out of date
updating environment: 10 added, 0 changed, 0 removed
reading sources... [100%] null

Warning, treated as error:
/tmp/colander/docs/null.rst:191: ERROR: Error in "note" directive:
invalid option block.

.. note:: ```` in the above table represents the circumstance
in which a key present in a :class:`colander.MappingSchema` is not
present in a mapping passed to its
:meth:`colander.SchemaNode.serialize` method. In reality,
```` means exactly the same thing as
:attr:`colanderr.null`, because the :class:`colander.Mapping` type
does the equivalent of ``mapping.get(keyname, colander.null)`` to
find a subvalue during serialization.

make: *** [html] Error 1
```