[glib] docs: Add links to D-Bus specification for D-Bus address format

[Philip Withnall <pwithnall src gnome org>]

commit 78fba90f6505b0a8a6fd4ad10825a3e45faaa460
Author: Philip Withnall <withnall endlessm com>
Date:   Wed Feb 8 15:06:00 2017 +0000

    docs: Add links to D-Bus specification for D-Bus address format
    
    In an attempt to clarify the format a little.

 gio/gdbusaddress.c    |   20 ++++++++++++++------
 gio/gdbusconnection.c |    6 ++++--
 gio/gdbusserver.c     |    5 +++--
 3 files changed, 21 insertions(+), 10 deletions(-)
---
diff --git a/gio/gdbusaddress.c b/gio/gdbusaddress.c
index 26fbec4..d00df39 100644
--- a/gio/gdbusaddress.c
+++ b/gio/gdbusaddress.c
@@ -63,8 +63,9 @@
  * @include: gio/gio.h
  *
  * Routines for working with D-Bus addresses. A D-Bus address is a string
- * like "unix:tmpdir=/tmp/my-app-name". The exact format of addresses
- * is explained in detail in the [D-Bus 
specification](http://dbus.freedesktop.org/doc/dbus-specification.html\#addresses).
+ * like `unix:tmpdir=/tmp/my-app-name`. The exact format of addresses
+ * is explained in detail in the
+ * [D-Bus specification](http://dbus.freedesktop.org/doc/dbus-specification.html#addresses).
  */
 
 static gchar *get_session_address_platform_specific (GError **error);
@@ -76,7 +77,8 @@ static gchar *get_session_address_dbus_launch       (GError **error);
  * g_dbus_is_address:
  * @string: A string.
  *
- * Checks if @string is a D-Bus address.
+ * Checks if @string is a
+ * [D-Bus address](https://dbus.freedesktop.org/doc/dbus-specification.html#addresses).
  *
  * This doesn't check if @string is actually supported by #GDBusServer
  * or #GDBusConnection - use g_dbus_is_supported_address() to do more
@@ -370,7 +372,8 @@ is_valid_tcp (const gchar  *address_entry,
  *
  * Like g_dbus_is_address() but also checks if the library suppors the
  * transports in @string and that key/value pairs for each transport
- * are valid.
+ * are valid. See the specification of the
+ * [D-Bus address format](https://dbus.freedesktop.org/doc/dbus-specification.html#addresses).
  *
  * Returns: %TRUE if @string is a valid D-Bus address that is
  * supported by this library, %FALSE if @error is set.
@@ -839,7 +842,8 @@ get_stream_thread_func (GTask         *task,
  *
  * Asynchronously connects to an endpoint specified by @address and
  * sets up the connection so it is in a state to run the client-side
- * of the D-Bus authentication conversation.
+ * of the D-Bus authentication conversation. @address must be in the
+ * [D-Bus address format](https://dbus.freedesktop.org/doc/dbus-specification.html#addresses).
  *
  * When the operation is finished, @callback will be invoked. You can
  * then call g_dbus_address_get_stream_finish() to get the result of
@@ -917,7 +921,8 @@ g_dbus_address_get_stream_finish (GAsyncResult        *res,
  *
  * Synchronously connects to an endpoint specified by @address and
  * sets up the connection so it is in a state to run the client-side
- * of the D-Bus authentication conversation.
+ * of the D-Bus authentication conversation. @address must be in the
+ * [D-Bus address format](https://dbus.freedesktop.org/doc/dbus-specification.html#addresses).
  *
  * This is a synchronous failable function. See
  * g_dbus_address_get_stream() for the asynchronous version.
@@ -1549,6 +1554,9 @@ get_session_address_platform_specific (GError **error)
  * bus instance specified by @bus_type. This may involve using various
  * platform specific mechanisms.
  *
+ * The returned address will be in the
+ * [D-Bus address format](https://dbus.freedesktop.org/doc/dbus-specification.html#addresses).
+ *
  * Returns: a valid D-Bus address string for @bus_type or %NULL if
  *     @error is set
  *
diff --git a/gio/gdbusconnection.c b/gio/gdbusconnection.c
index e15406a..96a40ac 100644
--- a/gio/gdbusconnection.c
+++ b/gio/gdbusconnection.c
@@ -2798,7 +2798,8 @@ g_dbus_connection_new_sync (GIOStream             *stream,
  *
  * Asynchronously connects and sets up a D-Bus client connection for
  * exchanging D-Bus messages with an endpoint specified by @address
- * which must be in the D-Bus address format.
+ * which must be in the
+ * [D-Bus address format](https://dbus.freedesktop.org/doc/dbus-specification.html#addresses).
  *
  * This constructor can only be used to initiate client-side
  * connections - use g_dbus_connection_new() if you need to act as the
@@ -2884,7 +2885,8 @@ g_dbus_connection_new_for_address_finish (GAsyncResult  *res,
  *
  * Synchronously connects and sets up a D-Bus client connection for
  * exchanging D-Bus messages with an endpoint specified by @address
- * which must be in the D-Bus address format.
+ * which must be in the
+ * [D-Bus address format](https://dbus.freedesktop.org/doc/dbus-specification.html#addresses).
  *
  * This constructor can only be used to initiate client-side
  * connections - use g_dbus_connection_new_sync() if you need to act
diff --git a/gio/gdbusserver.c b/gio/gdbusserver.c
index 6a84e75..a50b958 100644
--- a/gio/gdbusserver.c
+++ b/gio/gdbusserver.c
@@ -504,8 +504,9 @@ g_dbus_server_new_sync (const gchar        *address,
  * g_dbus_server_get_client_address:
  * @server: A #GDBusServer.
  *
- * Gets a D-Bus address string that can be used by clients to connect
- * to @server.
+ * Gets a
+ * [D-Bus address](https://dbus.freedesktop.org/doc/dbus-specification.html#addresses)
+ * string that can be used by clients to connect to @server.
  *
  * Returns: A D-Bus address string. Do not free, the string is owned
  * by @server.