Red Hat Bugzilla – Bug 800322
qpid.msg_sequence wrong description in user guide
Last modified: 2014-10-19 19:00:24 EDT
Description of problem:
qpid.msg_sequence in "Exchange Declaration Parameters" section (Section 2.2) has wrong / confusing description. In particular this sentence is wrong:
"The sequence number for the first message sent to the exchange is 0, .."
Three changes are relevant:
1) Replace 0 by 1. As the very first msq_sequence in a message is really 1 (to check this, see Exchange::PreRoute::PreRoute method where parent->sequenceNo++; is called before setting msg_sequence to a message).
2) Replace "to the exchange" by "from / by the exchange". As msg_sequence is inserted to messages "leaving" the exchange, not arriving the exchange.
3) ??? "message sent" -> "message routed" as technically the exchange does not _send_ a message, it "just" routes them to queues. But changing this can cause some confusion to a reader so I am not sure if it is linguistically ok..
Also it makes sense to add there a notice that qpid.msg_sequence is reset to 1 when qpid broker is restarted.
Version-Release number of selected component (if applicable):
Steps to Reproduce:
Upstream docs need an update as well :
Released for MRG 2.2