This note should be entirely rewritten; clearly `byLineCopy` should be preferred if the custom copy is just `to!string`, as both methods simply make one GC allocation per line. I think it should be phrased so that `byLine` should be used when no copying is needed, or when the user wants fine control over the copying behaviour, such as conditional copies or the place to allocate.