From 8c523c069b79a746c2dcdfe7e253513ff489cd39 Mon Sep 17 00:00:00 2001
From: David Zeuthen <davidz@redhat.com>
Date: Tue, 11 May 2010 12:04:37 -0400
Subject: [PATCH] GDBus: Update TODO list

---
 gio/gdbusconnection.c | 28 ++++++++++++++++++++++++++++
 1 file changed, 28 insertions(+)

diff --git a/gio/gdbusconnection.c b/gio/gdbusconnection.c
index a8301ae72..4921e971c 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"