annotate doc/dbus-server-signals.dox @ 28878:86ff30fb8ae3

http://dev.aol.com/aim/oscar/ says, "All strings in Feedbag are UTF8 encoded." So stop trying to validate stuff as utf8 then salvage when it isn't and just display broken crap or crash. I'm not sure if this is actually a good idea. Our cleanlist function in family_feedbag.c should probably remove or fix strings that aren't utf8, but I'm not about to do that right now. If someone else wants to feel free.

/** @page dbus-server-signals DBus Server Signals

 @signals
  @signal dbus-method-called
  @signal dbus-introspect
 @endsignals

 @see dbus-server.h

 <hr>

 @signaldef dbus-method-called
  @signalproto
gboolean (*dbus_method_called)(DBusConnection *connection,
                               DBusMessage *message);
  @endsignalproto
  @signaldesc
   Emitted when a dbus method is going to be called.
  @param connection The DBus connection.
  @param message The DBus message.
  @return TRUE if signal handler handled the method. ???
 @endsignaldef

 @signaldef dbus-introspect
  @signalproto
void (*dbus_introspect)(GList **bidings_list);
  @endsignalproto
  @signaldesc
   ???
  @param bindings_list ???
 @endsignaldef

 */
// vim: syntax=c.doxygen tw=75 et