document new batch behavior
Merge pull request #41 from spoonapps/dev/rafal/fix-clnt-3347

document new batch behavior