www.digitalmars.com         C & C++   DMDScript  

digitalmars.D.bugs - [Issue 17979] New: Improve documentation for lazy parameters

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

          Issue ID: 17979
           Summary: Improve documentation for lazy parameters
           Product: D
           Version: D2
          Hardware: x86_64
                OS: Linux
            Status: NEW
          Severity: enhancement
          Priority: P1
         Component: dlang.org
          Assignee: nobody puremagic.com
          Reporter: crimaniak gmail.com

Lazy parameters in fact implemented using delegates and affect  nogc
possibility. I propose additions to documentation:

https://dlang.org/spec/function.html#parameters section

It needs to write that the delegate is used, and explicitly document what
exactly happens in the case of several occurrences of the used parameter -
whether the delegate is called each time, or only the first, and then the
returned value is used (affects non-pure lazy parameters).

https://dlang.org/spec/garbage.html#op_involving_gc

It will be useful to mention lazy parameters in this list too.

--
Nov 12