Bug 1094803 - Update the APZ docs a bit to describe input event flow. r=botond

DONTBUILD because this is NPOTB.