path: root/docs/reference/pygtk-gtkaboutdialog.xml

<?xml version="1.0" standalone="no"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
    "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">

<refentry id="class-gtkaboutdialog">
  <refnamediv>
    <refname>gtk.AboutDialog</refname>
    <refpurpose>popup window displaying information about an
application (new in PyGTK 2.6)</refpurpose>
  </refnamediv>

  <refsect1>
    <title>Synopsis</title>

<classsynopsis language="python">
  <ooclass><classname>gtk.AboutDialog</classname></ooclass>
  <ooclass><classname><link linkend="class-gtkdialog">gtk.Dialog</link></classname></ooclass>
<constructorsynopsis language="python">
    <methodname><link
linkend="constructor-gtkaboutdialog">gtk.AboutDialog</link></methodname>
    <methodparam></methodparam>
  </constructorsynopsis>
<methodsynopsis language="python">
    <methodname><link linkend="method-gtkaboutdialog--get-name">get_name</link></methodname>
    <methodparam></methodparam>
  </methodsynopsis><methodsynopsis language="python">
    <methodname><link linkend="method-gtkaboutdialog--set-name">set_name</link></methodname>
    <methodparam><parameter role="keyword">name</parameter></methodparam>
  </methodsynopsis><methodsynopsis language="python">
    <methodname><link linkend="method-gtkaboutdialog--get-program-name">get_program_name</link></methodname>
    <methodparam></methodparam>
  </methodsynopsis><methodsynopsis language="python">
    <methodname><link linkend="method-gtkaboutdialog--set-program-name">set_program_name</link></methodname>
    <methodparam><parameter role="keyword">name</parameter></methodparam>
  </methodsynopsis><methodsynopsis language="python">
    <methodname><link linkend="method-gtkaboutdialog--get-version">get_version</link></methodname>
    <methodparam></methodparam>
  </methodsynopsis><methodsynopsis language="python">
    <methodname><link linkend="method-gtkaboutdialog--set-version">set_version</link></methodname>
    <methodparam><parameter role="keyword">version</parameter></methodparam>
  </methodsynopsis><methodsynopsis language="python">
    <methodname><link linkend="method-gtkaboutdialog--get-copyright">get_copyright</link></methodname>
    <methodparam></methodparam>
  </methodsynopsis><methodsynopsis language="python">
    <methodname><link linkend="method-gtkaboutdialog--set-copyright">set_copyright</link></methodname>
    <methodparam><parameter role="keyword">copyright</parameter></methodparam>
  </methodsynopsis><methodsynopsis language="python">
    <methodname><link linkend="method-gtkaboutdialog--get-comments">get_comments</link></methodname>
    <methodparam></methodparam>
  </methodsynopsis><methodsynopsis language="python">
    <methodname><link linkend="method-gtkaboutdialog--set-comments">set_comments</link></methodname>
    <methodparam><parameter role="keyword">comments</parameter></methodparam>
  </methodsynopsis><methodsynopsis language="python">
    <methodname><link linkend="method-gtkaboutdialog--get-license">get_license</link></methodname>
    <methodparam></methodparam>
  </methodsynopsis><methodsynopsis language="python">
    <methodname><link linkend="method-gtkaboutdialog--set-license">set_license</link></methodname>
    <methodparam><parameter role="keyword">license</parameter></methodparam>
  </methodsynopsis><methodsynopsis language="python">
    <methodname><link linkend="method-gtkaboutdialog--get-wrap-license">get_wrap_license</link></methodname>
    <methodparam></methodparam>
  </methodsynopsis><methodsynopsis language="python">
    <methodname><link linkend="method-gtkaboutdialog--set-wrap-license">set_wrap_license</link></methodname>
    <methodparam><parameter role="keyword">wrap_license</parameter></methodparam>
  </methodsynopsis><methodsynopsis language="python">
    <methodname><link linkend="method-gtkaboutdialog--get-website">get_website</link></methodname>
    <methodparam></methodparam>
  </methodsynopsis><methodsynopsis language="python">
    <methodname><link linkend="method-gtkaboutdialog--set-website">set_website</link></methodname>
    <methodparam><parameter role="keyword">website</parameter></methodparam>
  </methodsynopsis><methodsynopsis language="python">
    <methodname><link linkend="method-gtkaboutdialog--get-website-label">get_website_label</link></methodname>
    <methodparam></methodparam>
  </methodsynopsis><methodsynopsis language="python">
    <methodname><link linkend="method-gtkaboutdialog--set-website-label">set_website_label</link></methodname>
    <methodparam><parameter role="keyword">website_label</parameter></methodparam>
  </methodsynopsis><methodsynopsis language="python">
    <methodname><link linkend="method-gtkaboutdialog--get-authors">get_authors</link></methodname>
    <methodparam></methodparam>
  </methodsynopsis><methodsynopsis language="python">
    <methodname><link linkend="method-gtkaboutdialog--set-authors">set_authors</link></methodname>
    <methodparam><parameter role="keyword">authors</parameter></methodparam>
  </methodsynopsis><methodsynopsis language="python">
    <methodname><link linkend="method-gtkaboutdialog--get-documenters">get_documenters</link></methodname>
    <methodparam></methodparam>
  </methodsynopsis><methodsynopsis language="python">
    <methodname><link linkend="method-gtkaboutdialog--set-documenters">set_documenters</link></methodname>
    <methodparam><parameter role="keyword">documenters</parameter></methodparam>
  </methodsynopsis><methodsynopsis language="python">
    <methodname><link linkend="method-gtkaboutdialog--get-artists">get_artists</link></methodname>
    <methodparam></methodparam>
  </methodsynopsis><methodsynopsis language="python">
    <methodname><link linkend="method-gtkaboutdialog--set-artists">set_artists</link></methodname>
    <methodparam><parameter role="keyword">artists</parameter></methodparam>
  </methodsynopsis><methodsynopsis language="python">
    <methodname><link linkend="method-gtkaboutdialog--get-translator-credits">get_translator_credits</link></methodname>
    <methodparam></methodparam>
  </methodsynopsis><methodsynopsis language="python">
    <methodname><link linkend="method-gtkaboutdialog--set-translator-credits">set_translator_credits</link></methodname>
    <methodparam><parameter role="keyword">translator_credits</parameter></methodparam>
  </methodsynopsis><methodsynopsis language="python">
    <methodname><link linkend="method-gtkaboutdialog--get-logo">get_logo</link></methodname>
    <methodparam></methodparam>
  </methodsynopsis><methodsynopsis language="python">
    <methodname><link linkend="method-gtkaboutdialog--set-logo">set_logo</link></methodname>
    <methodparam><parameter role="keyword">logo</parameter></methodparam>
  </methodsynopsis><methodsynopsis language="python">
    <methodname><link linkend="method-gtkaboutdialog--get-logo-icon-name">get_logo_icon_name</link></methodname>
    <methodparam></methodparam>
  </methodsynopsis><methodsynopsis language="python">
    <methodname><link linkend="method-gtkaboutdialog--set-logo-icon-name">set_logo_icon_name</link></methodname>
    <methodparam><parameter role="keyword">icon_name</parameter></methodparam>
  </methodsynopsis>
