update man page with message-specific docs.

* document the message creation and destruction functions
* document the behaviour of smq_send on messages
* document the defines SMQ_DESTROY_ALL and SMQ_CONTAINER_ONLY