Deckard: massive docs update and rewrite

The docs should now match reality except pieces which are intentionally
not documented. This includes STEP REPLAY and entry flags MANDATORY and TSIG.
These are rarely used and might be changed in future versions.