</classsynopsis>

<programlisting>
<emphasis role="bold">Functions</emphasis>
 
<methodsynopsis language="python">
    <methodname><link linkend="function-gtk--about-dialog-set-email-hook">gtk.about_dialog_set_email_hook</link></methodname>
    <methodparam><parameter role="keyword">func</parameter></methodparam>
    <methodparam><parameter role="keyword">data</parameter></methodparam>
  </methodsynopsis><methodsynopsis language="python">
    <methodname><link linkend="function-gtk--about-dialog-set-url-hook">gtk.about_dialog_set_url_hook</link></methodname>
    <methodparam><parameter role="keyword">func</parameter></methodparam>
    <methodparam><parameter role="keyword">data</parameter></methodparam>
  </methodsynopsis></programlisting>
 
  </refsect1>

  <refsect1>
    <title>Ancestry</title>

<synopsis>+-- <link linkend="class-gobject">gobject.GObject</link>
  +-- <link linkend="class-gtkobject">gtk.Object</link>
    +-- <link linkend="class-gtkwidget">gtk.Widget</link>
      +-- <link linkend="class-gtkcontainer">gtk.Container</link>
        +-- <link linkend="class-gtkbin">gtk.Bin</link>
          +-- <link linkend="class-gtkwindow">gtk.Window</link>
            +-- <link linkend="class-gtkdialog">gtk.Dialog</link>
              +--<link linkend="class-gtkaboutdialog">gtk.AboutDialog</link>
</synopsis>
    
    <refsect1>
		<title>Implemented Interfaces</title>
		<para>
			<link linkend="class-gtkaboutdialog"><classname>gtk.AboutDialog</classname></link>
			implements 
			<link linkend="class-gtkbuildable"><classname>gtk.Buildable</classname></link>
            <link linkend="class-atkimplementor"><classname>atk.ImplementorIFace</classname></link>
		</para>
	</refsect1>
  </refsect1>

  <refsect1 id="properties-gtkaboutdialog">
    <title>gtk.AboutDialog Properties</title>

    <para><link linkend="properties-gtkobject">gtk.Object Properties</link></para>
    <para><link linkend="properties-gtkwidget">gtk.Widget Properties</link></para>
    <para><link linkend="properties-gtkcontainer">gtk.Container Properties</link></para>
    <para><link linkend="properties-gtkwindow">gtk.Window Properties</link></para>
    <para><link linkend="properties-gtkdialog">gtk.Dialog Properties</link></para>

    <blockquote role="properties">
      <informaltable pgwide="1" frame="none">
	<tgroup cols="3">
	  <colspec column="1" colwidth="1in"/>
	  <colspec column="2" colwidth="1in"/>
	  <colspec column="3" colwidth="4in"/>
	  <tbody>

	    <row valign="top">
	      <entry>"artists"</entry>
	      <entry>Read-Write</entry>
	      <entry>The list of people who have contributed artwork to
the program.
This property is available in GTK+ 2.6 and above.</entry>
	    </row>
	    <row valign="top">
	      <entry>"authors"</entry>
	      <entry>Read-Write</entry>
	      <entry>The list of authors of the program.
This property is available in GTK+ 2.6 and above.</entry>
	    </row>
	    <row valign="top">
	      <entry>"comments"</entry>
	      <entry>Read-Write</entry>
	      <entry>A string containing comments about the program.
Default value: <literal>None</literal>.
This property is available in GTK+ 2.6 and above.</entry>
	    </row>
	    <row valign="top">
	      <entry>"copyright"</entry>
	      <entry>Read-Write</entry>
	      <entry>A string containing copyright information for
the program. Default value: <literal>None</literal>.
This property is available in GTK+ 2.6 and above.</entry>
	    </row>
	    <row valign="top">
	      <entry>"documenters"</entry>
	      <entry>Read-Write</entry>
	      <entry>The list of people documenting the program.
This property is available in GTK+ 2.6 and above.</entry>
	    </row>
	    <row valign="top">
	      <entry>"license"</entry>
	      <entry>Read-Write</entry>
	      <entry>A string containing the license of the program.
