Add some hints about titles on about dialogs

svn path=/trunk/; revision=17545

ChangeLog

@@ -1,3 +1,8 @@
+2007-03-19  Matthias Clasen <mclasen@redhat.com> 
+
+	* demos/gtk-demo/appwindow.c: Explicitly set the title on the
+	about dialog.
+
 2007-03-18  Matthias Clasen <mclasen@redhat.com> 
 
 	* gtk/gtkentrycompletion.c (gtk_entry_completion_compute_prefix):

demos/gtk-demo/appwindow.c

@@ -141,6 +141,7 @@ about_cb (GtkAction *action,
 			 "authors", authors,
 			 "documenters", documentors,
 			 "logo", transparent,
+                         "title", "About GTK+ Code Demos",
 			 NULL);
 
   g_object_unref (transparent);

docs/reference/ChangeLog

@@ -1,3 +1,8 @@
+2007-03-19  Matthias Clasen  <mclasen@redhat.com>
+
+	* tmpl/gtkaboutdialog.sgml: Add a paragraph about setting
+	the title on the dialog.
+
 2007-02-14  Stefan Kost  <ensonic@users.sf.net>
 
 	reviewed by: Matthias Clasen  <mclasen@redhat.com>

docs/reference/gtk/tmpl/gtkaboutdialog.sgml

@@ -28,6 +28,20 @@ To make constructing a #GtkAboutDialog as convenient as possible, you can
 use the function gtk_show_about_dialog() which constructs and shows a dialog 
 and keeps it around so that it can be shown again.
 </para>
+<para>
+Note that GTK+ sets a default title of <literal>_("About &percnt;s")</literal> 
+on the dialog window (where &percnt;s is replaced by the name of the 
+application, but in order to ensure proper translation of the title, 
+applications should set the title property explicitly when constructing 
+a #GtkAboutDialog, as shown in the following example:
+</para>
+<informalexample><programlisting>
+gtk_show_about_dialog (NULL, 
+                       "name", "ExampleCode",
+                       "logo", example_logo,
+                       "title" _("About ExampleCode"),
+                       NULL);
+</programlisting></informalexample>
 
 <!-- ##### SECTION See_Also ##### -->
 <para>