cleanup

[platform/upstream/glib.git] / gio / gsocketconnectable.c

diff --git a/gio/gsocketconnectable.c b/gio/gsocketconnectable.c
index e51cf81..79901aa 100644 (file)
--- a/gio/gsocketconnectable.c
+++ b/gio/gsocketconnectable.c
@@ -32,7 +32,7 @@
  * to try out each socket address in turn until one succeeds, as shown
  * in the sample code below.
  *
- * |[
+ * |[<!-- language="C" -->
  * MyConnectionType *
  * connect_to_host (const char    *hostname,
  *                  guint16        port,
@@ -49,10 +49,9 @@
  *   enumerator = g_socket_connectable_enumerate (addr);
  *   g_object_unref (addr);
  *
- *   /&ast; Try each sockaddr until we succeed. Record the first
- *    &ast; connection error, but not any further ones (since they'll probably
- *    &ast; be basically the same as the first).
- *    &ast;/
+ *   // Try each sockaddr until we succeed. Record the first connection error,
+ *   // but not any further ones (since they'll probably be basically the same
+ *   // as the first).
  *   while (!conn && (sockaddr = g_socket_address_enumerator_next (enumerator, cancellable, error))
  *     {
  *       conn = connect_to_sockaddr (sockaddr, conn_error ? NULL : &conn_error);
@@ -64,18 +63,15 @@
  *     {
  *       if (conn_error)
  *         {
- *           /&ast; We couldn't connect to the first address, but we succeeded
- *            &ast; in connecting to a later address.
- *            &ast;/
+ *           // We couldn't connect to the first address, but we succeeded
+ *           // in connecting to a later address.
  *           g_error_free (conn_error);
  *         }
  *       return conn;
  *     }
  *   else if (error)
  *     {
- *       /&ast; Either the initial lookup failed, or else the caller
- *        &ast; cancelled us.
- *        &ast;/
+ *       /// Either initial lookup failed, or else the caller cancelled us.
  *       if (conn_error)
  *         g_error_free (conn_error);
  *       return NULL;
@@ -104,7 +100,7 @@ g_socket_connectable_default_init (GSocketConnectableInterface *iface)
  *
  * Creates a #GSocketAddressEnumerator for @connectable.
  *
- * Return value: (transfer full): a new #GSocketAddressEnumerator.
+ * Returns: (transfer full): a new #GSocketAddressEnumerator.
  *
  * Since: 2.22
  */
@@ -132,7 +128,7 @@ g_socket_connectable_enumerate (GSocketConnectable *connectable)
  * g_socket_connectable_proxy_enumerate(), this will fall back to
  * calling g_socket_connectable_enumerate().
  *
- * Return value: (transfer full): a new #GSocketAddressEnumerator.
+ * Returns: (transfer full): a new #GSocketAddressEnumerator.
  *
  * Since: 2.26
  */