1. Michael Bayer
  2. sqlalchemy
  3. Issues

Issues

Issue #1700 resolved

WARNING: Bullet list ends without a blank line

Anonymous created an issue

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)

  1. Log in to comment