yui/yuidoc — pull request #227 by rgrove (2014-04-02 00:20:11+00:00)
Title: Allow @param and @return descriptions to be preceded by a newline.

This fixes two bugs triggered by putting a newline before the description of a `@param` or `@return` tag. It was cramping my style, since I find this to be a more readable comment format:

```
/**
Main description.

@method foo

@param {String} bar
This is the bar param.

@param {String} baz
This is the baz param.

@return {Boolean}
Whether or not bar and baz got fooed.
**/
```

Specifically, the parameter names in this case ended up as "bar!~YUIDOC_LINE~!" and "baz!~YUIDOC_LINE~!" instead of "bar" and "baz", and the return description was treated as a code block by the Markdown parser due to its indentation (whereas the precedent elsewhere in YUIDoc is to normalize indentation to the first line of a description).