There's a tip at the end of the put documentation[1] that reads:

"put should not be used "UFCS-style", e.g. r.put(e). Doing this may call R.put directly, by-passing any transformation feature provided by Range.put. put(r, e) is prefered."

Yet every snippet in the section uses the r.put(e) form. For a PR, which is preferred: remove the tip or change the snippets? If the latter, I think the tip should be clarified a bit. It's not quite clear what the issue is.


[1] http://dlang.org/phobos/std_range_primitives.html#.put

On Monday, 1 June 2015 at 07:08:31 UTC, Mike Parker wrote:
> There's a tip at the end of the put documentation[1] that reads:
>
> "put should not be used "UFCS-style", e.g. r.put(e). Doing this may call R.put directly, by-passing any transformation feature provided by Range.put. put(r, e) is prefered."
>
> Yet every snippet in the section uses the r.put(e) form. For a PR, which is preferred: remove the tip or change the snippets? If the latter, I think the tip should be clarified a bit. It's not quite clear what the issue is.
>
>
> [1] http://dlang.org/phobos/std_range_primitives.html#.put

/s/every snippet/one snippet

On Monday, 1 June 2015 at 07:12:24 UTC, Mike Parker wrote:
> On Monday, 1 June 2015 at 07:08:31 UTC, Mike Parker wrote:
>> There's a tip at the end of the put documentation[1] that reads:
>>
>> "put should not be used "UFCS-style", e.g. r.put(e). Doing this may call R.put directly, by-passing any transformation feature provided by Range.put. put(r, e) is prefered."
>>
>> Yet every snippet in the section uses the r.put(e) form. For a PR, which is preferred: remove the tip or change the snippets? If the latter, I think the tip should be clarified a bit. It's not quite clear what the issue is.
>>
>>
>> [1] http://dlang.org/phobos/std_range_primitives.html#.put
>
> /s/every snippet/one snippet

OK, ignore this post. I see now what I missed.