Allow documenting return values

[fricklerhandwerk]

Return values may need further explanation, e.g. function.

Proposal: Support a Returns: section with a free-form string.

[infinisil]

This won't be necessary anymore. Since RFC 145 has been implemented with #91, it's possible to use free-form markdown with custom headers.