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