[PATCH 5/5] Documented signature and arg<n> attributes.

[Pekka Pessi]

---
 bus/dbus-daemon.1.in |   19 +++++++++++++++++--
 1 files changed, 17 insertions(+), 2 deletions(-)

diff --git a/bus/dbus-daemon.1.in b/bus/dbus-daemon.1.in
index 8d51813..3e92ad5 100644
--- a/bus/dbus-daemon.1.in
+++ b/bus/dbus-daemon.1.in
@@ -477,6 +477,8 @@ The possible attributes of these elements are:
    send_member="method_or_signal_name" 
    send_error="error_name" 
    send_destination="name" 
+   send_signature="signature"
+   send_arg0="value" .. send_arg29="value"
    send_type="method_call" | "method_return" | "signal" | "error" 
    send_path="/path/name"
 
@@ -484,6 +486,8 @@ The possible attributes of these elements are:
    receive_member="method_or_signal_name" 
    receive_error="error_name" 
    receive_sender="name" 
+   receive_signature="signature"
+   receive_arg0="value" .. receive_arg29="value"
    receive_type="method_call" | "method_return" | "signal" | "error"
    receive_path="/path/name"
 
@@ -500,7 +504,11 @@ The possible attributes of these elements are:
 .PP
 Examples:
 .nf
-   <deny send_destination="org.freedesktop.Service" send_interface="org.freedesktop.System" send_member="Reboot"/> 
+   <deny send_destination="org.freedesktop.Service"
+       send_interface="org.freedesktop.System" send_member="Reboot"/>
+   <allow send_destination="org.freedesktop.Service"
+       send_interface="org.freedesktop.System" send_member="Reboot"
+       send_signature="sas" send_arg0="standby" send_arg1="" />
    <deny send_destination="org.freedesktop.System"/>
    <deny receive_sender="org.freedesktop.System"/>
    <deny user="john"/>
@@ -520,8 +528,15 @@ owns services A, B, C, and sending to A is denied, sending to B or C
 will not work either.
 
 .PP
+The send_arg<n> and receive_arg<n> attributes are used to match against
+message arguments. The type of the argument is taken from the signature
+attribute, which is required when using the arg attributes. Only basic types
+are supported. However, it is possible to require that an array argument is
+empty.
+
+.PP
 The other send_* and receive_* attributes are purely textual/by-value
-matches against the given field in the message header.
+matches against the given field in the message.
 
 .PP
 "Eavesdropping" occurs when an application receives a message that
-- 
1.6.3.3