Fix empty line before list

It seems that the change in 0.3.15 introduced an empty line before a list, which seems semantically unintuitive.

For example:

/**
 * A description.
 *
 * @param {any} var An example list:
 * -   Item 1
 * -   Item 2
 * -   Item 3
 * @returns {Promise} A return value.
 */

turns into:

/**
 * A description.
 *
 * @param {any} var An example list:
 * 
 *   -   Item 1
 *   -   Item 2
 *   -   Item 3
 * @returns {Promise} A return value.
 */

This seems semantically unintuitive, because a list rarely stands on its own, unless it is an index or table of contents.

If a list should be more clearly separated from the rest, it should add an empty line before and after the list. But that would be even worse in my opinion, because it takes up even more space. And the list cannot really be optically attached to the previous or following line anymore. For example, here the list seems pretty lost:

/**
 * A description.
 *
 * @param {any} var An example text that is
 *   long and spans multiple lines
 *   followed by a list.
 * 
 *   -   Item 1
 *   -   Item 2
 *   -   Item 3
 *
 *  And more text to come.
 * @returns {Promise} A return value.
 */

My suggestion would be to:

• not auto-add an empty line before or after the list
• respect if the author added an empty line before or after a list and do not remove it
• reduce the number of empty lines to 1 if the author added more than 1 empty line before or after the list

[hosseinmd]

I will do it as soon as possible. Thank you for contributing.

[mtrezza]

Yes, now I see it too, let’s go with a) then. I think the only issue to correct is that there is no empty line after the list if the next line starts with a tag.

/**
 * @param {any} var An example list:
 *
 *   - Item 1
 *   - Item 2
 * @returns {Promise} A return value.
 */

should become

/**
 * @param {any} var An example list:
 *
 *   - Item 1
 *   - Item 2
 *
 * @returns {Promise} A return value.
 */