Default value: <literal>None</literal>.
This property is available in GTK+ 2.6 and above.</entry>
	    </row>
	    <row valign="top">
	      <entry>"logo"</entry>
	      <entry>Read-Write</entry>
	      <entry>A logo for the about box. If this is not set,
it defaults to the default window icon list.
This property is available in GTK+ 2.6 and above.</entry>
	    </row>
	    <row valign="top">
	      <entry>"logo-icon-name"</entry>
	      <entry>Read-Write</entry>
	      <entry>The name of an icon to use as the logo for the
about box. Default value: <literal>None</literal>.
This property is available in GTK+ 2.6 and above.</entry>
	    </row>
	    <row valign="top">
	      <entry>"program-name"</entry>
	      <entry>Read-Write</entry>
	      <entry>The name of the program. If this is not set, it
defaults to g_get_application_name().
Default value: <literal>None</literal>.
This property is available in GTK+ 2.12 and above.</entry>
	    </row>
	    <row valign="top">
	      <entry>"translator-credits"</entry>
	      <entry>Read-Write</entry>
	      <entry>Credits to the translators. This string should be
marked as translatable. Default value: <literal>None</literal>.
This property is available in GTK+ 2.6 and above.</entry>
	    </row>
	    <row valign="top">
	      <entry>"version"</entry>
	      <entry>Read-Write</entry>
	      <entry>A string containing the version of the program.
Default value: <literal>None</literal>.
This property is available in GTK+ 2.6 and above.</entry>
	    </row>
	    <row valign="top">
	      <entry>"website"</entry>
	      <entry>Read-Write</entry>
	      <entry>The URL for the link to the website of the
program. Default value: <literal>None</literal>.
This property is available in GTK+ 2.6 and above.</entry>
	    </row>
	    <row valign="top">
	      <entry>"website-label"</entry>
	      <entry>Read-Write</entry>
	      <entry>The label for the link to the website of the program.
If this is not set, it defaults to the URL.
Default value: <literal>None</literal>.
This property is available in GTK+ 2.6 and above.</entry>
	    </row>
	    <row valign="top">
	      <entry>"wrap-license"</entry>
	      <entry>Read-Write</entry>
	      <entry>If <literal>True</literal> the license text should be
wrapped. Default value: <literal>False</literal>.
This property is available in GTK+ 2.6 and above.</entry>
	    </row>

	  </tbody>
	</tgroup>
      </informaltable>
    </blockquote>

  </refsect1>

  <refsect1 id="style-properties-gtkaboutdialog">
    <title>gtk.AboutDialog Style Properties</title>

    <para><link linkend="style-properties-gtkwidget">gtk.Widget Style Properties</link></para>
    <para><link linkend="style-properties-gtkdialog">gtk.Dialog Style Properties</link></para>

    <blockquote role="properties">
      <informaltable pgwide="1" frame="none">
	<tgroup cols="3">
	  <colspec column="1" colwidth="1in"/>
	  <colspec column="2" colwidth="1in"/>
	  <colspec column="3" colwidth="4in"/>
	  <tbody>

	    <row valign="top">
	      <entry>"link-color"</entry>
	      <entry>Read</entry>
	      <entry>The color of hyperlinks. This property is not available
	      in GTK+ 2.10 and above.</entry>
	    </row>

	  </tbody>
	</tgroup>
      </informaltable>
    </blockquote>

  </refsect1>

  <refsect1 id="signal-prototypes-gtkaboutdialog">
    <title>gtk.AboutDialog Signal Prototypes</title>

    <para><link linkend="signal-prototypes-gobject">gobject.GObject Signal Prototypes</link></para>
    <para><link linkend="signal-prototypes-gtkobject">gtk.Object Signal Prototypes</link></para>
    <para><link linkend="signal-prototypes-gtkwidget">gtk.Widget Signal Prototypes</link></para>
    <para><link linkend="signal-prototypes-gtkcontainer">gtk.Container Signal Prototypes</link></para>
    <para><link linkend="signal-prototypes-gtkwindow">gtk.Window Signal Prototypes</link></para>
    <para><link linkend="signal-prototypes-gtkdialog">gtk.Dialog Signal Prototypes</link></para>

    <variablelist>
      <varlistentry>
        <term>"<link linkend="signal-gtkaboutdialog--activate-link">activate-link</link>"</term>
        <listitem>
          <methodsynopsis language="python"><methodname>callback</methodname>
            <methodparam><parameter>aboutdialog</parameter></methodparam>
            <methodparam><parameter>uri</parameter></methodparam>
            <methodparam><parameter>user_param1</parameter></methodparam>
            <methodparam><parameter>...</parameter></methodparam>
          </methodsynopsis>
        </listitem>
      </varlistentry>
    </variablelist>

  </refsect1>

  <refsect1>
    <title>Description</title>

    <note>
      <para>This widget is available in PyGTK 2.6 and above.</para>
    </note>

    <para>The <link
    linkend="class-gtkaboutdialog"><classname>gtk.AboutDialog</classname></link>
    offers a simple way to display information about a program like its
    logo, name, copyright, website and license. It is also possible to give
    credits to the authors, documenters, translators and artists who have
    worked on the program. An about dialog is typically opened when the user
    selects the <guimenuitem>About</guimenuitem> option from the <guimenu>Help</guimenu>
    menu. All parts of the dialog are optional.</para>

    <para>About dialog often contain links and email addresses. <link
    linkend="class-gtkaboutdialog"><classname>gtk.AboutDialog</classname></link>
    supports this by offering global hooks, which are called when the user
    clicks on a link or email address, see the <link
    linkend="function-gtk--about-dialog-set-email-hook"><function>gtk.about_dialog_set_email_hook</function>()</link>
    and <link
    linkend="function-gtk--about-dialog-set-url-hook"><function>gtk.about_dialog_set_url_hook</function>()</link>
    functions. Email addresses in the authors, documenters and artists
    properties are recognized by looking for <literal>&lt;user@<!--
    -->host&gt;</literal>, URLs are recognized by looking for
    <literal>http://url</literal>, with <literal>url</literal> extending to
    the next space, tab or line break.</para>

  </refsect1>

  <refsect1 id="constructor-gtkaboutdialog">
    <title>Constructor</title>

    <programlisting><constructorsynopsis language="python">
	<methodname>gtk.AboutDialog</methodname>
	<methodparam></methodparam>
      </constructorsynopsis></programlisting>
    <variablelist>
      <varlistentry>
	<term><emphasis>Returns</emphasis>&nbsp;:</term>
	<listitem><simpara>a new <link
