Call site 'ref'

[Mehrdad]

On 1/15/2012 5:37 PM, Mail Mantis wrote:
> I don't see how call cite ref will help the issue. If you don't read 
> ddoc, how will you know what exactly function does with it's ref 
> parameter - statistically? Knowing that function takes parameter by 
> ref doesn't help understanding it's logic. Also, knowing that function 
> doesn't take any ref parameters doesn't mean you don't need to read 
> it's documentation. 
"If the documentation explains it, the code doesn't need to."

?!?!?

Documentation is frequently out of date, but code isn't.
And ideally, the code wouldn't NEED documentation, BECAUSE it SAYS what 
it's doing.