[commit: haddock] master: Update docs with info on new list nesting rule (194f382)

[git at git.haskell.org]

Repository : ssh://git@git.haskell.org/haddock

On branch  : master
Link       : http://git.haskell.org/haddock.git/commitdiff/194f382f84a401a82464438820f074aa7851b725

>---------------------------------------------------------------

commit 194f382f84a401a82464438820f074aa7851b725
Author: Mateusz Kowalczyk <fuuzetsu at fuuzetsu.co.uk>
Date:   Wed Jun 3 05:25:29 2015 +0100

    Update docs with info on new list nesting rule
    
    Fixes #278 through commits from PR #401


>---------------------------------------------------------------

194f382f84a401a82464438820f074aa7851b725
 doc/haddock.xml | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/doc/haddock.xml b/doc/haddock.xml
index 2ffd7d7..f6cd4d4 100644
--- a/doc/haddock.xml
+++ b/doc/haddock.xml
@@ -2029,7 +2029,18 @@ This belongs to the list above!
                     2. No newline separation even in indented lists.
 -}
 </programlisting>
+    <para>The indentation of the first list item is honoured. That is,
+    in the following example the items are on the same level. Before
+    Haddock 2.16.1, the second item would have been nested under the
+    first item which was unexpected.
+    </para>
+<programlisting>
+{-|
+    * foo
 
+    * bar
+-}
+</programlisting>
       </section>
 
       <section>