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
http://sphinx.pocoo.org/rest.html#lists-and-quotes
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.
Comments (3)
-
repo owner -
Corrected in 7fe2f0676500b69aa25ae94cf6f1308d74498688.
-
repo owner - removed milestone
Removing milestone: 0.6.0 (automated comment)
- Log in to comment
there are some doctests that aren't part of the suite if you run the "testdocs.py" script. they're not super-critical.