This is an automated email from the ASF dual-hosted git repository.
jbertram pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/activemq-artemis.git
The following commit(s) were added to refs/heads/main by this push:
new dc2b67331d NO-JIRA update address-settings.md
new 382267bf63 This closes #4166
dc2b67331d is described below
commit dc2b67331dcd3e52254e1567c08424795a11347f
Author: Stephen E. Baker <[email protected]>
AuthorDate: Wed Aug 3 09:13:03 2022 -0400
NO-JIRA update address-settings.md
Add a note about match specificity
---
docs/user-manual/en/address-settings.md | 8 ++++++++
1 file changed, 8 insertions(+)
diff --git a/docs/user-manual/en/address-settings.md
b/docs/user-manual/en/address-settings.md
index d1651a524f..51fdb880b5 100644
--- a/docs/user-manual/en/address-settings.md
+++ b/docs/user-manual/en/address-settings.md
@@ -73,6 +73,14 @@ address "order.foo" address but you can also use
For example, if you used the `match` string `queue.#` the settings would be
applied to all addresses which start with `queue.`
+Address settings are **hierarchical**. Therefore, if more than one
+`address-setting` would match then the settings are applied in order of their
+specificity with the more specific match taking priority. A match on the
+any-words delimiter (`#`) is considered less specific than a match without it.
+A match with a single word delimiter `*` is considered less specific than a
+match on an exact queue name. In this way settings can be "layered" so that
+configuration details don't need to be repeated.
+
The meaning of the specific settings are explained fully throughout the user
manual, however here is a brief description with a link to the appropriate
chapter if available.
