[glib/gdbus-merge] GDBus: Update TODO list

[David Zeuthen <davidz src gnome org>]

commit 8c523c069b79a746c2dcdfe7e253513ff489cd39
Author: David Zeuthen <davidz redhat com>
Date:   Tue May 11 12:04:37 2010 -0400

    GDBus: Update TODO list

 gio/gdbusconnection.c |   28 ++++++++++++++++++++++++++++
 1 files changed, 28 insertions(+), 0 deletions(-)
---
diff --git a/gio/gdbusconnection.c b/gio/gdbusconnection.c
index a8301ae..4921e97 100644
--- a/gio/gdbusconnection.c
+++ b/gio/gdbusconnection.c
@@ -85,6 +85,34 @@
  *    3 -> /proc/18068/fd
  *
  *   e.g. not of much use.
+ *
+ *  - GDBus High-Level docs
+ *    - Proxy: properties, signals...
+ *    - Connection: IOStream based, ::close, connection setup steps
+ *                  mainloop integration, threading
+ *    - Differences from libdbus (extend "Migrating from")
+ *      - the message handling thread
+ *      - Using GVariant instead of GValue
+ *    - Explain why the high-level API is a good thing and what
+ *      kind of pitfalls it avoids
+ *      - Export objects before claiming names
+ *    - Talk about auto-starting services (cf. GBusNameWatcherFlags)
+ *
+ *  - Mention in all API that the GVariant is sunk. Also mention
+ *    when the returned GVariant is floating.
+ *
+ *  - Small example snippet for each method where useful (won't
+ *    have to compile) where it makes sense (e.g. connetion_call()
+ *    and using a floating GVariant).
+ *
+ *  - Consistent timeout handling (25s vs 30s?)
+ *
+ *  - GDBusProxy subclass example
+ *
+ *  - Update GDBusAuthObserver (is_same_user(), s/deny/authorize/)
+ *
+ *  - Remove properties on GDBusMethodInvocation
+ *
  */
 
 #include "config.h"