linkend="class-gtkdialog"><classname>gtk.AboutDialog</classname></link></simpara></listitem>
      </varlistentry>
    </variablelist>

    <note>
      <para>This constructor is available in PyGTK 2.6 and above.</para>
    </note>

    <para>Creates a new gtk.AboutDialog with default property values.</para>

  </refsect1>

  <refsect1>
    <title>Methods</title>

    <refsect2 id="method-gtkaboutdialog--get-name">
      <title>gtk.AboutDialog.get_name</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>get_name</methodname>
	  <methodparam></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	<term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara>the program name.</simpara></listitem>
	</varlistentry>
      </variablelist>

      <note>
        <para>This method is available in PyGTK 2.6 and above.</para>
      </note>

      <warning>
        <para>
          This method is deprecated in PyGTK 2.12 and above and should not be
          used in newly-written code. Use the <link linkend="method-gtkaboutdialog--set-program-name"><methodname>get_program_name</methodname></link>()
          method instead.
        </para>
      </warning>

      <para>The <methodname>get_name</methodname>() method returns the
      program name displayed in the about dialog.</para>

    </refsect2>

    <refsect2 id="method-gtkaboutdialog--set-name">
      <title>gtk.AboutDialog.set_name</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>set_name</methodname>
	  <methodparam><parameter
			 role="keyword">name</parameter></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter role="keyword">name</parameter>&nbsp;:</term>
	  <listitem><simpara>a string containing the program
name or <literal>None</literal> to use the default name.</simpara></listitem>
	</varlistentry>
      </variablelist>

      <note>
        <para>This method is available in PyGTK 2.6 and above.</para>
      </note>

      <warning>
        <para>
          This method is deprecated in PyGTK 2.12 and above and should not be
          used in newly-written code. Use the <link linkend="method-gtkaboutdialog--set-program-name"><methodname>set_program_name</methodname></link>()
          method instead.
        </para>
      </warning>

      <para>The <methodname>set_name</methodname>() method sets the name
to display in the about dialog. If <parameter>name</parameter> is <literal>None</literal>,
it defaults to g_get_application_name().</para>

    </refsect2>

    <refsect2 id="method-gtkaboutdialog--get-program-name">
      <title>gtk.AboutDialog.get_program_name</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>get_program_name</methodname>
	  <methodparam></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	<term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara>the program name.</simpara></listitem>
	</varlistentry>
      </variablelist>

      <note>
        <para>This method is available in PyGTK 2.12 and above.</para>
      </note>

      <para>The <methodname>get_program_name</methodname>() method returns the
      program name displayed in the about dialog.</para>

    </refsect2>

    <refsect2 id="method-gtkaboutdialog--set-program-name">
      <title>gtk.AboutDialog.set_program_name</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>set_program_name</methodname>
	  <methodparam><parameter
			 role="keyword">name</parameter></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter role="keyword">name</parameter>&nbsp;:</term>
	  <listitem><simpara>a string containing the program
name or <literal>None</literal> to use the default name.</simpara></listitem>
	</varlistentry>
      </variablelist>

      <note>
        <para>This method is available in PyGTK 2.12 and above.</para>
      </note>

      <para>The <methodname>set_program_name</methodname>() method sets the name
to display in the about dialog. If <parameter>name</parameter> is <literal>None</literal>,
it defaults to g_get_application_name().</para>

    </refsect2>

    <refsect2 id="method-gtkaboutdialog--get-version">
      <title>gtk.AboutDialog.get_version</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>get_version</methodname>
	  <methodparam></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	<term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara>The version string or
<literal>None</literal>.</simpara></listitem>
	</varlistentry>
      </variablelist>

      <note>
        <para>This method is available in PyGTK 2.6 and above.</para>
      </note>

      <para>The <methodname>get_version</methodname>() method returns the
string contained in the "version" property.</para>

    </refsect2>

    <refsect2 id="method-gtkaboutdialog--set-version">
      <title>gtk.AboutDialog.set_version</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>set_version</methodname>
	  <methodparam><parameter
			 role="keyword">version</parameter></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter role="keyword">version</parameter>&nbsp;:</term>
	  <listitem><simpara>the version string or
<literal>None</literal></simpara></listitem>
	</varlistentry>
      </variablelist>

      <note>
        <para>This method is available in PyGTK 2.6 and above.</para>
      </note>

      <para>The <methodname>set_version</methodname>() method sets the
"version" property to the string in <parameter>version</parameter>.</para>

    </refsect2>

    <refsect2 id="method-gtkaboutdialog--get-copyright">
      <title>gtk.AboutDialog.get_copyright</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>get_copyright</methodname>
	  <methodparam></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	<term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara>the copyright string or
