[docs] Updated StringHandle.readall and FileHandle.readall docs

They read just the rest of the buffer if tell > 0. [GH #1084]
This is not what you would expect, but perl6 wanted it this way.
See GH #930 for the discussion.
ChangeLog: update