qpid-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From g...@apache.org
Subject svn commit: r961662 - /qpid/trunk/qpid/doc/book/src/Programming-In-Apache-Qpid.xml
Date Thu, 08 Jul 2010 09:29:49 GMT
Author: gsim
Date: Thu Jul  8 09:29:48 2010
New Revision: 961662

URL: http://svn.apache.org/viewvc?rev=961662&view=rev
Log:
Minor corrections to addressing example text.

Modified:
    qpid/trunk/qpid/doc/book/src/Programming-In-Apache-Qpid.xml

Modified: qpid/trunk/qpid/doc/book/src/Programming-In-Apache-Qpid.xml
URL: http://svn.apache.org/viewvc/qpid/trunk/qpid/doc/book/src/Programming-In-Apache-Qpid.xml?rev=961662&r1=961661&r2=961662&view=diff
==============================================================================
--- qpid/trunk/qpid/doc/book/src/Programming-In-Apache-Qpid.xml (original)
+++ qpid/trunk/qpid/doc/book/src/Programming-In-Apache-Qpid.xml Thu Jul  8 09:29:48 2010
@@ -554,8 +554,8 @@ options ::=  { <key> : <value>, ... }
 	<xref linkend="section-address-string-bnf"/>.</para>
 
 
-	<para>So far, the address strings in this tutorial have used
-	only addresses. The following sections show how to use
+	<para>So far, the address strings in this tutorial have only
+	used simple names. The following sections show how to use
 	subjects and options.</para>
 
       </section>
@@ -579,18 +579,15 @@ options ::=  { <key> : <value>, ... }
 
       <para>
 	In AMQP 0-10, each exchange type has its own matching
-	algorithm, and queues do not provide filtering. This is
-	discussed in <xref linkend="section-amqp0-10-mapping"/>.
+	algorithm. This is discussed in
+	<xref linkend="section-amqp0-10-mapping"/>.
       </para>
 
       <note>
 	<para>
 	  Currently, a receiver bound to a queue ignores subjects,
-	  receiving messages from the queue without filtering.
-
-	  In the future, if a receiver is bound to a queue, and its
-	  address contains a subject, the subject will be used as a
-	  selector to filter messages.
+	  receiving messages from the queue without filtering. Support
+	  for subject filtering on queues will be implemented soon.
 	</para>
       </note>
 
@@ -739,7 +736,7 @@ Message(properties={qpid.subject:usa.fau
       <title>Address String Options</title>
 
       <para>
-        The options in an address string contain additional
+        The options in an address string can contain additional
         information for the senders or receivers created for it,
         including:
       </para>
@@ -780,13 +777,12 @@ Message(properties={qpid.subject:usa.fau
         </listitem>
         <listitem>
           <para>
-            Extension points that rely on the functionality of specific node types.
+            Extension points providing more direct control over the underlying protocol.
 	  </para>
 	  <para>
-	    For instance, the Qpid XML exchange can use XQuery to do
-	    content-based routing for XML messages, or to query
-	    message data using XQuery. Queries can be specified using
-	    options.
+	    For instance, the <literal>x-bindings</literal> property
+	    allows greater control over the AMQP 0-10 binding process
+	    when an address is resolved.
           </para>
         </listitem>
       </itemizedlist>
@@ -924,13 +920,17 @@ Message(properties={spout-id:ea75d64d-ea
       <section>
 	<title>x-bindings</title>
 
-	<para><literal>x-bindings</literal> allows an address string
-	to specify properties AMQP 0-10 bindings. For instance, the
-	XML Exchange is an AMQP 0-10 custom exchange provided by the
-	Apache Qpid C++ broker. It allows messages to be filtered
-	using XQuery; queries can address either message properties or
-	XML content in the body of the message. These queries can be
-	specified in addresses using x-bindings</para>
+	<para>By including an <literal>x-bindings</literal> option in
+        an address string, greater control over the AMQP 0-10 binding
+        process can be achieved. For instance, the XML Exchange is an
+        AMQP 0-10 custom exchange provided by the Apache Qpid C++
+        broker. It allows messages to be filtered using XQuery;
+        queries can address either message properties or XML content
+        in the body of the message. The xquery is specified in the
+        arguments field of the AMQP 0-10 command. When using the
+        messaging API an xquery can be specified in and address that
+        resolves to an XML exchange by using the x-bindings
+        property.</para>
 
 
 	<para>An instance of the XML Exchange must be added before it



---------------------------------------------------------------------
Apache Qpid - AMQP Messaging Implementation
Project:      http://qpid.apache.org
Use/Interact: mailto:commits-subscribe@qpid.apache.org


Mime
View raw message