<literal>None</literal>.</simpara></listitem>
	</varlistentry>
      </variablelist>

      <note>
        <para>This method is available in PyGTK 2.6 and above.</para>
      </note>

      <para>The <methodname>get_copyright</methodname>() method returns the
string contained in the "copyright" property.</para>

    </refsect2>

    <refsect2 id="method-gtkaboutdialog--set-copyright">
      <title>gtk.AboutDialog.set_copyright</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>set_copyright</methodname>
	  <methodparam><parameter
			 role="keyword">copyright</parameter></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter role="keyword">copyright</parameter>&nbsp;:</term>
	  <listitem><simpara>a string containing the copyright
notice or <literal>None</literal>.</simpara></listitem>
	</varlistentry>
      </variablelist>

      <note>
        <para>This method is available in PyGTK 2.6 and above.</para>
      </note>

      <para>The <methodname>set_copyright</methodname>() method sets the
"copyright" property to the string contained in
<parameter>copyright</parameter>. If <parameter>copyright</parameter> is
<literal>None</literal>, the copyright notice is hidden.</para>

    </refsect2>

    <refsect2 id="method-gtkaboutdialog--get-comments">
      <title>gtk.AboutDialog.get_comments</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>get_comments</methodname>
	  <methodparam></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	<term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara>a string containing the
comments or <literal>None</literal></simpara></listitem>
	</varlistentry>
      </variablelist>

      <note>
        <para>This method is available in PyGTK 2.6 and above.</para>
      </note>

      <para>The <methodname>get_comments</methodname>() method returns the
string contained in the "comments" property.</para>

    </refsect2>

    <refsect2 id="method-gtkaboutdialog--set-comments">
      <title>gtk.AboutDialog.set_comments</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>set_comments</methodname>
	  <methodparam><parameter
			 role="keyword">comments</parameter></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter role="keyword">comments</parameter>&nbsp;:</term>
	  <listitem><simpara>a string containing the 
comments or <literal>None</literal>.</simpara></listitem>
	</varlistentry>
      </variablelist>

      <note>
        <para>This method is available in PyGTK 2.6 and above.</para>
      </note>

      <para>The <methodname>set_comments</methodname>() method sets the
"comments" property to the string contained in
<parameter>comments</parameter>. If <parameter>comments</parameter> is
<literal>None</literal> the comments label is hidden.</para>

    </refsect2>

    <refsect2 id="method-gtkaboutdialog--get-license">
      <title>gtk.AboutDialog.get_license</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>get_license</methodname>
	  <methodparam></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
          <term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara>a string containing the license 
information or <literal>None</literal></simpara></listitem>
	</varlistentry>
      </variablelist>

      <note>
        <para>This method is available in PyGTK 2.6 and above.</para>
      </note>

      <para>The <methodname>get_license</methodname>() method returns the 
string contained in the "license" property.</para>

    </refsect2>

    <refsect2 id="method-gtkaboutdialog--set-license">
      <title>gtk.AboutDialog.set_license</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>set_license</methodname>
	  <methodparam><parameter
			 role="keyword">license</parameter></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter role="keyword">license</parameter>&nbsp;:</term>
	  <listitem><simpara></simpara></listitem>
	</varlistentry>
     </variablelist>

      <note>
        <para>This method is available in PyGTK 2.6 and above.</para>
      </note>

      <para>The <methodname>set_license</methodname>() method sets the
"license" property to the string contained in
<parameter>license</parameter>. If <parameter>license</parameter> is
<literal>None</literal> the license button is hidden.</para>

    </refsect2>

    <refsect2 id="method-gtkaboutdialog--get-wrap-license">
      <title>gtk.AboutDialog.get_wrap_license</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>get_wrap_license</methodname>
	  <methodparam></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
          <term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara><literal>True</literal> if the license text
should be wrapped</simpara></listitem>
	</varlistentry>
      </variablelist>

      <note>
        <para>This method is available in PyGTK 2.8 and above.</para>
      </note>

      <para>The <methodname>get_wrap_license</methodname>() method returns
the value of the "wrap-license" property. If "wrap-license" is
<literal>True</literal> the license text should be automatically
wrapped.</para>

    </refsect2>

    <refsect2 id="method-gtkaboutdialog--set-wrap-license">
      <title>gtk.AboutDialog.set_wrap_license</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>set_wrap_license</methodname>
	  <methodparam><parameter
			 role="keyword">wrap_license</parameter></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter role="keyword">wrap_license</parameter>&nbsp;:</term>
	  <listitem><simpara></simpara></listitem>
	</varlistentry>
     </variablelist>

      <note>
        <para>This method is available in PyGTK 2.8 and above.</para>
      </note>

      <para>The <methodname>set_wrap_license</methodname>() method sets the
"wrap-license" property to the value of
<parameter>wrap_license</parameter>. If <parameter>wrap_license</parameter>
is <literal>True</literal> the license text should be automatically
wrapped.</para>

    </refsect2>

    <refsect2 id="method-gtkaboutdialog--get-website">
      <title>gtk.AboutDialog.get_website</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>get_website</methodname>
	  <methodparam></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	<term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara>a string containing the website URL or
<literal>None</literal></simpara></listitem>
	</varlistentry>
      </variablelist>

      <note>
        <para>This method is available in PyGTK 2.6 and above.</para>
      </note>

      <para>The <methodname>get_website</methodname>() method returns the
string contained in the "website" property. The website should be a
URL.</para>

    </refsect2>

    <refsect2 id="method-gtkaboutdialog--set-website">
      <title>gtk.AboutDialog.set_website</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>set_website</methodname>
	  <methodparam><parameter
			 role="keyword">website</parameter></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter role="keyword">website</parameter>&nbsp;:</term>
	  <listitem><simpara>a string containing the URL of the program's
