I would actually argue that both of these versions of the docs are misleading -- the buffer passed in is used.  it is not *reused*.

However, the *point* of this function is to allow buffer reuse.  I think it might be better to do:

        This can be faster than $(D line = readln()) because you can reuse the buffer for each call