You are viewing a plain text version of this content. The canonical link for it is here.

Posted to commits@activemq.apache.org by ch...@apache.org on 2010/12/17 16:25:40 UTC

svn commit: r1050421 - /activemq/activemq-apollo/trunk/apollo-website/src/documentation/user-manual.md

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