website or <literal>None</literal></simpara></listitem>
	</varlistentry>
      </variablelist>

      <note>
        <para>This method is available in PyGTK 2.6 and above.</para>
      </note>

      <para>The <methodname>set_website</methodname>() method sets the
"website" property to the string contained in
<parameter>website</parameter>. The string should be a valid URL.</para>

    </refsect2>

    <refsect2 id="method-gtkaboutdialog--get-website-label">
      <title>gtk.AboutDialog.get_website_label</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>get_website_label</methodname>
	  <methodparam></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	<term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara>a string containing the website link
label</simpara></listitem>
	</varlistentry>
      </variablelist>

      <note>
        <para>This method is available in PyGTK 2.6 and above.</para>
      </note>

      <para>The <methodname>get_website_label</methodname>() method returns
the contents of the "website_label" property. The website label is used if
the url hook has been set using the <link
linkend="function-gtk--about-dialog-set-url-hook"><function>gtk.about_dialog_set_url_hook</function>()</link>
function.</para>

    </refsect2>

    <refsect2 id="method-gtkaboutdialog--set-website-label">
      <title>gtk.AboutDialog.set_website_label</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>set_website_label</methodname>
	  <methodparam><parameter
			 role="keyword">website_label</parameter></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter role="keyword">website_label</parameter>&nbsp;:</term>
	  <listitem><simpara></simpara></listitem>
	</varlistentry>
      </variablelist>

       <note>
        <para>This method is available in PyGTK 2.6 and above.</para>
      </note>

      <para>The <methodname>set_website_label</methodname>() method sets the
"website_label" property to the string contained in
<parameter>website_label</parameter> if the url hook has been set using the
<link
linkend="function-gtk--about-dialog-set-url-hook"><function>gtk.about_dialog_set_url_hook</function>()</link>
function.</para>

    </refsect2>

    <refsect2 id="method-gtkaboutdialog--get-authors">
      <title>gtk.AboutDialog.get_authors</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>get_authors</methodname>
	  <methodparam></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	<term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara>a list containing the names of the program
authors</simpara></listitem>
	</varlistentry>
      </variablelist>

      <note>
        <para>This method is available in PyGTK 2.6 and above.</para>
      </note>

      <para>The <methodname>get_authors</methodname>() method returns the
contents of the "authors" property. The "authors" property contains a list
of the names of the authors of the program.</para>

    </refsect2>

    <refsect2 id="method-gtkaboutdialog--set-authors">
      <title>gtk.AboutDialog.set_authors</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>set_authors</methodname>
	  <methodparam><parameter
			 role="keyword">authors</parameter></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter role="keyword">authors</parameter>&nbsp;:</term>
	  <listitem><simpara>a list containing the names of the program
authors.</simpara></listitem>
	</varlistentry>
      </variablelist>

      <note>
        <para>This method is available in PyGTK 2.6 and above.</para>
      </note>

      <para>The <methodname>set_authors</methodname>() method sets the
"authors" property to the list contained in
<parameter>authors</parameter>. The author names are displayed in the
authors tab of the secondary credits
dialog. <methodname>set_authors</methodname>() method will show the
<guibutton>Credits</guibutton> button if it is not displayed.</para>

    </refsect2>

    <refsect2 id="method-gtkaboutdialog--get-documenters">
      <title>gtk.AboutDialog.get_documenters</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>get_documenters</methodname>
	  <methodparam></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	<term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara>a list of the program
documenters</simpara></listitem>
	</varlistentry>
      </variablelist>

      <note>
        <para>This method is available in PyGTK 2.6 and above.</para>
      </note>

      <para>The <methodname>get_documenters</methodname>() method returns
the contents of the "documenters" property which contains a list of the
names of the program documenters.</para>

    </refsect2>

    <refsect2 id="method-gtkaboutdialog--set-documenters">
      <title>gtk.AboutDialog.set_documenters</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>set_documenters</methodname>
	  <methodparam><parameter
			 role="keyword">documenters</parameter></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter role="keyword">documenters</parameter>&nbsp;:</term>
	  <listitem><simpara>a list of the names of the program
documenters</simpara></listitem>
	</varlistentry>
      </variablelist>

      <note>
        <para>This method is available in PyGTK 2.6 and above.</para>
      </note>

      <para>The <methodname>set_documenters</methodname>() method sets the
"documenters" property to the contents of
<parameter>documenters</parameter>. The documenter names are displayed in
the documenters tab of the secondary credits
dialog. <methodname>set_documenters</methodname>() method will show the
<guibutton>Credits</guibutton> button if it is not displayed.</para>

    </refsect2>

    <refsect2 id="method-gtkaboutdialog--get-artists">
      <title>gtk.AboutDialog.get_artists</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>get_artists</methodname>
	  <methodparam></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	<term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara>a list of the names of the program
artists</simpara></listitem>
	</varlistentry>
      </variablelist>

      <note>
        <para>This method is available in PyGTK 2.6 and above.</para>
      </note>

      <para>The <methodname>get_artists</methodname>() method returns the
contents of the "artists" property which contains a list of the names of the
program artists.</para>

    </refsect2>

    <refsect2 id="method-gtkaboutdialog--set-artists">
      <title>gtk.AboutDialog.set_artists</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>set_artists</methodname>
	  <methodparam><parameter
			 role="keyword">artists</parameter></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter role="keyword">artists</parameter>&nbsp;:</term>
	  <listitem><simpara>a list of the names of the program
