bypass -> omit; clean up
add forReferers
add examples; strengthen requirements
add acks
add allowDirect and failPage
add zero-rate use case
add 1918 note
update XML