New upstream version 3.24.8

This commit is contained in:
Iain Lane
2019-04-11 09:41:47 +01:00
549 changed files with 776552 additions and 386298 deletions

View File

@ -52,7 +52,7 @@
</td>
</tr>
<tr>
<td class="function_type">const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
<td class="function_type">const <span class="returnvalue">gchar</span> *
</td>
<td class="function_name">
<a class="link" href="GtkAboutDialog.html#gtk-about-dialog-get-program-name" title="gtk_about_dialog_get_program_name ()">gtk_about_dialog_get_program_name</a> <span class="c_punctuation">()</span>
@ -67,7 +67,7 @@
</td>
</tr>
<tr>
<td class="function_type">const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
<td class="function_type">const <span class="returnvalue">gchar</span> *
</td>
<td class="function_name">
<a class="link" href="GtkAboutDialog.html#gtk-about-dialog-get-version" title="gtk_about_dialog_get_version ()">gtk_about_dialog_get_version</a> <span class="c_punctuation">()</span>
@ -82,7 +82,7 @@
</td>
</tr>
<tr>
<td class="function_type">const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
<td class="function_type">const <span class="returnvalue">gchar</span> *
</td>
<td class="function_name">
<a class="link" href="GtkAboutDialog.html#gtk-about-dialog-get-copyright" title="gtk_about_dialog_get_copyright ()">gtk_about_dialog_get_copyright</a> <span class="c_punctuation">()</span>
@ -97,7 +97,7 @@
</td>
</tr>
<tr>
<td class="function_type">const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
<td class="function_type">const <span class="returnvalue">gchar</span> *
</td>
<td class="function_name">
<a class="link" href="GtkAboutDialog.html#gtk-about-dialog-get-comments" title="gtk_about_dialog_get_comments ()">gtk_about_dialog_get_comments</a> <span class="c_punctuation">()</span>
@ -112,7 +112,7 @@
</td>
</tr>
<tr>
<td class="function_type">const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
<td class="function_type">const <span class="returnvalue">gchar</span> *
</td>
<td class="function_name">
<a class="link" href="GtkAboutDialog.html#gtk-about-dialog-get-license" title="gtk_about_dialog_get_license ()">gtk_about_dialog_get_license</a> <span class="c_punctuation">()</span>
@ -128,7 +128,7 @@
</tr>
<tr>
<td class="function_type">
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="GtkAboutDialog.html#gtk-about-dialog-get-wrap-license" title="gtk_about_dialog_get_wrap_license ()">gtk_about_dialog_get_wrap_license</a> <span class="c_punctuation">()</span>
@ -159,7 +159,7 @@
</td>
</tr>
<tr>
<td class="function_type">const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
<td class="function_type">const <span class="returnvalue">gchar</span> *
</td>
<td class="function_name">
<a class="link" href="GtkAboutDialog.html#gtk-about-dialog-get-website" title="gtk_about_dialog_get_website ()">gtk_about_dialog_get_website</a> <span class="c_punctuation">()</span>
@ -174,7 +174,7 @@
</td>
</tr>
<tr>
<td class="function_type">const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
<td class="function_type">const <span class="returnvalue">gchar</span> *
</td>
<td class="function_name">
<a class="link" href="GtkAboutDialog.html#gtk-about-dialog-get-website-label" title="gtk_about_dialog_get_website_label ()">gtk_about_dialog_get_website_label</a> <span class="c_punctuation">()</span>
@ -189,7 +189,7 @@
</td>
</tr>
<tr>
<td class="function_type">const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * const *
<td class="function_type">const <span class="returnvalue">gchar</span> * const *
</td>
<td class="function_name">
<a class="link" href="GtkAboutDialog.html#gtk-about-dialog-get-authors" title="gtk_about_dialog_get_authors ()">gtk_about_dialog_get_authors</a> <span class="c_punctuation">()</span>
@ -204,7 +204,7 @@
</td>
</tr>
<tr>
<td class="function_type">const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * const *
<td class="function_type">const <span class="returnvalue">gchar</span> * const *
</td>
<td class="function_name">
<a class="link" href="GtkAboutDialog.html#gtk-about-dialog-get-artists" title="gtk_about_dialog_get_artists ()">gtk_about_dialog_get_artists</a> <span class="c_punctuation">()</span>
@ -219,7 +219,7 @@
</td>
</tr>
<tr>
<td class="function_type">const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * const *
<td class="function_type">const <span class="returnvalue">gchar</span> * const *
</td>
<td class="function_name">
<a class="link" href="GtkAboutDialog.html#gtk-about-dialog-get-documenters" title="gtk_about_dialog_get_documenters ()">gtk_about_dialog_get_documenters</a> <span class="c_punctuation">()</span>
@ -234,7 +234,7 @@
</td>
</tr>
<tr>
<td class="function_type">const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
<td class="function_type">const <span class="returnvalue">gchar</span> *
</td>
<td class="function_name">
<a class="link" href="GtkAboutDialog.html#gtk-about-dialog-get-translator-credits" title="gtk_about_dialog_get_translator_credits ()">gtk_about_dialog_get_translator_credits</a> <span class="c_punctuation">()</span>
@ -265,7 +265,7 @@
</td>
</tr>
<tr>
<td class="function_type">const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
<td class="function_type">const <span class="returnvalue">gchar</span> *
</td>
<td class="function_name">
<a class="link" href="GtkAboutDialog.html#gtk-about-dialog-get-logo-icon-name" title="gtk_about_dialog_get_logo_icon_name ()">gtk_about_dialog_get_logo_icon_name</a> <span class="c_punctuation">()</span>
@ -308,35 +308,35 @@
</colgroup>
<tbody>
<tr>
<td class="property_type"><a href="https://developer.gnome.org/glib/unstable/glib-String-Utility-Functions.html#GStrv"><span class="type">GStrv</span></a></td>
<td class="property_type"><span class="type">GStrv</span></td>
<td class="property_name"><a class="link" href="GtkAboutDialog.html#GtkAboutDialog--artists" title="The “artists” property">artists</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type"><a href="https://developer.gnome.org/glib/unstable/glib-String-Utility-Functions.html#GStrv"><span class="type">GStrv</span></a></td>
<td class="property_type"><span class="type">GStrv</span></td>
<td class="property_name"><a class="link" href="GtkAboutDialog.html#GtkAboutDialog--authors" title="The “authors” property">authors</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type">
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td>
<span class="type">gchar</span> *</td>
<td class="property_name"><a class="link" href="GtkAboutDialog.html#GtkAboutDialog--comments" title="The “comments” property">comments</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type">
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td>
<span class="type">gchar</span> *</td>
<td class="property_name"><a class="link" href="GtkAboutDialog.html#GtkAboutDialog--copyright" title="The “copyright” property">copyright</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type"><a href="https://developer.gnome.org/glib/unstable/glib-String-Utility-Functions.html#GStrv"><span class="type">GStrv</span></a></td>
<td class="property_type"><span class="type">GStrv</span></td>
<td class="property_name"><a class="link" href="GtkAboutDialog.html#GtkAboutDialog--documenters" title="The “documenters” property">documenters</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type">
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td>
<span class="type">gchar</span> *</td>
<td class="property_name"><a class="link" href="GtkAboutDialog.html#GtkAboutDialog--license" title="The “license” property">license</a></td>
<td class="property_flags">Read / Write</td>
</tr>
@ -353,42 +353,42 @@
</tr>
<tr>
<td class="property_type">
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td>
<span class="type">gchar</span> *</td>
<td class="property_name"><a class="link" href="GtkAboutDialog.html#GtkAboutDialog--logo-icon-name" title="The “logo-icon-name” property">logo-icon-name</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type">
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td>
<span class="type">gchar</span> *</td>
<td class="property_name"><a class="link" href="GtkAboutDialog.html#GtkAboutDialog--program-name" title="The “program-name” property">program-name</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type">
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td>
<span class="type">gchar</span> *</td>
<td class="property_name"><a class="link" href="GtkAboutDialog.html#GtkAboutDialog--translator-credits" title="The “translator-credits” property">translator-credits</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type">
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td>
<span class="type">gchar</span> *</td>
<td class="property_name"><a class="link" href="GtkAboutDialog.html#GtkAboutDialog--version" title="The “version” property">version</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type">
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td>
<span class="type">gchar</span> *</td>
<td class="property_name"><a class="link" href="GtkAboutDialog.html#GtkAboutDialog--website" title="The “website” property">website</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type">
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td>
<span class="type">gchar</span> *</td>
<td class="property_name"><a class="link" href="GtkAboutDialog.html#GtkAboutDialog--website-label" title="The “website-label” property">website-label</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></td>
<td class="property_type"><span class="type">gboolean</span></td>
<td class="property_name"><a class="link" href="GtkAboutDialog.html#GtkAboutDialog--wrap-license" title="The “wrap-license” property">wrap-license</a></td>
<td class="property_flags">Read / Write</td>
</tr>
@ -404,9 +404,9 @@
<col width="200px" class="signals_flags">
</colgroup>
<tbody><tr>
<td class="signal_type"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a></td>
<td class="signal_type"><span class="returnvalue">gboolean</span></td>
<td class="signal_name"><a class="link" href="GtkAboutDialog.html#GtkAboutDialog-activate-link" title="The “activate-link” signal">activate-link</a></td>
<td class="signal_flags"><a href="https://developer.gnome.org/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS">Run Last</a></td>
<td class="signal_flags">Run Last</td>
</tr></tbody>
</table></div>
</div>
@ -431,8 +431,8 @@
</div>
<div class="refsect1">
<a name="GtkAboutDialog.object-hierarchy"></a><h2>Object Hierarchy</h2>
<pre class="screen"> <a href="https://developer.gnome.org/gobject/unstable/gobject-The-Base-Object-Type.html#GObject-struct">GObject</a>
<span class="lineart">╰──</span> <a href="https://developer.gnome.org/gobject/unstable/gobject-The-Base-Object-Type.html#GInitiallyUnowned">GInitiallyUnowned</a>
<pre class="screen"> GObject
<span class="lineart">╰──</span> GInitiallyUnowned
<span class="lineart">╰──</span> <a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a>
<span class="lineart">╰──</span> <a class="link" href="GtkContainer.html" title="GtkContainer">GtkContainer</a>
<span class="lineart">╰──</span> <a class="link" href="GtkBin.html" title="GtkBin">GtkBin</a>
@ -485,12 +485,12 @@ as shown in the following example:</p>
4
5
6</pre></td>
<td class="listing_code"><pre class="programlisting"><span class="usertype">GdkPixbuf</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">example_logo </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-File-Loading.html#gdk-pixbuf-new-from-file">gdk_pixbuf_new_from_file</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"./logo.png"</span><span class="symbol">,</span><span class="normal"> <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">);</span>
<span class="function"><a href="GtkAboutDialog.html#gtk-show-about-dialog">gtk_show_about_dialog</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal"><a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">,</span>
<td class="listing_code"><pre class="programlisting"><span class="usertype">GdkPixbuf</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">example_logo </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-File-Loading.html#gdk-pixbuf-new-from-file">gdk_pixbuf_new_from_file</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"./logo.png"</span><span class="symbol">,</span><span class="normal"> NULL</span><span class="symbol">);</span>
<span class="function"><a href="GtkAboutDialog.html#gtk-show-about-dialog">gtk_show_about_dialog</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">NULL</span><span class="symbol">,</span>
<span class="normal"> </span><span class="string">"program-name"</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"ExampleCode"</span><span class="symbol">,</span>
<span class="normal"> </span><span class="string">"logo"</span><span class="symbol">,</span><span class="normal"> example_logo</span><span class="symbol">,</span>
<span class="normal"> </span><span class="string">"title"</span><span class="symbol">,</span><span class="normal"> </span><span class="function">_</span><span class="symbol">(</span><span class="string">"About ExampleCode"</span><span class="symbol">),</span>
<span class="normal"> <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">);</span></pre></td>
<span class="normal"> NULL</span><span class="symbol">);</span></pre></td>
</tr>
</tbody>
</table>
@ -517,7 +517,7 @@ gtk_about_dialog_new (<em class="parameter"><code><span class="type">void</span>
<hr>
<div class="refsect2">
<a name="gtk-about-dialog-get-program-name"></a><h3>gtk_about_dialog_get_program_name ()</h3>
<pre class="programlisting">const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
<pre class="programlisting">const <span class="returnvalue">gchar</span> *
gtk_about_dialog_get_program_name (<em class="parameter"><code><a class="link" href="GtkAboutDialog.html" title="GtkAboutDialog"><span class="type">GtkAboutDialog</span></a> *about</code></em>);</pre>
<p>Returns the program name displayed in the about dialog.</p>
<div class="refsect3">
@ -547,9 +547,9 @@ dialog and must not be modified.</p>
<a name="gtk-about-dialog-set-program-name"></a><h3>gtk_about_dialog_set_program_name ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_about_dialog_set_program_name (<em class="parameter"><code><a class="link" href="GtkAboutDialog.html" title="GtkAboutDialog"><span class="type">GtkAboutDialog</span></a> *about</code></em>,
<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>);</pre>
<em class="parameter"><code>const <span class="type">gchar</span> *name</code></em>);</pre>
<p>Sets the name to display in the about dialog.
If this is not set, it defaults to <a href="https://developer.gnome.org/glib/unstable/glib-Miscellaneous-Utility-Functions.html#g-get-application-name"><code class="function">g_get_application_name()</code></a>.</p>
If this is not set, it defaults to <code class="function">g_get_application_name()</code>.</p>
<div class="refsect3">
<a name="gtk-about-dialog-set-program-name.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
@ -577,7 +577,7 @@ If this is not set, it defaults to <a href="https://developer.gnome.org/glib/uns
<hr>
<div class="refsect2">
<a name="gtk-about-dialog-get-version"></a><h3>gtk_about_dialog_get_version ()</h3>
<pre class="programlisting">const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
<pre class="programlisting">const <span class="returnvalue">gchar</span> *
gtk_about_dialog_get_version (<em class="parameter"><code><a class="link" href="GtkAboutDialog.html" title="GtkAboutDialog"><span class="type">GtkAboutDialog</span></a> *about</code></em>);</pre>
<p>Returns the version string.</p>
<div class="refsect3">
@ -607,7 +607,7 @@ dialog and must not be modified.</p>
<a name="gtk-about-dialog-set-version"></a><h3>gtk_about_dialog_set_version ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_about_dialog_set_version (<em class="parameter"><code><a class="link" href="GtkAboutDialog.html" title="GtkAboutDialog"><span class="type">GtkAboutDialog</span></a> *about</code></em>,
<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *version</code></em>);</pre>
<em class="parameter"><code>const <span class="type">gchar</span> *version</code></em>);</pre>
<p>Sets the version string to display in the about dialog.</p>
<div class="refsect3">
<a name="gtk-about-dialog-set-version.parameters"></a><h4>Parameters</h4>
@ -636,7 +636,7 @@ gtk_about_dialog_set_version (<em class="parameter"><code><a class="link" href="
<hr>
<div class="refsect2">
<a name="gtk-about-dialog-get-copyright"></a><h3>gtk_about_dialog_get_copyright ()</h3>
<pre class="programlisting">const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
<pre class="programlisting">const <span class="returnvalue">gchar</span> *
gtk_about_dialog_get_copyright (<em class="parameter"><code><a class="link" href="GtkAboutDialog.html" title="GtkAboutDialog"><span class="type">GtkAboutDialog</span></a> *about</code></em>);</pre>
<p>Returns the copyright string.</p>
<div class="refsect3">
@ -666,7 +666,7 @@ dialog and must not be modified.</p>
<a name="gtk-about-dialog-set-copyright"></a><h3>gtk_about_dialog_set_copyright ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_about_dialog_set_copyright (<em class="parameter"><code><a class="link" href="GtkAboutDialog.html" title="GtkAboutDialog"><span class="type">GtkAboutDialog</span></a> *about</code></em>,
<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *copyright</code></em>);</pre>
<em class="parameter"><code>const <span class="type">gchar</span> *copyright</code></em>);</pre>
<p>Sets the copyright string to display in the about dialog.
This should be a short string of one or two lines.</p>
<div class="refsect3">
@ -696,7 +696,7 @@ This should be a short string of one or two lines.</p>
<hr>
<div class="refsect2">
<a name="gtk-about-dialog-get-comments"></a><h3>gtk_about_dialog_get_comments ()</h3>
<pre class="programlisting">const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
<pre class="programlisting">const <span class="returnvalue">gchar</span> *
gtk_about_dialog_get_comments (<em class="parameter"><code><a class="link" href="GtkAboutDialog.html" title="GtkAboutDialog"><span class="type">GtkAboutDialog</span></a> *about</code></em>);</pre>
<p>Returns the comments string.</p>
<div class="refsect3">
@ -726,7 +726,7 @@ dialog and must not be modified.</p>
<a name="gtk-about-dialog-set-comments"></a><h3>gtk_about_dialog_set_comments ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_about_dialog_set_comments (<em class="parameter"><code><a class="link" href="GtkAboutDialog.html" title="GtkAboutDialog"><span class="type">GtkAboutDialog</span></a> *about</code></em>,
<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *comments</code></em>);</pre>
<em class="parameter"><code>const <span class="type">gchar</span> *comments</code></em>);</pre>
<p>Sets the comments string to display in the about dialog.
This should be a short string of one or two lines.</p>
<div class="refsect3">
@ -756,7 +756,7 @@ This should be a short string of one or two lines.</p>
<hr>
<div class="refsect2">
<a name="gtk-about-dialog-get-license"></a><h3>gtk_about_dialog_get_license ()</h3>
<pre class="programlisting">const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
<pre class="programlisting">const <span class="returnvalue">gchar</span> *
gtk_about_dialog_get_license (<em class="parameter"><code><a class="link" href="GtkAboutDialog.html" title="GtkAboutDialog"><span class="type">GtkAboutDialog</span></a> *about</code></em>);</pre>
<p>Returns the license information.</p>
<div class="refsect3">
@ -786,10 +786,10 @@ dialog and must not be modified.</p>
<a name="gtk-about-dialog-set-license"></a><h3>gtk_about_dialog_set_license ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_about_dialog_set_license (<em class="parameter"><code><a class="link" href="GtkAboutDialog.html" title="GtkAboutDialog"><span class="type">GtkAboutDialog</span></a> *about</code></em>,
<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *license</code></em>);</pre>
<em class="parameter"><code>const <span class="type">gchar</span> *license</code></em>);</pre>
<p>Sets the license information to be displayed in the secondary
license dialog. If <em class="parameter"><code>license</code></em>
is <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, the license button is
is <code class="literal">NULL</code>, the license button is
hidden.</p>
<div class="refsect3">
<a name="gtk-about-dialog-set-license.parameters"></a><h4>Parameters</h4>
@ -807,7 +807,7 @@ hidden.</p>
</tr>
<tr>
<td class="parameter_name"><p>license</p></td>
<td class="parameter_description"><p>the license information or <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
<td class="parameter_description"><p>the license information or <code class="literal">NULL</code>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
</tbody>
@ -818,7 +818,7 @@ hidden.</p>
<hr>
<div class="refsect2">
<a name="gtk-about-dialog-get-wrap-license"></a><h3>gtk_about_dialog_get_wrap_license ()</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gtk_about_dialog_get_wrap_license (<em class="parameter"><code><a class="link" href="GtkAboutDialog.html" title="GtkAboutDialog"><span class="type">GtkAboutDialog</span></a> *about</code></em>);</pre>
<p>Returns whether the license text in <em class="parameter"><code>about</code></em>
is
@ -840,7 +840,7 @@ automatically wrapped.</p>
</div>
<div class="refsect3">
<a name="gtk-about-dialog-get-wrap-license.returns"></a><h4>Returns</h4>
<p> <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the license text is wrapped</p>
<p> <code class="literal">TRUE</code> if the license text is wrapped</p>
</div>
<p class="since">Since: 2.8</p>
</div>
@ -849,7 +849,7 @@ automatically wrapped.</p>
<a name="gtk-about-dialog-set-wrap-license"></a><h3>gtk_about_dialog_set_wrap_license ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_about_dialog_set_wrap_license (<em class="parameter"><code><a class="link" href="GtkAboutDialog.html" title="GtkAboutDialog"><span class="type">GtkAboutDialog</span></a> *about</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> wrap_license</code></em>);</pre>
<em class="parameter"><code><span class="type">gboolean</span> wrap_license</code></em>);</pre>
<p>Sets whether the license text in <em class="parameter"><code>about</code></em>
is
automatically wrapped.</p>
@ -942,7 +942,7 @@ list of known licenses.</p>
<hr>
<div class="refsect2">
<a name="gtk-about-dialog-get-website"></a><h3>gtk_about_dialog_get_website ()</h3>
<pre class="programlisting">const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
<pre class="programlisting">const <span class="returnvalue">gchar</span> *
gtk_about_dialog_get_website (<em class="parameter"><code><a class="link" href="GtkAboutDialog.html" title="GtkAboutDialog"><span class="type">GtkAboutDialog</span></a> *about</code></em>);</pre>
<p>Returns the website URL.</p>
<div class="refsect3">
@ -972,7 +972,7 @@ dialog and must not be modified.</p>
<a name="gtk-about-dialog-set-website"></a><h3>gtk_about_dialog_set_website ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_about_dialog_set_website (<em class="parameter"><code><a class="link" href="GtkAboutDialog.html" title="GtkAboutDialog"><span class="type">GtkAboutDialog</span></a> *about</code></em>,
<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *website</code></em>);</pre>
<em class="parameter"><code>const <span class="type">gchar</span> *website</code></em>);</pre>
<p>Sets the URL to use for the website link.</p>
<div class="refsect3">
<a name="gtk-about-dialog-set-website.parameters"></a><h4>Parameters</h4>
@ -1001,7 +1001,7 @@ gtk_about_dialog_set_website (<em class="parameter"><code><a class="link" href="
<hr>
<div class="refsect2">
<a name="gtk-about-dialog-get-website-label"></a><h3>gtk_about_dialog_get_website_label ()</h3>
<pre class="programlisting">const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
<pre class="programlisting">const <span class="returnvalue">gchar</span> *
gtk_about_dialog_get_website_label (<em class="parameter"><code><a class="link" href="GtkAboutDialog.html" title="GtkAboutDialog"><span class="type">GtkAboutDialog</span></a> *about</code></em>);</pre>
<p>Returns the label used for the website link.</p>
<div class="refsect3">
@ -1031,7 +1031,7 @@ owned by the about dialog and must not be modified.</p>
<a name="gtk-about-dialog-set-website-label"></a><h3>gtk_about_dialog_set_website_label ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_about_dialog_set_website_label (<em class="parameter"><code><a class="link" href="GtkAboutDialog.html" title="GtkAboutDialog"><span class="type">GtkAboutDialog</span></a> *about</code></em>,
<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *website_label</code></em>);</pre>
<em class="parameter"><code>const <span class="type">gchar</span> *website_label</code></em>);</pre>
<p>Sets the label to be used for the website link.</p>
<div class="refsect3">
<a name="gtk-about-dialog-set-website-label.parameters"></a><h4>Parameters</h4>
@ -1060,7 +1060,7 @@ gtk_about_dialog_set_website_label (<em class="parameter"><code><a class="link"
<hr>
<div class="refsect2">
<a name="gtk-about-dialog-get-authors"></a><h3>gtk_about_dialog_get_authors ()</h3>
<pre class="programlisting">const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * const *
<pre class="programlisting">const <span class="returnvalue">gchar</span> * const *
gtk_about_dialog_get_authors (<em class="parameter"><code><a class="link" href="GtkAboutDialog.html" title="GtkAboutDialog"><span class="type">GtkAboutDialog</span></a> *about</code></em>);</pre>
<p>Returns the string which are displayed in the authors tab
of the secondary credits dialog.</p>
@ -1082,7 +1082,7 @@ of the secondary credits dialog.</p>
<div class="refsect3">
<a name="gtk-about-dialog-get-authors.returns"></a><h4>Returns</h4>
<p>A
<a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated string array containing the authors. The array is
<code class="literal">NULL</code>-terminated string array containing the authors. The array is
owned by the about dialog and must not be modified. </p>
<p><span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> zero-terminated=1][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
@ -1093,7 +1093,7 @@ owned by the about dialog and must not be modified. </p>
<a name="gtk-about-dialog-set-authors"></a><h3>gtk_about_dialog_set_authors ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_about_dialog_set_authors (<em class="parameter"><code><a class="link" href="GtkAboutDialog.html" title="GtkAboutDialog"><span class="type">GtkAboutDialog</span></a> *about</code></em>,
<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **authors</code></em>);</pre>
<em class="parameter"><code>const <span class="type">gchar</span> **authors</code></em>);</pre>
<p>Sets the strings which are displayed in the authors tab
of the secondary credits dialog.</p>
<div class="refsect3">
@ -1112,7 +1112,7 @@ of the secondary credits dialog.</p>
</tr>
<tr>
<td class="parameter_name"><p>authors</p></td>
<td class="parameter_description"><p>a <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated array of strings. </p></td>
<td class="parameter_description"><p>a <code class="literal">NULL</code>-terminated array of strings. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> zero-terminated=1]</span></td>
</tr>
</tbody>
@ -1123,7 +1123,7 @@ of the secondary credits dialog.</p>
<hr>
<div class="refsect2">
<a name="gtk-about-dialog-get-artists"></a><h3>gtk_about_dialog_get_artists ()</h3>
<pre class="programlisting">const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * const *
<pre class="programlisting">const <span class="returnvalue">gchar</span> * const *
gtk_about_dialog_get_artists (<em class="parameter"><code><a class="link" href="GtkAboutDialog.html" title="GtkAboutDialog"><span class="type">GtkAboutDialog</span></a> *about</code></em>);</pre>
<p>Returns the string which are displayed in the artists tab
of the secondary credits dialog.</p>
@ -1145,7 +1145,7 @@ of the secondary credits dialog.</p>
<div class="refsect3">
<a name="gtk-about-dialog-get-artists.returns"></a><h4>Returns</h4>
<p>A
<a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated string array containing the artists. The array is
<code class="literal">NULL</code>-terminated string array containing the artists. The array is
owned by the about dialog and must not be modified. </p>
<p><span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> zero-terminated=1][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
@ -1156,7 +1156,7 @@ owned by the about dialog and must not be modified. </p>
<a name="gtk-about-dialog-set-artists"></a><h3>gtk_about_dialog_set_artists ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_about_dialog_set_artists (<em class="parameter"><code><a class="link" href="GtkAboutDialog.html" title="GtkAboutDialog"><span class="type">GtkAboutDialog</span></a> *about</code></em>,
<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **artists</code></em>);</pre>
<em class="parameter"><code>const <span class="type">gchar</span> **artists</code></em>);</pre>
<p>Sets the strings which are displayed in the artists tab
of the secondary credits dialog.</p>
<div class="refsect3">
@ -1175,7 +1175,7 @@ of the secondary credits dialog.</p>
</tr>
<tr>
<td class="parameter_name"><p>artists</p></td>
<td class="parameter_description"><p>a <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated array of strings. </p></td>
<td class="parameter_description"><p>a <code class="literal">NULL</code>-terminated array of strings. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> zero-terminated=1]</span></td>
</tr>
</tbody>
@ -1186,7 +1186,7 @@ of the secondary credits dialog.</p>
<hr>
<div class="refsect2">
<a name="gtk-about-dialog-get-documenters"></a><h3>gtk_about_dialog_get_documenters ()</h3>
<pre class="programlisting">const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * const *
<pre class="programlisting">const <span class="returnvalue">gchar</span> * const *
gtk_about_dialog_get_documenters (<em class="parameter"><code><a class="link" href="GtkAboutDialog.html" title="GtkAboutDialog"><span class="type">GtkAboutDialog</span></a> *about</code></em>);</pre>
<p>Returns the string which are displayed in the documenters
tab of the secondary credits dialog.</p>
@ -1208,7 +1208,7 @@ tab of the secondary credits dialog.</p>
<div class="refsect3">
<a name="gtk-about-dialog-get-documenters.returns"></a><h4>Returns</h4>
<p>A
<a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated string array containing the documenters. The
<code class="literal">NULL</code>-terminated string array containing the documenters. The
array is owned by the about dialog and must not be modified. </p>
<p><span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> zero-terminated=1][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
@ -1219,7 +1219,7 @@ array is owned by the about dialog and must not be modified. </p>
<a name="gtk-about-dialog-set-documenters"></a><h3>gtk_about_dialog_set_documenters ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_about_dialog_set_documenters (<em class="parameter"><code><a class="link" href="GtkAboutDialog.html" title="GtkAboutDialog"><span class="type">GtkAboutDialog</span></a> *about</code></em>,
<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **documenters</code></em>);</pre>
<em class="parameter"><code>const <span class="type">gchar</span> **documenters</code></em>);</pre>
<p>Sets the strings which are displayed in the documenters tab
of the secondary credits dialog.</p>
<div class="refsect3">
@ -1238,7 +1238,7 @@ of the secondary credits dialog.</p>
</tr>
<tr>
<td class="parameter_name"><p>documenters</p></td>
<td class="parameter_description"><p>a <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated array of strings. </p></td>
<td class="parameter_description"><p>a <code class="literal">NULL</code>-terminated array of strings. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> zero-terminated=1]</span></td>
</tr>
</tbody>
@ -1249,7 +1249,7 @@ of the secondary credits dialog.</p>
<hr>
<div class="refsect2">
<a name="gtk-about-dialog-get-translator-credits"></a><h3>gtk_about_dialog_get_translator_credits ()</h3>
<pre class="programlisting">const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
<pre class="programlisting">const <span class="returnvalue">gchar</span> *
gtk_about_dialog_get_translator_credits
(<em class="parameter"><code><a class="link" href="GtkAboutDialog.html" title="GtkAboutDialog"><span class="type">GtkAboutDialog</span></a> *about</code></em>);</pre>
<p>Returns the translator credits string which is displayed
@ -1282,7 +1282,7 @@ owned by the about dialog and must not be modified.</p>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_about_dialog_set_translator_credits
(<em class="parameter"><code><a class="link" href="GtkAboutDialog.html" title="GtkAboutDialog"><span class="type">GtkAboutDialog</span></a> *about</code></em>,
<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *translator_credits</code></em>);</pre>
<em class="parameter"><code>const <span class="type">gchar</span> *translator_credits</code></em>);</pre>
<p>Sets the translator credits string which is displayed in
the translators tab of the secondary credits dialog.</p>
<p>The intended use for this string is to display the translator
@ -1358,7 +1358,7 @@ gtk_about_dialog_get_logo (<em class="parameter"><code><a class="link" href="Gtk
<a name="gtk-about-dialog-get-logo.returns"></a><h4>Returns</h4>
<p>the pixbuf displayed as logo. The
pixbuf is owned by the about dialog. If you want to keep a
reference to it, you have to call <a href="https://developer.gnome.org/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-ref"><code class="function">g_object_ref()</code></a> on it. </p>
reference to it, you have to call <code class="function">g_object_ref()</code> on it. </p>
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
<p class="since">Since: 2.6</p>
@ -1370,7 +1370,7 @@ reference to it, you have to call <a href="https://developer.gnome.org/gobject/u
gtk_about_dialog_set_logo (<em class="parameter"><code><a class="link" href="GtkAboutDialog.html" title="GtkAboutDialog"><span class="type">GtkAboutDialog</span></a> *about</code></em>,
<em class="parameter"><code><a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf-struct"><span class="type">GdkPixbuf</span></a> *logo</code></em>);</pre>
<p>Sets the pixbuf to be displayed as logo in the about dialog.
If it is <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, the default window icon set with
If it is <code class="literal">NULL</code>, the default window icon set with
<a class="link" href="GtkWindow.html#gtk-window-set-default-icon" title="gtk_window_set_default_icon ()"><code class="function">gtk_window_set_default_icon()</code></a> will be used.</p>
<div class="refsect3">
<a name="gtk-about-dialog-set-logo.parameters"></a><h4>Parameters</h4>
@ -1388,7 +1388,7 @@ If it is <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros
</tr>
<tr>
<td class="parameter_name"><p>logo</p></td>
<td class="parameter_description"><p>a <a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf-struct"><span class="type">GdkPixbuf</span></a>, or <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
<td class="parameter_description"><p>a <a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf-struct"><span class="type">GdkPixbuf</span></a>, or <code class="literal">NULL</code>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
</tbody>
@ -1399,7 +1399,7 @@ If it is <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros
<hr>
<div class="refsect2">
<a name="gtk-about-dialog-get-logo-icon-name"></a><h3>gtk_about_dialog_get_logo_icon_name ()</h3>
<pre class="programlisting">const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
<pre class="programlisting">const <span class="returnvalue">gchar</span> *
gtk_about_dialog_get_logo_icon_name (<em class="parameter"><code><a class="link" href="GtkAboutDialog.html" title="GtkAboutDialog"><span class="type">GtkAboutDialog</span></a> *about</code></em>);</pre>
<p>Returns the icon name displayed as logo in the about dialog.</p>
<div class="refsect3">
@ -1421,7 +1421,7 @@ gtk_about_dialog_get_logo_icon_name (<em class="parameter"><code><a class="link"
<a name="gtk-about-dialog-get-logo-icon-name.returns"></a><h4>Returns</h4>
<p> the icon name displayed as logo. The string is
owned by the dialog. If you want to keep a reference
to it, you have to call <a href="https://developer.gnome.org/glib/unstable/glib-String-Utility-Functions.html#g-strdup"><code class="function">g_strdup()</code></a> on it.</p>
to it, you have to call <code class="function">g_strdup()</code> on it.</p>
</div>
<p class="since">Since: 2.6</p>
</div>
@ -1430,9 +1430,9 @@ to it, you have to call <a href="https://developer.gnome.org/glib/unstable/glib-
<a name="gtk-about-dialog-set-logo-icon-name"></a><h3>gtk_about_dialog_set_logo_icon_name ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_about_dialog_set_logo_icon_name (<em class="parameter"><code><a class="link" href="GtkAboutDialog.html" title="GtkAboutDialog"><span class="type">GtkAboutDialog</span></a> *about</code></em>,
<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *icon_name</code></em>);</pre>
<em class="parameter"><code>const <span class="type">gchar</span> *icon_name</code></em>);</pre>
<p>Sets the pixbuf to be displayed as logo in the about dialog.
If it is <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, the default window icon set with
If it is <code class="literal">NULL</code>, the default window icon set with
<a class="link" href="GtkWindow.html#gtk-window-set-default-icon" title="gtk_window_set_default_icon ()"><code class="function">gtk_window_set_default_icon()</code></a> will be used.</p>
<div class="refsect3">
<a name="gtk-about-dialog-set-logo-icon-name.parameters"></a><h4>Parameters</h4>
@ -1450,7 +1450,7 @@ If it is <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros
</tr>
<tr>
<td class="parameter_name"><p>icon_name</p></td>
<td class="parameter_description"><p>an icon name, or <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
<td class="parameter_description"><p>an icon name, or <code class="literal">NULL</code>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
</tbody>
@ -1463,8 +1463,8 @@ If it is <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros
<a name="gtk-about-dialog-add-credit-section"></a><h3>gtk_about_dialog_add_credit_section ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_about_dialog_add_credit_section (<em class="parameter"><code><a class="link" href="GtkAboutDialog.html" title="GtkAboutDialog"><span class="type">GtkAboutDialog</span></a> *about</code></em>,
<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *section_name</code></em>,
<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **people</code></em>);</pre>
<em class="parameter"><code>const <span class="type">gchar</span> *section_name</code></em>,
<em class="parameter"><code>const <span class="type">gchar</span> **people</code></em>);</pre>
<p>Creates a new section in the Credits page.</p>
<div class="refsect3">
<a name="gtk-about-dialog-add-credit-section.parameters"></a><h4>Parameters</h4>
@ -1500,7 +1500,7 @@ gtk_about_dialog_add_credit_section (<em class="parameter"><code><a class="link"
<a name="gtk-show-about-dialog"></a><h3>gtk_show_about_dialog ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_show_about_dialog (<em class="parameter"><code><a class="link" href="GtkWindow.html" title="GtkWindow"><span class="type">GtkWindow</span></a> *parent</code></em>,
<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *first_property_name</code></em>,
<em class="parameter"><code>const <span class="type">gchar</span> *first_property_name</code></em>,
<em class="parameter"><code>...</code></em>);</pre>
<p>This is a convenience function for showing an applications about box.
The constructed dialog is associated with the parent window and
@ -1516,7 +1516,7 @@ reused for future invocations of this function.</p>
<tbody>
<tr>
<td class="parameter_name"><p>parent</p></td>
<td class="parameter_description"><p>transient parent, or <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> for none. </p></td>
<td class="parameter_description"><p>transient parent, or <code class="literal">NULL</code> for none. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
<tr>
@ -1526,7 +1526,7 @@ reused for future invocations of this function.</p>
</tr>
<tr>
<td class="parameter_name"><p>...</p></td>
<td class="parameter_description"><p>value of first property, followed by more properties, <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated</p></td>
<td class="parameter_description"><p>value of first property, followed by more properties, <code class="literal">NULL</code>-terminated</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
@ -1673,8 +1673,8 @@ only private fields and should not be directly accessed.</p>
<a name="GtkAboutDialog.property-details"></a><h2>Property Details</h2>
<div class="refsect2">
<a name="GtkAboutDialog--artists"></a><h3>The <code class="literal">“artists”</code> property</h3>
<pre class="programlisting"> “artists” <a href="https://developer.gnome.org/glib/unstable/glib-String-Utility-Functions.html#GStrv"><span class="type">GStrv</span></a></pre>
<p>The people who contributed artwork to the program, as a <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated
<pre class="programlisting"> “artists” <span class="type">GStrv</span></pre>
<p>The people who contributed artwork to the program, as a <code class="literal">NULL</code>-terminated
array of strings. Each string may contain email addresses and URLs, which
will be displayed as links, see the introduction for more details.</p>
<p>Flags: Read / Write</p>
@ -1683,8 +1683,8 @@ will be displayed as links, see the introduction for more details.</p>
<hr>
<div class="refsect2">
<a name="GtkAboutDialog--authors"></a><h3>The <code class="literal">“authors”</code> property</h3>
<pre class="programlisting"> “authors” <a href="https://developer.gnome.org/glib/unstable/glib-String-Utility-Functions.html#GStrv"><span class="type">GStrv</span></a></pre>
<p>The authors of the program, as a <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated array of strings.
<pre class="programlisting"> “authors” <span class="type">GStrv</span></pre>
<p>The authors of the program, as a <code class="literal">NULL</code>-terminated array of strings.
Each string may contain email addresses and URLs, which will be displayed
as links, see the introduction for more details.</p>
<p>Flags: Read / Write</p>
@ -1693,7 +1693,7 @@ as links, see the introduction for more details.</p>
<hr>
<div class="refsect2">
<a name="GtkAboutDialog--comments"></a><h3>The <code class="literal">“comments”</code> property</h3>
<pre class="programlisting"> “comments” <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre>
<pre class="programlisting"> “comments” <span class="type">gchar</span> *</pre>
<p>Comments about the program. This string is displayed in a label
in the main dialog, thus it should be a short explanation of
the main purpose of the program, not a detailed list of features.</p>
@ -1704,7 +1704,7 @@ the main purpose of the program, not a detailed list of features.</p>
<hr>
<div class="refsect2">
<a name="GtkAboutDialog--copyright"></a><h3>The <code class="literal">“copyright”</code> property</h3>
<pre class="programlisting"> “copyright” <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre>
<pre class="programlisting"> “copyright” <span class="type">gchar</span> *</pre>
<p>Copyright information for the program.</p>
<p>Flags: Read / Write</p>
<p>Default value: NULL</p>
@ -1713,8 +1713,8 @@ the main purpose of the program, not a detailed list of features.</p>
<hr>
<div class="refsect2">
<a name="GtkAboutDialog--documenters"></a><h3>The <code class="literal">“documenters”</code> property</h3>
<pre class="programlisting"> “documenters” <a href="https://developer.gnome.org/glib/unstable/glib-String-Utility-Functions.html#GStrv"><span class="type">GStrv</span></a></pre>
<p>The people documenting the program, as a <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated array of strings.
<pre class="programlisting"> “documenters” <span class="type">GStrv</span></pre>
<p>The people documenting the program, as a <code class="literal">NULL</code>-terminated array of strings.
Each string may contain email addresses and URLs, which will be displayed
as links, see the introduction for more details.</p>
<p>Flags: Read / Write</p>
@ -1723,13 +1723,13 @@ as links, see the introduction for more details.</p>
<hr>
<div class="refsect2">
<a name="GtkAboutDialog--license"></a><h3>The <code class="literal">“license”</code> property</h3>
<pre class="programlisting"> “license” <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre>
<pre class="programlisting"> “license” <span class="type">gchar</span> *</pre>
<p>The license of the program. This string is displayed in a
text view in a secondary dialog, therefore it is fine to use
a long multi-paragraph text. Note that the text is only wrapped
in the text view if the "wrap-license" property is set to <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>;
in the text view if the "wrap-license" property is set to <code class="literal">TRUE</code>;
otherwise the text itself must contain the intended linebreaks.
When setting this property to a non-<a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> value, the
When setting this property to a non-<code class="literal">NULL</code> value, the
<a class="link" href="GtkAboutDialog.html#GtkAboutDialog--license-type" title="The “license-type” property"><span class="type">“license-type”</span></a> property is set to <a class="link" href="GtkAboutDialog.html#GTK-LICENSE-CUSTOM:CAPS"><code class="literal">GTK_LICENSE_CUSTOM</code></a>
as a side effect.</p>
<p>Flags: Read / Write</p>
@ -1759,7 +1759,7 @@ a side effect.</p>
<div class="refsect2">
<a name="GtkAboutDialog--logo"></a><h3>The <code class="literal">“logo”</code> property</h3>
<pre class="programlisting"> “logo” <a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-The-GdkPixbuf-Structure.html#GdkPixbuf-struct"><span class="type">GdkPixbuf</span></a> *</pre>
<p>A logo for the about box. If it is <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, the default window icon
<p>A logo for the about box. If it is <code class="literal">NULL</code>, the default window icon
set with <a class="link" href="GtkWindow.html#gtk-window-set-default-icon" title="gtk_window_set_default_icon ()"><code class="function">gtk_window_set_default_icon()</code></a> will be used.</p>
<p>Flags: Read / Write</p>
<p class="since">Since: 2.6</p>
@ -1767,7 +1767,7 @@ set with <a class="link" href="GtkWindow.html#gtk-window-set-default-icon" title
<hr>
<div class="refsect2">
<a name="GtkAboutDialog--logo-icon-name"></a><h3>The <code class="literal">“logo-icon-name”</code> property</h3>
<pre class="programlisting"> “logo-icon-name” <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre>
<pre class="programlisting"> “logo-icon-name” <span class="type">gchar</span> *</pre>
<p>A named icon to use as the logo for the about box. This property
overrides the <a class="link" href="GtkAboutDialog.html#GtkAboutDialog--logo" title="The “logo” property"><span class="type">“logo”</span></a> property.</p>
<p>Flags: Read / Write</p>
@ -1777,9 +1777,9 @@ overrides the <a class="link" href="GtkAboutDialog.html#GtkAboutDialog--logo" ti
<hr>
<div class="refsect2">
<a name="GtkAboutDialog--program-name"></a><h3>The <code class="literal">“program-name”</code> property</h3>
<pre class="programlisting"> “program-name” <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre>
<pre class="programlisting"> “program-name” <span class="type">gchar</span> *</pre>
<p>The name of the program.
If this is not set, it defaults to <a href="https://developer.gnome.org/glib/unstable/glib-Miscellaneous-Utility-Functions.html#g-get-application-name"><code class="function">g_get_application_name()</code></a>.</p>
If this is not set, it defaults to <code class="function">g_get_application_name()</code>.</p>
<p>Flags: Read / Write</p>
<p>Default value: NULL</p>
<p class="since">Since: 2.12</p>
@ -1787,7 +1787,7 @@ If this is not set, it defaults to <a href="https://developer.gnome.org/glib/uns
<hr>
<div class="refsect2">
<a name="GtkAboutDialog--translator-credits"></a><h3>The <code class="literal">“translator-credits”</code> property</h3>
<pre class="programlisting"> “translator-credits” <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre>
<pre class="programlisting"> “translator-credits” <span class="type">gchar</span> *</pre>
<p>Credits to the translators. This string should be marked as translatable.
The string may contain email addresses and URLs, which will be displayed
as links, see the introduction for more details.</p>
@ -1798,7 +1798,7 @@ as links, see the introduction for more details.</p>
<hr>
<div class="refsect2">
<a name="GtkAboutDialog--version"></a><h3>The <code class="literal">“version”</code> property</h3>
<pre class="programlisting"> “version” <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre>
<pre class="programlisting"> “version” <span class="type">gchar</span> *</pre>
<p>The version of the program.</p>
<p>Flags: Read / Write</p>
<p>Default value: NULL</p>
@ -1807,7 +1807,7 @@ as links, see the introduction for more details.</p>
<hr>
<div class="refsect2">
<a name="GtkAboutDialog--website"></a><h3>The <code class="literal">“website”</code> property</h3>
<pre class="programlisting"> “website” <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre>
<pre class="programlisting"> “website” <span class="type">gchar</span> *</pre>
<p>The URL for the link to the website of the program.
This should be a string starting with "http://.</p>
<p>Flags: Read / Write</p>
@ -1817,7 +1817,7 @@ This should be a string starting with "http://.</p>
<hr>
<div class="refsect2">
<a name="GtkAboutDialog--website-label"></a><h3>The <code class="literal">“website-label”</code> property</h3>
<pre class="programlisting"> “website-label” <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre>
<pre class="programlisting"> “website-label” <span class="type">gchar</span> *</pre>
<p>The label for the link to the website of the program.</p>
<p>Flags: Read / Write</p>
<p>Default value: NULL</p>
@ -1826,7 +1826,7 @@ This should be a string starting with "http://.</p>
<hr>
<div class="refsect2">
<a name="GtkAboutDialog--wrap-license"></a><h3>The <code class="literal">“wrap-license”</code> property</h3>
<pre class="programlisting"> “wrap-license” <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></pre>
<pre class="programlisting"> “wrap-license” <span class="type">gboolean</span></pre>
<p>Whether to wrap the text in the license dialog.</p>
<p>Flags: Read / Write</p>
<p>Default value: FALSE</p>
@ -1837,10 +1837,10 @@ This should be a string starting with "http://.</p>
<a name="GtkAboutDialog.signal-details"></a><h2>Signal Details</h2>
<div class="refsect2">
<a name="GtkAboutDialog-activate-link"></a><h3>The <code class="literal">“activate-link”</code> signal</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
user_function (<a class="link" href="GtkAboutDialog.html" title="GtkAboutDialog"><span class="type">GtkAboutDialog</span></a> *label,
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *uri,
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)</pre>
<span class="type">gchar</span> *uri,
<span class="type">gpointer</span> user_data)</pre>
<p>The signal which gets emitted to activate a URI.
Applications may connect to it to override the default behaviour,
which is to call <a class="link" href="gtk3-Filesystem-utilities.html#gtk-show-uri-on-window" title="gtk_show_uri_on_window ()"><code class="function">gtk_show_uri_on_window()</code></a>.</p>
@ -1873,9 +1873,9 @@ which is to call <a class="link" href="gtk3-Filesystem-utilities.html#gtk-show-u
</div>
<div class="refsect3">
<a name="GtkAboutDialog-activate-link.returns"></a><h4>Returns</h4>
<p> <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the link has been activated</p>
<p> <code class="literal">TRUE</code> if the link has been activated</p>
</div>
<p>Flags: <a href="https://developer.gnome.org/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS">Run Last</a></p>
<p>Flags: Run Last</p>
<p class="since">Since: 2.24</p>
</div>
</div>