Stop using <para> for ids

Instead, use the id support in markdown headings.
This commit is contained in:
Matthias Clasen
2014-02-06 16:48:49 -05:00
parent 4ec314812e
commit 5baa0f2af5
6 changed files with 19 additions and 17 deletions

View File

@@ -46,7 +46,8 @@
* support. Signals are described in detail in <xref
* linkend="gobject-Signals"/>.
*
* <para id="floating-ref">
* ## Floating references # {#floating-ref}
*
* GInitiallyUnowned is derived from GObject. The only difference between
* the two is that the initial reference of a GInitiallyUnowned is flagged
* as a "floating" reference. This means that it is not specifically
@@ -78,7 +79,6 @@
* language bindings that provide automated reference and memory ownership
* maintenance (such as smart pointers or garbage collection) should not
* expose floating references in their API.
* </para>
*
* Some object implementations may need to save an objects floating state
* across certain code portions (an example is #GtkMenu), to achieve this,

View File

@@ -39,13 +39,13 @@
* #GParamSpec is an object structure that encapsulates the metadata
* required to specify parameters, such as e.g. #GObject properties.
*
* <para id="canonical-parameter-name">
* Parameter names need to start with a letter (a-z or A-Z). Subsequent
* characters can be letters, numbers or a '-'.
* ## 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 '-'.
* All other characters are replaced by a '-' during construction.
* The result of this replacement is called the canonical name of the
* parameter.
* </para>
* The result of this replacement is called the canonical name of
* the parameter.
*/