Add an example to the docs.

Fri Sep 17 11:20:03 2004  Jonathan Blandford  <jrb@gnome.org>

        * gtk/gtklabel.c (gtk_label_set_markup): Add an example to the
        docs.

8 files changed, 52 insertions, 7 deletions

diff --git a/ChangeLog b/ChangeLog
index fbb87839fc..5df425c9f5 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,8 @@
+Fri Sep 17 11:20:03 2004  Jonathan Blandford  <jrb@gnome.org>
+
+	* gtk/gtklabel.c (gtk_label_set_markup): Add an example to the
+	docs.
+
 Thu Sep 16 23:20:05 2004  Matthias Clasen  <maclas@gmx.de>
 
 	* gtk/gtkselection.c (selection_get_text_plain): 
diff --git a/ChangeLog.pre-2-10 b/ChangeLog.pre-2-10
index fbb87839fc..5df425c9f5 100644
--- a/ChangeLog.pre-2-10
+++ b/ChangeLog.pre-2-10
@@ -1,3 +1,8 @@
+Fri Sep 17 11:20:03 2004  Jonathan Blandford  <jrb@gnome.org>
+
+	* gtk/gtklabel.c (gtk_label_set_markup): Add an example to the
+	docs.
+
 Thu Sep 16 23:20:05 2004  Matthias Clasen  <maclas@gmx.de>
 
 	* gtk/gtkselection.c (selection_get_text_plain): 
diff --git a/ChangeLog.pre-2-6 b/ChangeLog.pre-2-6
index fbb87839fc..5df425c9f5 100644
--- a/ChangeLog.pre-2-6
+++ b/ChangeLog.pre-2-6
@@ -1,3 +1,8 @@
+Fri Sep 17 11:20:03 2004  Jonathan Blandford  <jrb@gnome.org>
+
+	* gtk/gtklabel.c (gtk_label_set_markup): Add an example to the
+	docs.
+
 Thu Sep 16 23:20:05 2004  Matthias Clasen  <maclas@gmx.de>
 
 	* gtk/gtkselection.c (selection_get_text_plain): 
diff --git a/ChangeLog.pre-2-8 b/ChangeLog.pre-2-8
index fbb87839fc..5df425c9f5 100644
--- a/ChangeLog.pre-2-8
+++ b/ChangeLog.pre-2-8
@@ -1,3 +1,8 @@
+Fri Sep 17 11:20:03 2004  Jonathan Blandford  <jrb@gnome.org>
+
+	* gtk/gtklabel.c (gtk_label_set_markup): Add an example to the
+	docs.
+
 Thu Sep 16 23:20:05 2004  Matthias Clasen  <maclas@gmx.de>
 
 	* gtk/gtkselection.c (selection_get_text_plain): 
diff --git a/docs/reference/gtk/tmpl/gtklabel.sgml b/docs/reference/gtk/tmpl/gtklabel.sgml
index 2d3149e2c7..1853bbaa75 100644
--- a/docs/reference/gtk/tmpl/gtklabel.sgml
+++ b/docs/reference/gtk/tmpl/gtklabel.sgml
@@ -83,11 +83,11 @@ linkend="PangoMarkupFormat">complete documentation</link> of available
 tags in the Pango manual.)
 </para>
 <para>
-The markup passed to gtk_label_set_markup() must be valid; for
-example, literal &lt;/&gt;/&amp; characters must be escaped as 
-&amp;lt;, &amp;gt;, and &amp;amp;. If you pass text obtained from 
-the user, file, or a network to gtk_label_set_markup(), 
-you'll want to escape it with g_markup_escape_text().
+The markup passed to gtk_label_set_markup() must be valid; for example,
+literal &lt;/&gt;/&amp; characters must be escaped as &amp;lt;,
+&amp;gt;, and &amp;amp;. If you pass text obtained from the user, file,
+or a network to gtk_label_set_markup(), you'll want to escape it with
+g_markup_escape_text() or g_markup_printf_escaped().
 </para>
 <para>
 Markup strings are just a convenient way to set the #PangoAttrList on
diff --git a/docs/reference/gtk/tmpl/gtkrange.sgml b/docs/reference/gtk/tmpl/gtkrange.sgml
index ea7f8c4440..8020434a35 100644
--- a/docs/reference/gtk/tmpl/gtkrange.sgml
+++ b/docs/reference/gtk/tmpl/gtkrange.sgml
@@ -28,6 +28,16 @@ Base class for widgets which visualize an adjustment
 @range: the object which received the signal.
 @arg1: 
 
+<!-- ##### SIGNAL GtkRange::change-value ##### -->
+<para>
+
+</para>
+
+@range: the object which received the signal.
+@arg1: 
+@arg2: 
+@Returns: 
+
 <!-- ##### SIGNAL GtkRange::move-slider ##### -->
 <para>
 Virtual function that moves the slider. Used for keybindings.
diff --git a/docs/reference/gtk/tmpl/gtksettings.sgml b/docs/reference/gtk/tmpl/gtksettings.sgml
index ee6f0c5dcd..d13f54866a 100644
--- a/docs/reference/gtk/tmpl/gtksettings.sgml
+++ b/docs/reference/gtk/tmpl/gtksettings.sgml
@@ -110,6 +110,11 @@ Sharing settings between applications
 
 </para>
 
+<!-- ##### ARG GtkSettings:gtk-modules ##### -->
+<para>
+
+</para>
+
 <!-- ##### ARG GtkSettings:gtk-split-cursor ##### -->
 <para>
 
diff --git a/gtk/gtklabel.c b/gtk/gtklabel.c
index 900668a0a0..0f7befa383 100644
--- a/gtk/gtklabel.c
+++ b/gtk/gtklabel.c
@@ -1122,8 +1122,18 @@ set_markup (GtkLabel    *label,
  * @label: a #GtkLabel
  * @str: a markup string (see <link linkend="PangoMarkupFormat">Pango markup format</link>)
  * 
- * Parses @str which is marked up with the <link linkend="PangoMarkupFormat">Pango text markup language</link>,
- * setting the label's text and attribute list based on the parse results.
+ * Parses @str which is marked up with the <link
+ * linkend="PangoMarkupFormat">Pango text markup language</link>, setting the
+ * label's text and attribute list based on the parse results.  If the @str is
+ * external data, you may need to escape it with g_markup_escape_text() or
+ * g_markup_printf_escaped()<!-- -->:
+ * <informalexample><programlisting>
+ * char *markup;
+ * <!-- -->
+ * markup = g_markup_printf_escaped ("&lt;span style=\"italic\"&gt;%s&lt;/span&gt;", str);
+ * gtk_label_set_markup (GTK_LABEL (label), markup);
+ * g_free (markup);
+ * </programlisting></informalexample>
  **/
 void
 gtk_label_set_markup (GtkLabel    *label,