[gtk+] docs: don't use <tag> docbook elements
- From: William Jon McCann <mccann src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [gtk+] docs: don't use <tag> docbook elements
- Date: Wed, 5 Feb 2014 00:10:25 +0000 (UTC)
commit 6ba5e6bb1acd161f0b81ae27e60afb37afc747a8
Author: William Jon McCann <william jon mccann gmail com>
Date: Tue Feb 4 17:38:09 2014 -0500
docs: don't use <tag> docbook elements
gtk/gtkapplicationwindow.c | 14 +++++++-------
gtk/gtklabel.c | 3 ++-
gtk/gtkoverlay.c | 2 +-
gtk/gtkwindow.c | 6 +++---
4 files changed, 13 insertions(+), 12 deletions(-)
---
diff --git a/gtk/gtkapplicationwindow.c b/gtk/gtkapplicationwindow.c
index ba99356..6ee95b1 100644
--- a/gtk/gtkapplicationwindow.c
+++ b/gtk/gtkapplicationwindow.c
@@ -111,16 +111,16 @@
* ]|
*
* The XML format understood by #GtkBuilder for #GMenuModel consists
- * of a toplevel <tag class="starttag">menu</tag> element, which contains
- * one or more <tag class="starttag">item</tag> elements. Each
- * <tag class="starttag">item</tag> element contains
- * <tag class="starttag">attribute</tag> and <tag class="starttag">link</tag>
+ * of a toplevel `<menu>` element, which contains
+ * one or more `<item>` elements. Each
+ * `<item>` element contains
+ * `<attribute>` and `<link>`
* elements with a mandatory name attribute.
- * <tag class="starttag">link</tag> elements have the same content
- * model as <tag class="starttag">menu</tag>.
+ * `<link>` elements have the same content
+ * model as `<menu>`.
*
* Attribute values can be translated using gettext, like other #GtkBuilder
- * content. <tag class="starttag">attribute</tag> elements can be marked for
+ * content. `<attribute>` elements can be marked for
* translation with a <literal>translatable="yes"</literal> attribute.
* It is also possible to specify message context and translator comments,
* using the context and comments attributes. To make use of this, the
diff --git a/gtk/gtklabel.c b/gtk/gtklabel.c
index ab769f1..6ca271c 100644
--- a/gtk/gtklabel.c
+++ b/gtk/gtklabel.c
@@ -200,11 +200,12 @@
*
* Since 2.18, GTK+ supports markup for clickable hyperlinks in addition
* to regular Pango markup. The markup for links is borrowed from HTML, using the
- * <tag>a</tag> with href and title attributes. GTK+ renders links similar to the
+ * `<a>` with href and title attributes. GTK+ renders links similar to the
* way they appear in web browsers, with colored, underlined text. The title
* attribute is displayed as a tooltip on the link.
*
* An example looks like this:
+ *
* |[<!-- language="C" -->
* gtk_label_set_markup (label, "Go to the <a href="http://www.gtk.org" title="<i>Our</i>
website">GTK+ website</a> for more...");
* ]|
diff --git a/gtk/gtkoverlay.c b/gtk/gtkoverlay.c
index 4205153..084db86 100644
--- a/gtk/gtkoverlay.c
+++ b/gtk/gtkoverlay.c
@@ -50,7 +50,7 @@
*
* The GtkOverlay implementation of the GtkBuildable interface
* supports placing a child as an overlay by specifying "overlay" as
- * the "type" attribute of a <tag class="starttag">child</tag> element.
+ * the "type" attribute of a `<child>` element.
*/
struct _GtkOverlayPrivate
diff --git a/gtk/gtkwindow.c b/gtk/gtkwindow.c
index d70b74d..a0377ce 100644
--- a/gtk/gtkwindow.c
+++ b/gtk/gtkwindow.c
@@ -92,8 +92,8 @@
* ## GtkWindow as GtkBuildable
*
* The GtkWindow implementation of the GtkBuildable interface supports a
- * custom <tag class="starttag">accel-groups</tag> element, which supports
- * any number of <tag class="starttag">group</tag> elements representing the
+ * custom `<accel-groups>` element, which supports
+ * any number of `<group>` elements representing the
* #GtkAccelGroup objects you want to add to your window (synonymous with
* gtk_window_add_accel_group().
*
@@ -112,7 +112,7 @@
*
* The GtkWindow implementation of the GtkBuildable interface
* supports setting a child as the titlebar by specifying "titlebar" as
- * the "type" attribute of a <tag class="starttag">child</tag> element.
+ * the "type" attribute of a `<child>` element.
*/
#define MNEMONICS_DELAY 300 /* ms */
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]