Flush clarification

Removed flush=all as it is undocumented and appears it will be removed
post SS3.1.6 in favour of flushing everything using flush=1. Added
titles to links attempting to explain flush functions.
Merge pull request #4 from jonom/pr/2

Flush clarification