Issue ID: 16509
Summary: DIP25 'return' attribute not documented for functions
The 'return' attribute is almost undocumented in `specs/function.dd`.
It was added to the grammar in https://github.com/dlang/dlang.org/pull/1415 but
no paragraph has been written to explain it.
One wishing to fix this should probably use http://wiki.dlang.org/DIP25 as
Marking as major since it's now enabled by default.