fix readNow buffer pointer

Was clearing beginning of buffer instead of end of buffer.
Also document read() and readNow().
This affects OpenSL ES blocking writes when un underflow occured.

Fixes: 233
Fixes: 154
3 files changed