Close #3489: bullet list rendered "opened up"

sphinx-doc · Mar 2, 2017 · 4119439 · 4119439
1 parent cdacabd
commit 4119439
Showing 1 changed file with 4 additions and 3 deletions.
diff --git a/doc/config.rst b/doc/config.rst
@@ -988,9 +988,10 @@ that use Sphinx's HTMLWriter class.
 
 .. confval:: html_compact_lists
 
-   If true, list items containing only a single paragraph will not be rendered
-   with a ``<p>`` element.  This is standard docutils behavior.  Default:
-   ``True``.
+   If true, a list all whose items consist of a single paragraph and/or a
+   sub-list all whose items etc... (recursive definition) will not use the
+   ``<p>`` element for any of its items. This is standard docutils behavior.
+   Default: ``True``.
 
    .. versionadded:: 1.0