diff --git a/doc/dbus-specification.xml b/doc/dbus-specification.xml
index c2736d30..134dfa2d 100644
--- a/doc/dbus-specification.xml
+++ b/doc/dbus-specification.xml
@@ -5858,11 +5858,12 @@
- Message Bus Messages
+ Message Bus Interface: org.freedesktop.DBus
The special message bus name org.freedesktop.DBus
responds to a number of additional messages at the object path
- /org/freedesktop/DBus.
+ /org/freedesktop/DBus,
+ implementing the org.freedesktop.DBus interface.
That object path is also used when emitting signals such as
NameOwnerChanged.
@@ -5882,19 +5883,8 @@
instead of relying on this.
-
- In addition to the method calls listed below, the message bus
- should implement the standard
- Introspectable,
- Peer and
- Properties
- interfaces.
- Support for the Properties and Peer interfaces was added in version
- 1.11.x of the reference implementation of the message bus.
-
-
- org.freedesktop.DBus.Hello
+ Method: org.freedesktop.DBus.Hello
As a method:
@@ -5937,7 +5927,7 @@
- org.freedesktop.DBus.RequestName
+ Method: org.freedesktop.DBus.RequestName
As a method:
@@ -6175,7 +6165,7 @@
- org.freedesktop.DBus.ReleaseName
+ Method: org.freedesktop.DBus.ReleaseName
As a method:
@@ -6268,7 +6258,7 @@
- org.freedesktop.DBus.ListQueuedOwners
+ Method: org.freedesktop.DBus.ListQueuedOwners
As a method:
@@ -6322,7 +6312,7 @@
- org.freedesktop.DBus.ListNames
+ Method: org.freedesktop.DBus.ListNames
As a method:
@@ -6353,7 +6343,7 @@
- org.freedesktop.DBus.ListActivatableNames
+ Method: org.freedesktop.DBus.ListActivatableNames
As a method:
@@ -6384,7 +6374,7 @@
- org.freedesktop.DBus.NameHasOwner
+ Method: org.freedesktop.DBus.NameHasOwner
As a method:
@@ -6435,7 +6425,7 @@
- org.freedesktop.DBus.NameOwnerChanged
+ Signal: org.freedesktop.DBus.NameOwnerChanged
This is a signal:
@@ -6478,7 +6468,7 @@
- org.freedesktop.DBus.NameLost
+ Signal: org.freedesktop.DBus.NameLost
This is a signal:
@@ -6511,7 +6501,7 @@
- org.freedesktop.DBus.NameAcquired
+ Signal: org.freedesktop.DBus.NameAcquired
This is a signal:
@@ -6544,7 +6534,7 @@
- org.freedesktop.DBus.ActivatableServicesChanged
+ Signal: org.freedesktop.DBus.ActivatableServicesChanged
This is a signal:
@@ -6570,7 +6560,7 @@
- org.freedesktop.DBus.StartServiceByName
+ Method: org.freedesktop.DBus.StartServiceByName
As a method:
@@ -6671,7 +6661,7 @@
- org.freedesktop.DBus.UpdateActivationEnvironment
+ Method: org.freedesktop.DBus.UpdateActivationEnvironment
As a method:
@@ -6708,7 +6698,7 @@
- org.freedesktop.DBus.GetNameOwner
+ Method: org.freedesktop.DBus.GetNameOwner
As a method:
@@ -6759,7 +6749,7 @@
- org.freedesktop.DBus.GetConnectionUnixUser
+ Method: org.freedesktop.DBus.GetConnectionUnixUser
As a method:
@@ -6812,7 +6802,7 @@
- org.freedesktop.DBus.GetConnectionUnixProcessID
+ Method: org.freedesktop.DBus.GetConnectionUnixProcessID
As a method:
@@ -6865,7 +6855,7 @@
- org.freedesktop.DBus.GetConnectionCredentials
+ Method: org.freedesktop.DBus.GetConnectionCredentials
As a method:
@@ -7049,7 +7039,7 @@
- org.freedesktop.DBus.GetAdtAuditSessionData
+ Method: org.freedesktop.DBus.GetAdtAuditSessionData
As a method:
@@ -7107,7 +7097,7 @@
- org.freedesktop.DBus.GetConnectionSELinuxSecurityContext
+ Method: org.freedesktop.DBus.GetConnectionSELinuxSecurityContext
As a method:
@@ -7166,7 +7156,7 @@
- org.freedesktop.DBus.AddMatch
+ Method: org.freedesktop.DBus.AddMatch
As a method:
@@ -7197,7 +7187,7 @@
- org.freedesktop.DBus.RemoveMatch
+ Method: org.freedesktop.DBus.RemoveMatch
As a method:
@@ -7229,7 +7219,7 @@
- org.freedesktop.DBus.GetId
+ Method: org.freedesktop.DBus.GetId
As a method:
@@ -7264,109 +7254,8 @@
-
- org.freedesktop.DBus.Monitoring.BecomeMonitor
-
- As a method:
-
- BecomeMonitor (in ARRAY of STRING rule, in UINT32 flags)
-
- Message arguments:
-
-
-
-
- Argument
- Type
- Description
-
-
-
-
- 0
- ARRAY of STRING
- Match rules to add to the connection
-
-
- 1
- UINT32
- Not used, must be 0
-
-
-
-
-
-
-
- Converts the connection into a monitor
- connection which can be used as a debugging/monitoring
- tool. Only a user who is privileged on this
- bus (by some implementation-specific definition) may create
- monitor connections
-
- In the reference implementation,
- the default configuration is that each user (identified by
- numeric user ID) may monitor their own session bus,
- and the root user (user ID zero) may monitor the
- system bus.
-
- .
-
-
-
- Monitor connections lose all their bus names, including the unique
- connection name, and all their match rules. Sending messages on a
- monitor connection is not allowed: applications should use a private
- connection for monitoring.
-
-
-
- Monitor connections may receive all messages, even messages that
- should only have gone to some other connection ("eavesdropping").
- The first argument is a list of match rules, which replace any
- match rules that were previously active for this connection.
- These match rules are always treated as if they contained the
- special eavesdrop='true' member.
-
-
-
- As a special case, an empty list of match rules (which would
- otherwise match nothing, making the monitor useless) is treated
- as a shorthand for matching all messages.
-
-
-
- The second argument might be used for flags to influence the
- behaviour of the monitor connection in future D-Bus versions.
-
-
-
- Message bus implementations should attempt to minimize the
- side-effects of monitoring — in particular, unlike ordinary
- eavesdropping, monitoring the system bus does not require the
- access control rules to be relaxed, which would change the set
- of messages that can be delivered to their (non-monitor)
- destinations. However, it is unavoidable that monitoring
- will increase the message bus's resource consumption. In
- edge cases where there was barely enough time or memory without
- monitoring, this might result in message deliveries failing
- when they would otherwise have succeeded.
-
-
-
-
-
-
- Message Bus Properties
-
- The special message bus name org.freedesktop.DBus
- exports several properties (see
- ) on the object path
- /org/freedesktop/DBus.
-
-
- org.freedesktop.DBus.Features
+ Property: org.freedesktop.DBus.Features
As a property:
@@ -7471,7 +7360,7 @@
- org.freedesktop.DBus.Interfaces
+ Property: org.freedesktop.DBus.Interfaces
As a property:
@@ -7503,6 +7392,139 @@
+
+ Message Bus Introspection
+
+ The message bus should implement the standard
+ Introspectable
+ interface.
+
+
+
+
+ Message Bus as a Peer
+
+ The message bus should implement the standard
+ Peer interface.
+ Support for the Peer interface was added in version
+ 1.11.x of the reference implementation of the message bus.
+
+
+
+
+ Message Bus Properties
+
+ The message bus should implement the standard
+ Properties
+ interface on the object path
+ /org/freedesktop/DBus.
+ The specific properties to be provided are documented as part of
+ their respective interfaces.
+ Support for the Properties interface was added in version
+ 1.11.x of the reference implementation of the message bus.
+
+
+
+
+ Monitoring Interface: org.freedesktop.DBus.Monitoring
+
+ The special message bus name org.freedesktop.DBus
+ may optionally implement the
+ org.freedesktop.DBus.Monitoring interface on
+ the object path /org/freedesktop/DBus.
+
+
+
+ Method: org.freedesktop.DBus.Monitoring.BecomeMonitor
+
+ As a method:
+
+ BecomeMonitor (in ARRAY of STRING rule, in UINT32 flags)
+
+ Message arguments:
+
+
+
+
+ Argument
+ Type
+ Description
+
+
+
+
+ 0
+ ARRAY of STRING
+ Match rules to add to the connection
+
+
+ 1
+ UINT32
+ Not used, must be 0
+
+
+
+
+
+
+
+ Converts the connection into a monitor
+ connection which can be used as a debugging/monitoring
+ tool. Only a user who is privileged on this
+ bus (by some implementation-specific definition) may create
+ monitor connections
+
+ In the reference implementation,
+ the default configuration is that each user (identified by
+ numeric user ID) may monitor their own session bus,
+ and the root user (user ID zero) may monitor the
+ system bus.
+
+ .
+
+
+
+ Monitor connections lose all their bus names, including the unique
+ connection name, and all their match rules. Sending messages on a
+ monitor connection is not allowed: applications should use a private
+ connection for monitoring.
+
+
+
+ Monitor connections may receive all messages, even messages that
+ should only have gone to some other connection ("eavesdropping").
+ The first argument is a list of match rules, which replace any
+ match rules that were previously active for this connection.
+ These match rules are always treated as if they contained the
+ special eavesdrop='true' member.
+
+
+
+ As a special case, an empty list of match rules (which would
+ otherwise match nothing, making the monitor useless) is treated
+ as a shorthand for matching all messages.
+
+
+
+ The second argument might be used for flags to influence the
+ behaviour of the monitor connection in future D-Bus versions.
+
+
+
+ Message bus implementations should attempt to minimize the
+ side-effects of monitoring — in particular, unlike ordinary
+ eavesdropping, monitoring the system bus does not require the
+ access control rules to be relaxed, which would change the set
+ of messages that can be delivered to their (non-monitor)
+ destinations. However, it is unavoidable that monitoring
+ will increase the message bus's resource consumption. In
+ edge cases where there was barely enough time or memory without
+ monitoring, this might result in message deliveries failing
+ when they would otherwise have succeeded.
+
+
+
+