Output Range 'put' documentation

[Mike Parker via Digitalmars-d]

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