2006-10-30 Havoc Pennington <hp@redhat.com>

* tools/dbus-launch.1, doc/TODO: capture intent to change the
	command line options of dbus-launch a bit post 1.0

ChangeLog

@@ -1,3 +1,8 @@
+2006-10-30  Havoc Pennington  <hp@redhat.com>
+
+	* tools/dbus-launch.1, doc/TODO: capture intent to change the
+	command line options of dbus-launch a bit post 1.0
+
 2006-10-27  Havoc Pennington  <hp@redhat.com>
 	
 	* dbus/dbus-connection.c (dbus_connection_open_private): document

doc/TODO

@@ -40,6 +40,11 @@ Might as Well for 1.0
 
 Can Be Post 1.0
 ===
+
+ - revamp dbus-launch a bit,
+   see http://lists.freedesktop.org/archives/dbus/2006-October/005906.html
+   for some thoughts.
+
  - clean up the creds issue on *BSD's in dbus/dbus-sysdeps-unix.c.
    They should work as is but we need to rearange it to make it
    clearer which method is being used.  configure.in should

tools/dbus-launch.1

@@ -118,6 +118,11 @@ DBUS_SESSION_BUS_ADDRESS="something:,autolaunch:" - in that case if
 the first address doesn't work, processes will autolaunch. (The bus
 address variable contains a comma-separated list of addresses to try.)
 
+.PP
+The --autolaunch option is considered an internal implementation
+detail of libdbus, and in fact there are plans to change it. There's
+no real reason to use it outside of the libdbus implementation anyhow.
+
 .SH OPTIONS
 The following options are supported:
 .TP
@@ -152,7 +157,8 @@ This option implies that \fIdbus-launch\fP should scan for a
 previously-started session and reuse the values found there. If no
 session is found, it will start a new session. The
 \-\-exit-with-session option is implied if \-\-autolaunch is given.
-This option is used by libdbus, you probably do not want to use it manually.
+This option is for the exclusive use of libdbus, you do not want to
+use it manually. It may change in the future.
 
 .TP
 .I "--sh-syntax"