Docs: Big entity cleanup

Strip lots of entity use from |[ ]| examples (which are now
implicit CDATA). Also remove many redundant uses of <!-- -->.
This commit is contained in:
Matthias Clasen
2014-02-01 11:57:13 -05:00
parent 6972264c7d
commit 42cf80780b
38 changed files with 163 additions and 158 deletions

View File

@@ -49,10 +49,10 @@
* enumerator = g_socket_connectable_enumerate (addr);
* g_object_unref (addr);
*
* /<!-- -->* 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).
* *<!-- -->/
* /&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;/
* while (!conn && (sockaddr = g_socket_address_enumerator_next (enumerator, cancellable, error))
* {
* conn = connect_to_sockaddr (sockaddr, conn_error ? NULL : &conn_error);
@@ -64,18 +64,18 @@
* {
* if (conn_error)
* {
* /<!-- -->* We couldn't connect to the first address, but we succeeded
* * in connecting to a later address.
* *<!-- -->/
* /&ast; We couldn't connect to the first address, but we succeeded
* &ast; in connecting to a later address.
* &ast;/
* g_error_free (conn_error);
* }
* return conn;
* }
* else if (error)
* {
* /<!-- -->* Either the initial lookup failed, or else the caller
* * cancelled us.
* *<!-- -->/
* /&ast; Either the initial lookup failed, or else the caller
* &ast; cancelled us.
* &ast;/
* if (conn_error)
* g_error_free (conn_error);
* return NULL;
@@ -125,7 +125,7 @@ g_socket_connectable_enumerate (GSocketConnectable *connectable)
* @connectable: a #GSocketConnectable
*
* Creates a #GSocketAddressEnumerator for @connectable that will
* return #GProxyAddress<!-- -->es for addresses that you must connect
* return #GProxyAddresses for addresses that you must connect
* to via a proxy.
*
* If @connectable does not implement