WARNING: Bullet list ends without a blank line
I get three "Bullet list ends without a blank line; unexpected unindent." warnings when I 'make html' in sqlalchemy/doc/build.
(mydevenv)diana@diana-laptop:~/workspace/sqlalchemy/doc/build$ make html mkdir -p output/html output/doctrees sphinx-build -b html -A mako_layout=html -d output/doctrees . output/html Running Sphinx v0.6.4 loading pickled environment... not found building [html](html): targets for 43 source files that are out of date updating environment: 43 added, 0 changed, 0 removed reading sources... [100%](100%) sqlexpression /home/diana/workspace/sqlalchemy/doc/build/dbengine.rst:67: (WARNING/2) Bullet list ends without a blank line; unexpected unindent. /home/diana/workspace/sqlalchemy/doc/build/dbengine.rst:79: (WARNING/2) Bullet list ends without a blank line; unexpected unindent. /home/diana/workspace/sqlalchemy/doc/build/dbengine.rst:85: (WARNING/2) Bullet list ends without a blank line; unexpected unindent. /home/diana/workspace/sqlalchemy/doc/build/intro.rst:: (WARNING/2) Duplicate explicit target name: "setuptools". looking for now-outdated files... none found pickling environment... done checking consistency... /home/diana/workspace/sqlalchemy/doc/build/copyright.rst:: WARNING: document isn't included in any toctree done preparing documents... done writing output... [100%](100%) sqlexpression writing additional files... genindex search copying images... sqla_arch_small.jpg copying static files... done dumping search index... done dumping object inventory... done build succeeded, 5 warnings.
The sphinx docs say:
"Nested lists are possible, but be aware that they must be separated from the parent list items by blank lines:"
* this is * a list * with a nested list * and some subitems * and here the parent list continues
Attached is a diff.
Some 'id' attribute values change as a result of this diff -- I'm totally new to sphinx & not sure if this matters. For example:
(mydevenv)diana@diana-laptop:~/workspace/sqlalchemy/doc/build$ diff /home/diana/dbengine.html.before /home/diana/dbengine.html.after 53c53 < Version: <span class="versionnum">0.6beta2</span> Last Updated: 02/22/2010 13:50:25 --- > Version: <span class="versionnum">0.6beta2</span> Last Updated: 02/22/2010 13:49:03 292c292 < <p id="index-9">Connection facts:</p> --- > <p id="index-7">Connection facts:</p> 339c339 < <p id="index-10">Transaction Facts:</p> --- > <p id="index-8">Transaction Facts:</p>
Also, are there tests I should run for the docs? I did run 'python setup.pt test':
Ran 2141 tests in 230.564s OK
Note that this is my first ever ticket and diff to an open source project, so please let me know if I'm doing something wrong.