Consider rewording ack modes on the listener container javadocs [SPR-12705]

[spring-projects-issues]

Gary Russell opened SPR-12705 and commented

"sessionAcknowledgeMode" set to "AUTO_ACKNOWLEDGE" (default): Automatic message acknowledgment before listener execution; no redelivery in case of exception thrown.
...

While a following sentence says...

The exact behavior might vary according to the concrete listener container and JMS provider used.

...this might be confusing (as has been proved to be - see the SO question) to users because it is contrary to the standard JMS behavior, as exhibited by the SMLC.

The SMLC also says...

See the AbstractMessageListenerContainer javadoc for details on acknowledge modes and transaction options.

...and also does not explicitly explain that AUTO_ACKNOWLEDGE works in the standard JMS way.

---

Affects: 3.2.13, 4.1.4

Reference URL: http://stackoverflow.com/questions/28426467/difference-between-auto-acknowledgement-mode-with-and-without-spring-jms

Issue Links:

• Remoting over JMS with receiveTimeout blocks service forever [SPR-13052] #17644 Remoting over JMS with receiveTimeout blocks service forever

Referenced from: commits c1a9e34, 91c47a9, 1c10861

Backported to: 3.2.14