explain input event handling better in the docs

The docs were always too vague, but Qt 6 has behavior changes, and cool new APIs too; so we need to make porting easier, and encourage users to write better event-handling code instead of cargo-culting, starting with item-based event handling and piling kludges on top, assuming that touch->mouse synthesis is still the thing to depend on, using event-filtering excessively, etc.