www.digitalmars.com         C & C++   DMDScript  

digitalmars.D - Output Range 'put' documentation

reply "Mike Parker" <aldacron gmail.com> writes:
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
Jun 01 2015
parent reply "Mike Parker" <aldacron gmail.com> writes:
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
Jun 01 2015
parent "Mike Parker" <aldacron gmail.com> writes:
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.
Jun 01 2015