Wishlist proposal, documenting fn arg as in or out or mod

[Cecil Ward]

On Tuesday, 20 June 2023 at 22:17:13 UTC, ryuukk_ wrote:
> On Tuesday, 20 June 2023 at 16:12:35 UTC, Adam D Ruppe wrote:
>> On Tuesday, 20 June 2023 at 15:01:17 UTC, Cecil Ward wrote:
>>> [...]
>>
>> Fun fact: the reason `inout` is a keyword in D is that this is 
>> what it used to be.
>>
>> Back on the old days, `inout` meant `ref`. But people kept 
>> asking so it got renamed to ref, and then inout was eventually 
>> reassigned to the const forwarding thing it is now (which was 
>> originally gonna be called `return` but never got implemented, 
>> and now `return` is used to indicate the lifetime of the 
>> parameter is the same as the return value, lolol)
>
> ``return`` thing is the most stupid thing ever, whoever 
> approved this needs to stop

The Horror!