From d8d91cb6148e723f656e0d2e68383ef4cc11b81a Mon Sep 17 00:00:00 2001
From: Lennart Poettering <lennart@poettering.net>
Date: Tue, 25 Aug 2015 19:46:04 +0200
Subject: [PATCH 2/2] spec: document the new 'arg0has=' string array match type

This adds specification for a new 'arg0has=' match type, that can check
strings against messages with string array arguments.

This has been discussed on the mailing list a while back:

http://lists.freedesktop.org/archives/dbus/2015-April/016666.html

There's also an implementation for this posted for sd-bus:

https://github.com/systemd/systemd/pull/1036
---
 doc/dbus-specification.xml | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/doc/dbus-specification.xml b/doc/dbus-specification.xml
index 0468992..3b269d4 100644
--- a/doc/dbus-specification.xml
+++ b/doc/dbus-specification.xml
@@ -4886,6 +4886,20 @@
                   </entry>
                 </row>
                 <row>
+                  <entry><literal>arg[0, 1, 2, 3, ...]has</literal></entry>
+                  <entry>An array of strings ("as")</entry>
+                  <entry>Match a message whose n-th argument is an
+                  array of strings, which contains the specified
+                  string (and possibly others). An example of a string
+                  array argument match would be
+                  <literal>arg2has='waldo'</literal>, which matches
+                  all messages that have a string array as 2nd
+                  argument, and where the string array contains at
+                  least the string <literal>'waldo'</literal>. Only
+                  argument indexes from 0 to 63 should be
+                  accepted.</entry>
+                </row>
+                <row>
                   <entry><literal>eavesdrop</literal></entry>
                   <entry><literal>'true'</literal>, <literal>'false'</literal></entry>
                   <entry>Since D-Bus 1.5.6, match rules do not
-- 
2.4.3