artists</simpara></listitem>
	</varlistentry>
      </variablelist>

      <note>
        <para>This method is available in PyGTK 2.6 and above.</para>
      </note>

      <para>The <methodname>set_artists</methodname>() method sets the
"artists" property to the contents of <parameter>artists</parameter>. The
artist names are displayed in the artists tab of the secondary credits
dialog. <methodname>set_artists</methodname>() method will show the
<guibutton>Credits</guibutton> button if it is not displayed.</para>

    </refsect2>

    <refsect2 id="method-gtkaboutdialog--get-translator-credits">
      <title>gtk.AboutDialog.get_translator_credits</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>get_translator_credits</methodname>
	  <methodparam></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	<term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara>a string containing the translator
credits</simpara></listitem>
	</varlistentry>
      </variablelist>

      <note>
        <para>This method is available in PyGTK 2.6 and above.</para>
      </note>

      <para>The <methodname>get_translator_credits</methodname>() method
returns the contents of the "translator-credits" property which contains the
credits for the current translation.</para>

    </refsect2>

    <refsect2 id="method-gtkaboutdialog--set-translator-credits">
      <title>gtk.AboutDialog.set_translator_credits</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>set_translator_credits</methodname>
	  <methodparam><parameter
			 role="keyword">translator_credits</parameter></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter role="keyword">translator_credits</parameter>&nbsp;:</term>
	  <listitem><simpara>a string containing the current translation
credits</simpara></listitem>
	</varlistentry>
      </variablelist>

      <note>
        <para>This method is available in PyGTK 2.6 and above.</para>
      </note>

      <para>The <methodname>set_translator_credits</methodname>() method
sets the "translator_credits" property to the value of
<parameter>translator_credits</parameter>. The translator credits are
displayed in the translators tab of the secondary credits dialog.</para>

      <para>The intended use for this string is to display the translator of
the language which is currently used in the user interface. Using the
<function>gettext</function>() function, a simple way to achieve that is to
mark the string for translation.</para>

      <para>It is a good idea to use the customary msgid
"translator-credits" for this purpose, since translators will already know
the purpose of that msgid, and since <link
linkend="class-gtkaboutdialog"><classname>gtk.AboutDialog</classname></link>
will detect if "translator-credits" is untranslated and hide the tab.</para>

    </refsect2>

    <refsect2 id="method-gtkaboutdialog--get-logo">
      <title>gtk.AboutDialog.get_logo</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>get_logo</methodname>
	  <methodparam></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	<term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara>the <link
linkend="class-gdkpixbuf"><classname>gtk.gdk.Pixbuf</classname></link>
used as the logo</simpara></listitem>
	</varlistentry>
      </variablelist>

      <note>
        <para>This method is available in PyGTK 2.6 and above.</para>
      </note>

      <para>The <methodname>get_logo</methodname>() method returns the
contents of the "logo" property which contains a <link
linkend="class-gdkpixbuf"><classname>gtk.gdk.Pixbuf</classname></link> that
is used as the logo.</para>

    </refsect2>

    <refsect2 id="method-gtkaboutdialog--set-logo">
      <title>gtk.AboutDialog.set_logo</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>set_logo</methodname>
	  <methodparam><parameter
			 role="keyword">logo</parameter></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter role="keyword">logo</parameter>&nbsp;:</term>
	  <listitem><simpara>a <link
linkend="class-gdkpixbuf"><classname>gtk.gdk.Pixbuf</classname></link> to be
used as the logo</simpara></listitem>
	</varlistentry>
      </variablelist>

      <note>
        <para>This method is available in PyGTK 2.6 and above.</para>
      </note>

      <para>The <methodname>set_logo</methodname>() method sets the "logo"
property to the <link
linkend="class-gdkpixbuf"><classname>gtk.gdk.Pixbuf</classname></link>
contained in <parameter>logo</parameter>. If <parameter>logo</parameter> is
<literal>None</literal>, the default window icon set with the <link
linkend="function-gtk--window-set-default-icon"><function>gtk.window_set_default_icon_list</function>()</link>
function will be used.</para>

    </refsect2>

    <refsect2 id="method-gtkaboutdialog--get-logo-icon-name">
      <title>gtk.AboutDialog.get_logo_icon_name</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>get_logo_icon_name</methodname>
	  <methodparam></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	<term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara>the name of the icon used as the
logo</simpara></listitem>
	</varlistentry>
      </variablelist>

      <note>
        <para>This method is available in PyGTK 2.6 and above.</para>
      </note>

      <para>The <methodname>get_logo_name</methodname>() method returns the
contents of the "logo-icon-name" property which contains the name of the
icon used as the logo.</para>

    </refsect2>

    <refsect2 id="method-gtkaboutdialog--set-logo-icon-name">
      <title>gtk.AboutDialog.set_logo_icon_name</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>set_logo_icon_name</methodname>
	  <methodparam><parameter
			 role="keyword">icon_name</parameter></methodparam>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter role="keyword">icon_name</parameter>&nbsp;:</term>
	  <listitem><simpara>the name of an icon or
<literal>None</literal></simpara></listitem>
	</varlistentry>
      </variablelist>

      <note>
        <para>This method is available in PyGTK 2.6 and above.</para>
      </note>

      <para>The <methodname>set_logo_icon_name</methodname>() method sets
