Commit 5baa0f2a authored by Matthias Clasen's avatar Matthias Clasen

Stop using <para> for ids

Instead, use the id support in markdown headings.
parent 4ec31481
...@@ -102,14 +102,15 @@ ...@@ -102,14 +102,15 @@
* always called, even in the case of a cancelled operation. On cancellation * always called, even in the case of a cancelled operation. On cancellation
* the result is a %G_IO_ERROR_CANCELLED error. * the result is a %G_IO_ERROR_CANCELLED error.
* *
* <para id="io-priority"> * ## I/O Priority # {#io-priority}
*
* Many I/O-related asynchronous operations have a priority parameter, * Many I/O-related asynchronous operations have a priority parameter,
* which is used in certain cases to determine the order in which * which is used in certain cases to determine the order in which
* operations are executed. They are not used to determine system-wide * operations are executed. They are not used to determine system-wide
* I/O scheduling. Priorities are integers, with lower numbers indicating * I/O scheduling. Priorities are integers, with lower numbers indicating
* higher priority. It is recommended to choose priorities between * higher priority. It is recommended to choose priorities between
* %G_PRIORITY_LOW and %G_PRIORITY_HIGH, with %G_PRIORITY_DEFAULT * %G_PRIORITY_LOW and %G_PRIORITY_HIGH, with %G_PRIORITY_DEFAULT
* as a default.</para> * as a default.
*/ */
typedef GAsyncResultIface GAsyncResultInterface; typedef GAsyncResultIface GAsyncResultInterface;
......
...@@ -137,7 +137,8 @@ ...@@ -137,7 +137,8 @@
* <member>g_file_eject_mountable_with_operation() to eject a mountable file.</member> * <member>g_file_eject_mountable_with_operation() to eject a mountable file.</member>
* </simplelist> * </simplelist>
* *
* <para id="gfile-etag"> * ## Entity Tags # {#gfile-etag}
*
* One notable feature of #GFiles are entity tags, or "etags" for * One notable feature of #GFiles are entity tags, or "etags" for
* short. Entity tags are somewhat like a more abstract version of the * short. Entity tags are somewhat like a more abstract version of the
* traditional mtime, and can be used to quickly determine if the file * traditional mtime, and can be used to quickly determine if the file
...@@ -145,8 +146,7 @@ ...@@ -145,8 +146,7 @@
* HTTP 1.1 * HTTP 1.1
* [specification](http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html) * [specification](http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html)
* for HTTP Etag headers, which are a very similar concept. * for HTTP Etag headers, which are a very similar concept.
* </para> */
**/
static void g_file_real_query_info_async (GFile *file, static void g_file_real_query_info_async (GFile *file,
const char *attributes, const char *attributes,
......
...@@ -57,7 +57,8 @@ ...@@ -57,7 +57,8 @@
* successfully. If an @error is present when g_volume_mount_finish() * successfully. If an @error is present when g_volume_mount_finish()
* is called, then it will be filled with any error information. * is called, then it will be filled with any error information.
* *
* <para id="volume-identifier"> * ## Volume Identifiers # {#volume-identifier}
*
* It is sometimes necessary to directly access the underlying * It is sometimes necessary to directly access the underlying
* operating system object behind a volume (e.g. for passing a volume * operating system object behind a volume (e.g. for passing a volume
* to an application via the commandline). For this purpose, GIO * to an application via the commandline). For this purpose, GIO
...@@ -67,7 +68,7 @@ ...@@ -67,7 +68,7 @@
* strings as names for the different kinds of identifiers: * strings as names for the different kinds of identifiers:
* #G_VOLUME_IDENTIFIER_KIND_HAL_UDI, #G_VOLUME_IDENTIFIER_KIND_LABEL, etc. * #G_VOLUME_IDENTIFIER_KIND_HAL_UDI, #G_VOLUME_IDENTIFIER_KIND_LABEL, etc.
* Use g_volume_get_identifier() to obtain an identifier for a volume. * Use g_volume_get_identifier() to obtain an identifier for a volume.
* </para> *
* *
* Note that #G_VOLUME_IDENTIFIER_KIND_HAL_UDI will only be available * Note that #G_VOLUME_IDENTIFIER_KIND_HAL_UDI will only be available
* when the gvfs hal volume monitor is in use. Other volume monitors * when the gvfs hal volume monitor is in use. Other volume monitors
......
...@@ -70,7 +70,8 @@ ...@@ -70,7 +70,8 @@
* explicitly include `&lt;glib/gprintf.h&gt;` in order to use the GLib * explicitly include `&lt;glib/gprintf.h&gt;` in order to use the GLib
* printf() functions. * printf() functions.
* *
* <para id="string-precision"> * ## String precision pitfalls # {#string-precision}
*
* While you may use the printf() functions to format UTF-8 strings, * While you may use the printf() functions to format UTF-8 strings,
* notice that the precision of a &percnt;Ns parameter is interpreted * notice that the precision of a &percnt;Ns parameter is interpreted
* as the number of bytes, not characters to print. On top of that, * as the number of bytes, not characters to print. On top of that,
...@@ -83,7 +84,6 @@ ...@@ -83,7 +84,6 @@
* certain number of columns, then &percnt;Ns is not a correct solution * certain number of columns, then &percnt;Ns is not a correct solution
* anyway, since it fails to take wide characters (see g_unichar_iswide()) * anyway, since it fails to take wide characters (see g_unichar_iswide())
* into account. * into account.
* </para>
*/ */
/** /**
......
...@@ -46,7 +46,8 @@ ...@@ -46,7 +46,8 @@
* support. Signals are described in detail in <xref * support. Signals are described in detail in <xref
* linkend="gobject-Signals"/>. * linkend="gobject-Signals"/>.
* *
* <para id="floating-ref"> * ## Floating references # {#floating-ref}
*
* GInitiallyUnowned is derived from GObject. The only difference between * GInitiallyUnowned is derived from GObject. The only difference between
* the two is that the initial reference of a GInitiallyUnowned is flagged * the two is that the initial reference of a GInitiallyUnowned is flagged
* as a "floating" reference. This means that it is not specifically * as a "floating" reference. This means that it is not specifically
...@@ -78,7 +79,6 @@ ...@@ -78,7 +79,6 @@
* language bindings that provide automated reference and memory ownership * language bindings that provide automated reference and memory ownership
* maintenance (such as smart pointers or garbage collection) should not * maintenance (such as smart pointers or garbage collection) should not
* expose floating references in their API. * expose floating references in their API.
* </para>
* *
* Some object implementations may need to save an objects floating state * Some object implementations may need to save an objects floating state
* across certain code portions (an example is #GtkMenu), to achieve this, * across certain code portions (an example is #GtkMenu), to achieve this,
......
...@@ -39,13 +39,13 @@ ...@@ -39,13 +39,13 @@
* #GParamSpec is an object structure that encapsulates the metadata * #GParamSpec is an object structure that encapsulates the metadata
* required to specify parameters, such as e.g. #GObject properties. * required to specify parameters, such as e.g. #GObject properties.
* *
* <para id="canonical-parameter-name"> * ## Parameter names # {#canonical-parameter-names}
* Parameter names need to start with a letter (a-z or A-Z). Subsequent *
* characters can be letters, numbers or a '-'. * Parameter names need to start with a letter (a-z or A-Z).
* Subsequent characters can be letters, numbers or a '-'.
* All other characters are replaced by a '-' during construction. * All other characters are replaced by a '-' during construction.
* The result of this replacement is called the canonical name of the * The result of this replacement is called the canonical name of
* parameter. * the parameter.
* </para>
*/ */
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment