Fix rendering of lists

[corhere]

The AST hierarchy for a list item is always List > Item > Paragraph. Emit newlines when visiting the Paragraph node instead of the Item and List so that Items with multiple Paragraphs and nested Lists correctly render with just the right number of line breaks.

Update the man page to show off the new feature.

Stop over-indenting lists which are not nested inside a list item.

• Fixes Too many spaces in front of a list #107
• Closes Fix list indents #116

Demo

Input

test
====

text

**Term**
:   Def Autem repellendus recusandae sint deserunt non. Quas maxime delectus
    suscipit quis facere doloribus. Rerum omnis provident unde non sapiente
    magni.

**Long term**
:   Long definition

    Multiple paragraphs

    - including
    - lists
:   Second definition

more text

1. ordered lists

    Also multiple paragraphs
2. second item
    - with
    - nested

        Unordered second paragraph
    - item

    Another here
3. third

Rendered terminal output

example(1)                  General Commands Manual                 example(1)

       text

       Term   Def Autem repellendus recusandae sint deserunt non. Quas maxime
              delectus suscipit quis facere doloribus. Rerum omnis provident
              unde non sapiente magni.


       Long term
              Long definition

              Multiple paragraphs

              • including

              • lists

              Second definition


       more text

         1. ordered lists

            Also multiple paragraphs

         2. second item

            • with

            • nested

              Unordered second paragraph

            • item

            Another here

         3. third

                                                                    example(1)

Rendered output from master branch, for comparison

example(1)                  General Commands Manual                 example(1)

       text


       Term   Def Autem repellendus recusandae sint deserunt non. Quas maxime
              delectus suscipit quis facere doloribus. Rerum omnis provident
              unde non sapiente magni.


       Long term
              Long definitionMultiple paragraphs

              • including

              • lists



       Second definition


       more text


                1. ordered listsAlso multiple paragraphs

                2. second item

                   • with

                   • nestedUnordered second paragraph

                   • item

              Another here

                3. third


                                                                    example(1)

[cpuguy83]

I realize I should probably include the generated roff in the repo as well so we can see the changes.

[cpuguy83]

Needs rebase.