summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorMatthias Clasen <mclasen@redhat.com>2007-11-26 16:48:21 +0000
committerMatthias Clasen <matthiasc@src.gnome.org>2007-11-26 16:48:21 +0000
commit259244deda436f67784b1e33a7a108f13a20e3cf (patch)
tree9d3c827059f0692d04c3abeca89fa1d1ddc3fa37 /docs
parent643e4f3d0eb87e5f6a48512c9afe17e118f507d3 (diff)
downloadgtk+-259244deda436f67784b1e33a7a108f13a20e3cf.tar.gz
Add a note about hook setup. (#425004, Emmanuele Bassi)
2007-11-26 Matthias Clasen <mclasen@redhat.com> * gtk/gtkaboutdialog.c (gtk_about_dialog_set_website): Add a note about hook setup. (#425004, Emmanuele Bassi) svn path=/trunk/; revision=19050
Diffstat (limited to 'docs')
-rw-r--r--docs/reference/ChangeLog5
-rw-r--r--docs/reference/gtk/tmpl/gtkaboutdialog.sgml13
2 files changed, 18 insertions, 0 deletions
diff --git a/docs/reference/ChangeLog b/docs/reference/ChangeLog
index 60d4a913f1..f27d5c06f0 100644
--- a/docs/reference/ChangeLog
+++ b/docs/reference/ChangeLog
@@ -1,3 +1,8 @@
+2007-11-26 Matthias Clasen <mclasen@redhat.com>
+
+ * gtk/tmpl/gtkaboutdialog.sgml: Add note about hook setup
+ to the introduction.
+
2007-11-25 Matthias Clasen <mclasen@redhat.com>
* gtk/tmpl/gtkdialog.sgml: Move signal docs inline.
diff --git a/docs/reference/gtk/tmpl/gtkaboutdialog.sgml b/docs/reference/gtk/tmpl/gtkaboutdialog.sgml
index 4cb3fb7fc5..ebecec0b4e 100644
--- a/docs/reference/gtk/tmpl/gtkaboutdialog.sgml
+++ b/docs/reference/gtk/tmpl/gtkaboutdialog.sgml
@@ -23,6 +23,19 @@ authors, documenters and artists properties are recognized by looking for
recognized by looking for <literal>http://url</literal>, with
<literal>url</literal> extending to the next space, tab or line break.
</para>
+<para id="gtk-about-dialog-hook-setup">
+When setting the website and email hooks for the #GtkAboutDialog widget,
+you should remember that the order is important: you should set the hook
+functions before setting the website and email URL properties, like this:
+</para>
+<informalexample><programlisting>
+gtk_about_dialog_set_url_hook (GTK_ABOUT_DIALOG (dialog), launch_url, NULL, NULL);
+gtk_about_dialog_set_website (GTK_ABOUT_DIALOG (dialog), app_url);
+</programlisting></informalexample>
+<para>
+Otherwise the GtkAboutDialog widget will not display the website and the
+email addresses as clickable.
+</para>
<para>
To make constructing a #GtkAboutDialog as convenient as possible, you can
use the function gtk_show_about_dialog() which constructs and shows a dialog