diff options
author | Havoc Pennington <hp@redhat.com> | 2006-10-21 18:51:30 +0000 |
---|---|---|
committer | Havoc Pennington <hp@redhat.com> | 2006-10-21 18:51:30 +0000 |
commit | fed8880c6f718b9f06e589d1769494a47b395c0d (patch) | |
tree | 2b23ebea23118bf6bb48ccd6da808c6490465546 /dbus/dbus-address.c | |
parent | e19ebac55d671ecd92877af182300311afa7641a (diff) |
2006-10-21 Havoc Pennington <hp@redhat.com>
* Document a bunch of undocumented stuff
Diffstat (limited to 'dbus/dbus-address.c')
-rw-r--r-- | dbus/dbus-address.c | 16 |
1 files changed, 13 insertions, 3 deletions
diff --git a/dbus/dbus-address.c b/dbus/dbus-address.c index d92209d9..bb2a5899 100644 --- a/dbus/dbus-address.c +++ b/dbus/dbus-address.c @@ -214,7 +214,9 @@ create_entry (void) } /** - * Returns the method string of an address entry. + * Returns the method string of an address entry. For example, given + * the address entry "tcp:host=example.com" it would return the string + * "tcp" * * @param entry the entry. * @returns a string describing the method. This string @@ -227,8 +229,12 @@ dbus_address_entry_get_method (DBusAddressEntry *entry) } /** - * Returns a value from a key of an entry. + * Returns a value from a key of an entry. For example, + * given the address "tcp:host=example.com,port=8073" if you asked + * for the key "host" you would get the value "example.com" * + * The returned value is already unescaped. + * * @param entry the entry. * @param key the key. * @returns the key value. This string must not be freed. @@ -342,6 +348,9 @@ append_unescaped_value (DBusString *unescaped, * method:key=value,key=value;method:key=value * * See the D-Bus specification for complete docs on the format. + * + * When connecting to an address, the first address entries + * in the semicolon-separated list should be tried first. * * @param address the address. * @param entry return location to an array of entries. @@ -589,7 +598,8 @@ dbus_address_escape_value (const char *value) /** * Unescapes the given string as a value in a key=value pair - * for a D-Bus address. + * for a D-Bus address. Note that dbus_address_entry_get_value() + * returns an already-unescaped value. * * @param value the escaped value * @param error error to set if the unescaping fails |