Author: chirino Date: Fri Dec 17 15:25:40 2010 New Revision: 1050421 URL: http://svn.apache.org/viewvc?rev=1050421&view=rev Log: clarifying browser doco. Modified: activemq/activemq-apollo/trunk/apollo-website/src/documentation/user-manual.md Modified: activemq/activemq-apollo/trunk/apollo-website/src/documentation/user-manual.md URL: http://svn.apache.org/viewvc/activemq/activemq-apollo/trunk/apollo-website/src/documentation/user-manual.md?rev=1050421&r1=1050420&r2=1050421&view=diff ============================================================================== --- activemq/activemq-apollo/trunk/apollo-website/src/documentation/user-manual.md (original) +++ activemq/activemq-apollo/trunk/apollo-website/src/documentation/user-manual.md Fri Dec 17 15:25:40 2010 @@ -720,11 +720,11 @@ redelivered to another subscribed client ### Browsing Subscriptions -A normal subscription on a queue will consume messages so that no -other subscription will get a copy of the message. If you want to -browse all the messages on a queue in a non-destructive fashion, you -can create browsing subscription. To make a subscription an browsing -subscription, just add the `browser:true` header. For example: +A normal subscription on a queue will consume messages so that no other +subscription will get a copy of the message. If you want to browse all the +messages on a queue in a non-destructive fashion, you can create browsing +subscription. To make a a browsing subscription, just add the `browser:true` +header to the `SUBSCRIBE` frame. For example: SUBSCRIBE id:mysub @@ -733,6 +733,18 @@ subscription, just add the `browser:true ^@ +Once the broker sends a browsing subscription the last message in the queue, +it will send the subscription a special "end of browse" message to indicate +browsing has completed and that the subscription should not expect any more +messages. The "end of browse" message will have a `browser:end` header set. +Example: + + MESSAGE + subscription:mysub + browser:end + + ^@ + ### Topic Durable Subscriptions A durable subscription is a queue which is subscribed to a topic so that