[jboss-cvs] JBoss Messaging SVN: r6747 - trunk/docs/user-manual/en/modules.

[jboss-cvs-commits at lists.jboss.org]

Author: timfox
Date: 2009-05-12 13:49:33 -0400 (Tue, 12 May 2009)
New Revision: 6747

Added:
   trunk/docs/user-manual/en/modules/wildcard-syntax.xml
Log:
added wildcard syntax chapter

Added: trunk/docs/user-manual/en/modules/wildcard-syntax.xml
===================================================================
--- trunk/docs/user-manual/en/modules/wildcard-syntax.xml	                        (rev 0)
+++ trunk/docs/user-manual/en/modules/wildcard-syntax.xml	2009-05-12 17:49:33 UTC (rev 6747)
@@ -0,0 +1,18 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<chapter id="wildcard-syntax">
+    <title>Understanding the JBoss Messaging Wildcard Syntax</title>
+    <para>JBoss Messaging uses a specific syntax for representing wildcards in security settings, address settings and when creating consumers.</para>
+    <para>The syntax is similar to that used by AMQP [LINK]</para>
+    <para>A JBoss Messaging wildcard expression contains words delimited by the character '<literal>.</literal>' (full stop).</para>
+    <para>The special characters '<literal>#</literal>' and '<literal>*</literal>' also have special meaning and can take the place of a word.</para>
+    <para>The character '<literal>#</literal>' means 'match any sequence of zero or more words'.</para>
+    <para>The character '<literal>*</literal>' means 'match a single word'.</para>
+    <para>So the wildcard 'news.europe.#' would match 'news.europe', 'news.europe.sport', 'news.europe.politics', and 'news.europe.politics.regional'
+    but would not match 'news.usa', 'news.usa.sport' nor 'entertainment'.</para>
+    <para>The wildcard 'news.*' would match 'news.europe', but not 'news.europe.sport'.</para>
+    <para>The wildcard 'news.*.sport' would match 'news.europe.sport' and also 'news.usa.sport', but not 'news.europe.politics'.</para>
+    
+    
+    
+</chapter>
+