dbus/doc
David Zeuthen 2541e86615 Add an optional PropertiesChanged() signal
Some notes about this new signal

 - The PropertiesChanged() signal is optional. An application can
   convey support for this signal by either including or excluding it
   from the returned introspection data much like apps not supporting
   (or predating) the GetAll() method does not include GetAll() in the
   introspection data.

 - An object can use PropertiesChanged() but opt out of using it for
   one or more properties by using the

     org.freedesktop.DBus.Properties.EmitsChangedSignal

   annotation on the properties in question

 - Applications can start using this new signal without breaking
   compatibility with clients relying on existing D-Bus API.

The intent of the patch is simply to standardize existing behavior

 - EggDBus has a very similar signal called EggDBusPropertiesChanged()
   (also on the org.freedesktop.DBus.Properties interface)

 - NetworkManager has a PropertiesChanged() signal on each different
   interface (e.g. not org.fd.D.P) that it implements

 - GDBus, an implementation of the D-Bus protocol in GLib, already
   implements this signal

Signed-off-by: David Zeuthen <davidz@redhat.com>
2010-05-12 12:28:19 -04:00
..
.gitignore migrate from cvs to git (cvs2svn -> git-svnimport). 2007-09-13 11:13:40 -04:00
busconfig.dtd Bug 18446: Keep umask for session bus 2009-01-06 18:20:13 -05:00
dbus-faq.xml 2006-11-17 Havoc Pennington <hp@redhat.com> 2006-11-18 03:21:50 +00:00
dbus-specification.xml Add an optional PropertiesChanged() signal 2010-05-12 12:28:19 -04:00
dbus-test-plan.xml * s/D-BUS/D-Bus/g 2006-08-03 20:34:36 +00:00
dbus-tutorial.xml * doc/dbus-tutorial.xml: Replace Python section of tutorial with 2007-01-25 16:42:54 +00:00
dcop-howto.txt initial import of "dbus" skeleton 2002-11-21 16:41:33 +00:00
diagram.png 2005-01-18 Havoc Pennington <hp@redhat.com> 2005-01-18 20:42:15 +00:00
diagram.svg 2005-01-18 Havoc Pennington <hp@redhat.com> 2005-01-18 20:42:15 +00:00
file-boilerplate.c Bug 21161 - Update the FSF address 2009-07-14 15:39:47 -04:00
introspect.dtd * s/D-BUS/D-Bus/g 2006-08-03 20:34:36 +00:00
introspect.xsl Bug 21161 - Update the FSF address 2009-07-14 15:39:47 -04:00
Makefile.am Move system-activation.txt into non-conditional EXTRA_DIST 2010-02-01 16:45:48 -05:00
system-activation.txt 2007-07-24 Richard Hughes <richard@hughsie.com> 2007-07-24 11:23:46 +00:00
TODO 2006-11-08 Havoc Pennington <hp@redhat.com> 2006-11-09 00:19:29 +00:00