From 259244deda436f67784b1e33a7a108f13a20e3cf Mon Sep 17 00:00:00 2001 From: Matthias Clasen Date: Mon, 26 Nov 2007 16:48:21 +0000 Subject: [PATCH] Add a note about hook setup. (#425004, Emmanuele Bassi) 2007-11-26 Matthias Clasen * gtk/gtkaboutdialog.c (gtk_about_dialog_set_website): Add a note about hook setup. (#425004, Emmanuele Bassi) svn path=/trunk/; revision=19050 --- ChangeLog | 5 +++++ docs/reference/ChangeLog | 5 +++++ docs/reference/gtk/tmpl/gtkaboutdialog.sgml | 13 +++++++++++++ gtk/gtkaboutdialog.c | 3 +++ 4 files changed, 26 insertions(+) diff --git a/ChangeLog b/ChangeLog index fc871de6f1..dabcc8e15e 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,8 @@ +2007-11-26 Matthias Clasen + + * gtk/gtkaboutdialog.c (gtk_about_dialog_set_website): Add a note + about hook setup. (#425004, Emmanuele Bassi) + 2007-11-26 Tor Lillqvist * gdk/win32/gdkwindow-win32.c (gdk_window_fullscreen): Use the 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 + + * gtk/tmpl/gtkaboutdialog.sgml: Add note about hook setup + to the introduction. + 2007-11-25 Matthias Clasen * 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 http://url, with url extending to the next space, tab or line break. + +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: + + +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); + + +Otherwise the GtkAboutDialog widget will not display the website and the +email addresses as clickable. + To make constructing a #GtkAboutDialog as convenient as possible, you can use the function gtk_show_about_dialog() which constructs and shows a dialog diff --git a/gtk/gtkaboutdialog.c b/gtk/gtkaboutdialog.c index 8af1c1b2d6..540546aab7 100644 --- a/gtk/gtkaboutdialog.c +++ b/gtk/gtkaboutdialog.c @@ -1125,6 +1125,9 @@ gtk_about_dialog_get_website (GtkAboutDialog *about) * * Sets the URL to use for the website link. * + * Note that that the hook functions need to be set up + * before calling this function. + * * Since: 2.6 **/ void