add more docs

pinos/client/pinos.c

@@ -53,6 +53,12 @@ pinos_client_name (void)
     return g_strdup_printf ("pinos-pid-%lu", (gulong) getpid ());
 }
 
+/**
+ * pinos_fill_context_properties:
+ * @properties: a #PinosProperties
+ *
+ * Fill @properties with a set of default context properties.
+ */
 void
 pinos_fill_context_properties (PinosProperties *properties)
 {
@@ -87,6 +93,12 @@ pinos_fill_context_properties (PinosProperties *properties)
   }
 }
 
+/**
+ * pinos_fill_stream_properties
+ * @properties: a #PinosProperties
+ *
+ * Fill @properties with a set of default stream properties.
+ */
 void
 pinos_fill_stream_properties (PinosProperties *properties)
 {

pinos/client/subscribe.c

@@ -742,6 +742,22 @@ compare_data (PinosObjectData *data,
   return g_strcmp0 (data->interface_name, interface_name);
 }
 
+/**
+ * pinos_subscribe_get_proxy:
+ * @subscribe: a #PinosSubscribe
+ * @name: the owner name
+ * @object_path: the object path
+ * @interface_name: the interface name
+ * @cancellable: a #GCancellable
+ * @callback: a #GAsyncReadyCallback
+ * @user_data: extra user data
+ *
+ * Asyncronously get a #GDBusProxy for the object with the given
+ * @name/@object_path/@interface.
+ *
+ * Use pinos_subscribe_get_proxy_finish() to get the result or error in
+ * @callback.
+ */
 void
 pinos_subscribe_get_proxy (PinosSubscribe      *subscribe,
                            const gchar         *name,
@@ -780,6 +796,18 @@ pinos_subscribe_get_proxy (PinosSubscribe      *subscribe,
   }
 }
 
+/**
+ * pinos_subscribe_get_proxy_finish:
+ * @subscribe: a #PinosSubscribe
+ * @res: a #GAsyncResult
+ * @error: a #GError or %NULL
+ *
+ * Get the requested #GDBusProxy. This function should be called in the callback
+ * of pinos_subscribe_get_proxy() to get the result or error.
+ *
+ * Returns: the requested #GDBusProxy. If %NULL is returned, @error will
+ *          be set.
+ */
 GDBusProxy *
 pinos_subscribe_get_proxy_finish (PinosSubscribe *subscribe,
                                   GAsyncResult   *res,