Improve vectored IO api spec.

Let's add more details to the vectored IO api spec for better clarity. 

• the position returned by getPos(); is undefined afterwards.
• note that if a file is changed during a read, the output is again undefined. some ranges may be old data, some may be new, *and some may be both
• note that while reads are active, normal fs api calls may block.