spec: Clarify behaviour of o.f.D.P.GetAll
authorPhilip Withnall <philip.withnall@collabora.co.uk>
Tue, 1 Nov 2016 04:17:54 +0000 (21:17 -0700)
committerSimon McVittie <simon.mcvittie@collabora.co.uk>
Tue, 22 Nov 2016 11:26:46 +0000 (11:26 +0000)
commit8eca3f6ed945653aff8e81fde8141c64fdf9a3f4
treea8072b18fbd2491285d00115909439d7d2d9fd4d
parentb51aa049c7db9a5acdc932e2d27639700c5091f0
spec: Clarify behaviour of o.f.D.P.GetAll

Clarify its intended behaviour in two situations:
 • For interfaces which have no properties.
 • Where some properties are not visible to the caller (due to access
   control, for example).

The intention here is for this behaviour to be mandatory, but given that
this is quite late on in the specification’s life, and various D-Bus
libraries like dbus-glib and telepathy-glib cannot support access
control at a per-property level, for example. GDBus can, although it’s
questionable whether this is a good idea. Deliberately leave the
specification open to allow access control at a higher level as well
(such as per-(object, interface)).

Bug: https://bugs.freedesktop.org/show_bug.cgi?id=36190
Reviewed-by: Simon McVittie <simon.mcvittie@collabora.co.uk>
doc/dbus-specification.xml