[Issue 16509] New: DIP25 'return' attribute not documented for functions

[via Digitalmars-d-bugs]

https://issues.dlang.org/show_bug.cgi?id=16509

          Issue ID: 16509
           Summary: DIP25 'return' attribute not documented for functions
           Product: D
           Version: D2
          Hardware: All
                OS: All
            Status: NEW
          Severity: major
          Priority: P1
         Component: dlang.org
          Assignee: nobody at puremagic.com
          Reporter: mathias.lang at sociomantic.com

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
reference.

Marking as major since it's now enabled by default.

--