Allow newlines in docstrings

[bviefhues]

Seems that various docstring elements do not support newlines, i.e. paragraphs composed of several comment lines. My OCD would be much more happy if I could do this:

--- <spoon variable>
--- Variable
--- Very very long text which wraps around depending on editor 
--- configuration and obviously is much longer that 80 characters, 
--- which some people prefer as their editor configuration.

instead of this:

--- <spoon variable>
--- Variable
--- Very very long text which wraps around depending on editor configuration and obviously is much longer that 80 characters, which some people prefer as their editor configuration.

Would be great if build_docs.py could accomodate that.