the "logo-icon-name" property to the value of
<parameter>icon_name</parameter>. If <parameter>icon_name</parameter> is
<literal>None</literal>, the default window icon set with the <link
linkend="function-gtk--window-set-default-icon-list"><function>gtk.window_set_default_icon_list</function>()</link>
function will be used.</para>

    </refsect2>
    
  </refsect1>

  <refsect1>
    <title>Functions</title>
                                                                              
    <refsect2 id="function-gtk--about-dialog-set-email-hook">
      <title>gtk.about_dialog_set_email_hook</title>
                                                                              
      <programlisting><methodsynopsis language="python">
          <methodname>gtk.about_dialog_set_email_hook</methodname>
          <methodparam><parameter
                         role="keyword">func</parameter></methodparam>
          <methodparam><parameter
                         role="keyword">data</parameter></methodparam>
        </methodsynopsis></programlisting>
      <variablelist>
        <varlistentry>
          <term><parameter role="keyword">func</parameter>&nbsp;:</term>
          <listitem><simpara> a function to call when an email link is
activated.</simpara></listitem>
        </varlistentry>
        <varlistentry>
          <term><parameter role="keyword">data</parameter>&nbsp;:</term>
          <listitem><simpara> data to pass to
<parameter>func</parameter></simpara></listitem>
        </varlistentry>
      </variablelist>

      <note>
        <para>This function is available in PyGTK 2.6 and above.</para>
      </note>
                                                                              
      <para>The <function>gtk.about_dialog_set_email_hook</function>
function installs a global function (specified by
<parameter>func</parameter>) to be called whenever the user activates an
email link in an about dialog.</para>

      <para>The signature of the callback function
<parameter>func</parameter> is:</para>

      <programlisting>
def func(dialog, link, user_data)
</programlisting>

      <para>where <parameter>link</parameter> is the email address
destination of the activated link, <parameter>dialog</parameter> is the
<link
linkend="class-gtkaboutdialog"><classname>gtk.AboutDialog</classname></link>
containing <parameter>link</parameter> and <parameter>user_data</parameter>
is the <parameter>data</parameter> argument passed to <link
linkend="function-gtk--about-dialog-set-email-hook"><function>gtk.about_dialog_set_email_hook</function>()</link>.</para>
                                                                              
    </refsect2>
                                                                              
    <refsect2 id="function-gtk--about-dialog-set-url-hook">
      <title>gtk.about_dialog_set_url_hook</title>
                                                                              
      <programlisting><methodsynopsis language="python">
          <methodname>gtk.about_dialog_set_url_hook</methodname>
          <methodparam><parameter
                         role="keyword">func</parameter></methodparam>
          <methodparam><parameter
                         role="keyword">data</parameter></methodparam>
        </methodsynopsis></programlisting>
      <variablelist>
        <varlistentry>
          <term><parameter role="keyword">func</parameter>&nbsp;:</term>
          <listitem><simpara> a function to call when a URL link is
activated.</simpara></listitem>
        </varlistentry>
        <varlistentry>
          <term><parameter role="keyword">data</parameter>&nbsp;:</term>
          <listitem><simpara> data to pass to
<parameter>func</parameter></simpara></listitem>
        </varlistentry>
      </variablelist>

      <note>
        <para>This function is available in PyGTK 2.6 and above.</para>
      </note>

      <para>The <function>gtk.about_dialog_set_url_hook</function> function
installs a global function (specified by <parameter>func</parameter>) to be
called whenever the user activates a URL link in an about dialog.</para>

      <para>The signature of the callback function
<parameter>func</parameter> is:</para>

      <programlisting>
def func(dialog, link, user_data)
</programlisting>

      <para>where <parameter>link</parameter> is the URL destination of the
activated link, <parameter>dialog</parameter> is the <link
linkend="class-gtkaboutdialog"><classname>gtk.AboutDialog</classname></link>
containing <parameter>link</parameter> and <parameter>user_data</parameter>
is the <parameter>data</parameter> argument passed to <link
linkend="function-gtk--about-dialog-set-url-hook"><function>gtk.about_dialog_set_url_hook</function>()</link>.</para>

    </refsect2>

  </refsect1>

  <refsect1>
    <title>Signals</title>

    <refsect2 id="signal-gtkaboutdialog--activate-link">
      <title>The "activate-link" gtk.AboutDialog Signal</title>

      <programlisting><methodsynopsis language="python">
        <methodname>callback</methodname>
        <methodparam><parameter>aboutdialog</parameter></methodparam>
        <methodparam><parameter>uri</parameter></methodparam>
        <methodparam><parameter>user_param1</parameter></methodparam>
        <methodparam><parameter>...</parameter></methodparam>
      </methodsynopsis></programlisting>

      <variablelist>
        <varlistentry>
          <term><parameter>aboutdialog</parameter>&nbsp;:</term>
          <listitem><simpara>the aboutdialog that received the signal</simpara></listitem>
        </varlistentry>
        <varlistentry>
          <term><parameter>uri</parameter>&nbsp;:</term>
          <listitem><simpara>the URI that is activated</simpara></listitem>
        </varlistentry>
        <varlistentry>
          <term><parameter>user_param1</parameter>&nbsp;:</term>
          <listitem><simpara>the first user parameter (if any) specified with the <link linkend="method-gobject--connect"><methodname>connect</methodname>()</link> method</simpara></listitem>
        </varlistentry>
        <varlistentry>
          <term><parameter>...</parameter>&nbsp;:</term>
          <listitem><simpara>additional user parameters (if any)</simpara></listitem>
        </varlistentry>
      </variablelist>

      <note>
        <para>This signal is available in PyGTK 2.24 and above.</para>
      </note>

      <para>The "activate-link" signal is emitted when an URI is activated. Applications may connect to it to override the default behaviour, which is to call
      <link linkend="function-gtk--show-uri"><methodname>gtk.show_uri</methodname></link>().</para>

    </refsect2>
  </refsect1>

 </refentry>