1
2@c %start of fragment
3
4@node GtkAboutDialog
5@chapter GtkAboutDialog
6Display information about an application
7
8@section Overview
9The @code{<gtk-about-dialog>} offers a simple way to display information about a
10program like its logo, name, copyright, website and license. It is also possible
11to give credits to the authors, documenters, translators and artists who have
12worked on the program. An about dialog is typically opened when the user selects
13the @samp{About} option from the @samp{Help} menu. All parts of the dialog are
14optional.
15
16About dialog often contain links and email addresses. @code{<gtk-about-dialog>}
17supports this by offering global hooks, which are called when the user clicks on
18a link or email address, see @code{gtk-about-dialog-set-email-hook} and
19@code{gtk-about-dialog-set-url-hook}. Email addresses in the authors,
20documenters and artists properties are recognized by looking for
21@samp{<user@@host>}, URLs are recognized by looking for @samp{http://url}, with
22@samp{url} extending to the next space, tab or line break.
23
24To make constructing a @code{<gtk-about-dialog>} as convenient as possible, you
25can use the function @code{gtk-show-about-dialog} which constructs and shows a
26dialog and keeps it around so that it can be shown again.
27
28@section Usage
29@include defuns-gtkaboutdialog.xml.texi
30
31@c %end of fragment
32