minor EggDBusNameTracker cleanups

1 files changed, 14 insertions, 19 deletions

diff --git a/src/eggdbus/eggdbusbusnametracker.c b/src/eggdbus/eggdbusbusnametracker.c
index 878f292..05565c2 100644
--- a/src/eggdbus/eggdbusbusnametracker.c
+++ b/src/eggdbus/eggdbusbusnametracker.c
@@ -37,10 +37,9 @@
  * The #EggDBusBusNameTracker class is used for tracking bus names on a
  * message bus.
  *
- * If you are writing a D-Bus client there's no need to use this class
- * as it's being used internally by #EggDBusConnection to maintain
- * the #EggDBusObjectProxy:name-owner property on the proxy objects it
- * manages.
+ * If you are writing a D-Bus client there's no need to use this class as it's used
+ * internally by #EggDBusConnection to maintain the #EggDBusObjectProxy:name-owner property
+ * on object proxies.
  */
 
 typedef struct
@@ -363,7 +362,7 @@ egg_dbus_bus_name_tracker_class_init (EggDBusBusNameTrackerClass *klass)
 
 /**
  * egg_dbus_bus_name_tracker_new:
- * @bus: A #EggDBusBus object that represents a D-Bus message bus daemon.
+ * @bus: A #EggDBusBus object that represents a message bus daemon.
  *
  * Creates a new bus name tracker for @bus.
  *
@@ -504,7 +503,7 @@ add_match_rule_cb (EggDBusBus     *bus,
  * @bus_name_tracker: A #EggDBusBusNameTracker.
  * @bus_name: A unique or well-known name.
  *
- * Start watching @bus_name.
+ * Starts watching @bus_name.
  *
  * This function can be called multiple times for the same name;
  * @bus_name_tracker internally maintains a count of watchers for each
@@ -562,7 +561,7 @@ egg_dbus_bus_name_tracker_watch_bus_name (EggDBusBusNameTracker *bus_name_tracke
  * @bus_name_tracker: A #EggDBusBusNameTracker.
  * @bus_name: A name being watched.
  *
- * Stop watching @bus_name.
+ * Stops watching @bus_name.
  *
  * This function can be called multiple times for the same name;
  * @bus_name_tracker internally maintains a count of watchers for each
@@ -599,11 +598,10 @@ egg_dbus_bus_name_tracker_stop_watching_bus_name (EggDBusBusNameTracker *bus_nam
  * @bus_name_tracker: A #EggDBusBusNameTracker.
  * @bus_name: A name being watched.
  *
- * Checks if information has been retrieved for @bus_name. Typically,
- * if this function returs %FALSE, one would connect to the
- * #EggDBusBusNameTracker::bus-name-has-info signal and then use
- * e.g. egg_dbus_bus_name_tracker_get_owner_for_bus_name() to retrieve
- * the owner.
+ * Checks if information has been retrieved for @bus_name. If this function returns %FALSE, you can
+ * connect to the #EggDBusBusNameTracker::bus-name-has-info signal and use
+ * egg_dbus_bus_name_tracker_get_owner_for_bus_name() to retrieve the owner when information is
+ * available.
  *
  * Returns: %TRUE if @bus_name_tracker has information about @bus_name.
  **/
@@ -633,14 +631,11 @@ egg_dbus_bus_name_tracker_has_info_for_bus_name (EggDBusBusNameTracker  *bus_nam
  *
  * Gets owner of @bus_name.
  *
- * If @bus_name_tracker recently started watching @bus_name, a call to
- * egg_dbus_bus_invoke_get_name_owner_async() call may be still be
- * pending. This function will block in a main loop until the owner is
- * resolved.
+ * If @bus_name_tracker recently started watching @bus_name, a call to egg_dbus_bus_invoke_get_name_owner()
+ * call may be still be pending. This function will block in a main loop until the owner is resolved.
  *
- * If this synchronous behavior is not desired, use call
- * egg_dbus_bus_name_tracker_has_info_for_bus_name() and connect to the
- * #EggDBusBusNameTracker::bus-name-has-info signal to get informed when
+ * If this synchronous behavior is not desired, use call egg_dbus_bus_name_tracker_has_info_for_bus_name()
+ * and connect to the #EggDBusBusNameTracker::bus-name-has-info signal to get informed when
  * owner information is available.
  *
  * Returns: The owner of @bus_name or %NULL if there is no owner. Free