Document altered HWM behaviour when ZMQ_ROUTER_MANDATORY is set.
Merge pull request #1155 from mrvn/pull-document_hwm_behaviour_with_ZMQ_ROUTER_MANDATORY

Document altered HWM behaviour when ZMQ_ROUTER_MANDATORY is set.