changeset
Convert pidgin from gtk-doc to gi-docgen
Tue, 19 Oct 2021 02:49:28 -0500
- author
- Gary Kramlich <grim@reaperworld.com>
- date
- Tue, 19 Oct 2021 02:49:28 -0500
- changeset 41124
- 95555046173e
- parent 41123
- 089c8a3a9ff4
- child 41125
- d6a7bf9208e1
Convert pidgin from gtk-doc to gi-docgen
Testing Done:
Ran the docs locally and in convey.
Reviewed at https://reviews.imfreedom.org/r/1076/
--- a/convey.yaml Tue Oct 19 00:48:05 2021 -0500 +++ b/convey.yaml Tue Oct 19 02:49:28 2021 -0500 @@ -47,7 +47,7 @@ files: - build-docs/doc/reference/finch/finch/:finch3-docs - build-docs/doc/reference/libpurple/html/:purple3-docs - - build-docs/doc/reference/pidgin/html/:pidgin3-docs + - build-docs/doc/reference/pidgin/pidgin/:pidgin3-docs - build-docs/doc/reference/protocols/facebook/facebook/:facebook3-docs export:
--- a/doc/reference/pidgin/meson.build Tue Oct 19 00:48:05 2021 -0500 +++ b/doc/reference/pidgin/meson.build Tue Oct 19 02:49:28 2021 -0500 @@ -1,54 +1,36 @@ -DOC_MODULE = 'pidgin' - -# Header files or dirs to ignore when scanning. Use base file/dir names -ignore_hfiles = [ - 'pixmaps', - 'plugins', - 'themes', - 'win32', - 'gtkinternal.h', - 'pidgin.gresource.h', - 'pidginprivate.h', -] - -# Extra options to supply to gtkdoc-scan. -scan_args = [ - '--deprecated-guards=PURPLE_DISABLE_DEPRECATED|PIDGIN_DISABLE_DEPRECATED', - '--rebuild-types', - '--rebuild-sections', - '--ignore-headers=' + ' '.join(ignore_hfiles), -] - -# Extra options to supply to gtkdoc-mkdb. -mkdb_args = [ - '--ignore-files=' + ' '.join(ignore_hfiles), +pidgin_doc_content_files = [ + 'signals_gtkaccount.md', + 'signals_gtkblist.md', + 'signals_gtkconv.md', ] -# Extra options to supply to fixxref -fixxref_args = [ - '--extra-dir=../libpurple', -] - -configure_file( - input : 'version.xml.in', - output : 'version.xml', - configuration : version_conf) +if get_option('doc') + pidgin_toml = configure_file( + input : 'pidgin.toml.in', + output : 'pidgin.toml', + configuration : version_conf, + install : true, + install_dir : docs_dir / 'pidgin', + ) -# Extra SGML files that are included by $(DOC_MAIN_XML_FILE). -content_files = [ - 'signals_gtkaccount.xml', - 'signals_gtkblist.xml', - 'signals_gtkconv.xml', - 'signals_gtklog.xml', -] + pidgin_doc = custom_target('pidgin-doc', + input : [ pidgin_toml, pidgin_gir[0] ], + output : 'pidgin', + command : [ + gidocgen, + 'generate', + '--quiet', + '--fatal-warnings', + '--config=@INPUT0@', + '--output-dir=@OUTPUT@', + '--no-namespace-dir', + '--content-dir=@0@'.format(meson.current_source_dir()), + '@INPUT1@' + ], + depend_files : [ pidgin_doc_content_files ], + build_by_default : true, + install : true, + install_dir : docs_dir, + ) +endif -pidgin_doc = gnome.gtkdoc(DOC_MODULE, - main_xml : DOC_MODULE + '-docs.xml', - src_dir : libpidgin_inc, - dependencies : libpidgin_dep, - install : true, - scan_args : scan_args, - mkdb_args : mkdb_args, - fixxref_args : fixxref_args, - gobject_typesfile : DOC_MODULE + '.types', - content_files : content_files)
--- a/doc/reference/pidgin/pidgin-docs.xml Tue Oct 19 00:48:05 2021 -0500 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,121 +0,0 @@ -<?xml version="1.0"?> -<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" - "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [ - -<!ENTITY % local.common.attrib "xmlns:xi CDATA #FIXED 'http://www.w3.org/2003/XInclude'"> -<!ENTITY version SYSTEM "version.xml"> -]> -<book id="index" xmlns:xi="http://www.w3.org/2003/XInclude"> - <bookinfo> - <title>Pidgin Reference Manual</title> - <abstract> - <title>Pidgin &version;</title> - <para> - Pidgin is a GTK+ frontend to libpurple. - </para> - </abstract> - </bookinfo> - - <part id="API"> - <title>API Reference</title> - - <xi:include href="xml/gtkaccount.xml" /> - <xi:include href="xml/gtkblist.xml" /> - <xi:include href="xml/gtkconn.xml" /> - <xi:include href="xml/gtkconv.xml" /> - <xi:include href="xml/gtkconvwin.xml" /> - <xi:include href="xml/gtkdialogs.xml" /> - <xi:include href="xml/gtkdnd-hints.xml" /> - <xi:include href="xml/gtkicon-theme-loader.xml" /> - <xi:include href="xml/gtkicon-theme.xml" /> - <xi:include href="xml/gtkidle.xml" /> - <xi:include href="xml/gtkmedia.xml" /> - <xi:include href="xml/gtknotify.xml" /> - <xi:include href="xml/gtkpluginpref.xml" /> - <xi:include href="xml/gtkprivacy.xml" /> - <xi:include href="xml/gtkrequest.xml" /> - <xi:include href="xml/gtkroomlist.xml" /> - <xi:include href="xml/gtksavedstatuses.xml" /> - <xi:include href="xml/gtkstatus-icon-theme.xml" /> - <xi:include href="xml/gtkstatusbox.xml" /> - <xi:include href="xml/gtkutils.xml" /> - <xi:include href="xml/gtkwhiteboard.xml" /> - <xi:include href="xml/gtkxfer.xml" /> - <xi:include href="xml/minidialog.xml" /> - <xi:include href="xml/pidgin.xml" /> - <xi:include href="xml/pidginabout.xml" /> - <xi:include href="xml/pidginaccountactionsmenu.xml" /> - <xi:include href="xml/pidginaccountchooser.xml" /> - <xi:include href="xml/pidginaccountfilterconnected.xml" /> - <xi:include href="xml/pidginaccountfilterprotocol.xml" /> - <xi:include href="xml/pidginaccountsmenu.xml" /> - <xi:include href="xml/pidginaccountstore.xml" /> - <xi:include href="xml/pidginactiongroup.xml" /> - <xi:include href="xml/pidginapplication.xml" /> - <xi:include href="xml/pidginattachment.xml" /> - <xi:include href="xml/pidginavatar.xml" /> - <xi:include href="xml/pidgincellrendererexpander.xml" /> - <xi:include href="xml/pidginclosebutton.xml" /> - <xi:include href="xml/pidgincolor.xml" /> - <xi:include href="xml/pidgincontactcompletion.xml" /> - <xi:include href="xml/pidgincontactlist.xml" /> - <xi:include href="xml/pidginconversationwindow.xml" /> - <xi:include href="xml/pidgincore.xml" /> - <xi:include href="xml/pidgincredentialproviderrow.xml" /> - <xi:include href="xml/pidgincredentialspage.xml" /> - <xi:include href="xml/pidgindebug.xml" /> - <xi:include href="xml/pidgindialog.xml" /> - <xi:include href="xml/pidgingdkpixbuf.xml" /> - <xi:include href="xml/pidginiconname.xml" /> - <xi:include href="xml/pidgininfopane.xml" /> - <xi:include href="xml/pidgininvitedialog.xml" /> - <xi:include href="xml/pidginmenutray.xml" /> - <xi:include href="xml/pidginmessage.xml" /> - <xi:include href="xml/pidginmooddialog.xml" /> - <xi:include href="xml/pidginplugininfo.xml" /> - <xi:include href="xml/pidginpluginsdialog.xml" /> - <xi:include href="xml/pidginpluginsmenu.xml" /> - <xi:include href="xml/pidginprefs.xml" /> - <xi:include href="xml/pidginpresenceicon.xml" /> - <xi:include href="xml/pidginprotocolchooser.xml" /> - <xi:include href="xml/pidginprotocolstore.xml" /> - <xi:include href="xml/pidginscrollbook.xml" /> - <xi:include href="xml/pidginstock.xml" /> - <xi:include href="xml/pidginstylecontext.xml" /> - <xi:include href="xml/pidgintalkatu.xml" /> - </part> - - <part id="signals"> - <title>Purple-signals Reference</title> - - <xi:include href="signals_gtkaccount.xml" /> - <xi:include href="signals_gtkblist.xml" /> - <xi:include href="signals_gtkconv.xml" /> - <xi:include href="signals_gtklog.xml" /> - </part> - - <part> - <title>Appendices</title> - - <index id="api-index-full"> - <title>API Index</title> - <xi:include href="xml/api-index-full.xml"><xi:fallback /></xi:include> - </index> - - <index id="api-deprecated"> - <title>Index of deprecated symbols</title> - <xi:include href="xml/api-index-deprecated.xml"><xi:fallback /></xi:include> - </index> - - <index id="api-3.0.0"> - <title>Index of new symbols in 3.0.0</title> - <xi:include href="xml/api-index-3.0.0.xml"><xi:fallback /></xi:include> - </index> - <index id="api-2.10.0"> - <title>Index of new symbols in 2.10.0</title> - <xi:include href="xml/api-index-2.10.0.xml"><xi:fallback /></xi:include> - </index> - - <xi:include href="xml/annotation-glossary.xml"><xi:fallback /></xi:include> - </part> -</book>
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/doc/reference/pidgin/pidgin.toml.in Tue Oct 19 02:49:28 2021 -0500 @@ -0,0 +1,66 @@ +[library] +version = "@PURPLE_VERSION@" +browse_url = "https://keep.imfreedom.org/pidgin/pidgin/" +repository_url = "https://keep.imfreedom.org/pidgin/pidgin/" +website_url = "https://keep.imfreedom.org/pidgin/pidgin/" +authors = "Pidgin Developers" +logo_url = "" +license = "GPL-2.0-or-later" +description = "Pidgin Universal Chat Client" +dependencies = [ "GLib-2.0", "GObject-2.0", "Gtk-3.0", "Purple-3.0", "GPlugin-1.0", "GPlugin-Gtk3-1.0", "Talkatu-0.0" ] +devhelp = true +search_index = true + + [dependencies."GLib-2.0"] + name = "GLib" + description = "General-purpose, portable utility library." + docs_url = "https://docs.gtk.org/glib/" + + [dependencies."GObject-2.0"] + name = "GObject" + description = "The base type system library" + docs_url = "https://docs.gtk.org/gobject/" + + [dependencies."Gtk-3.0"] + name = "Gtk" + description = "The GTK toolkit" + docs_url = "https://docs.gtk.org/gtk3/" + + [dependencies."Purple-3.0"] + name = "Purple" + description = "Purple Universal Chat Library" + docs_url = "https://docs.imfreedom.org/purple3/" + + [dependencies."GPlugin-1.0"] + name = "GPlugin" + description = "GPlugin Plugin Library" + docs_urls = "https://docs.imfreedom.org/gplugin/" + + [dependencies."GPlugin-Gtk3-1.0"] + name = "GPlugin-Gtk3" + description = "GPlugin Gtk3 Widget Library" + docs_urls = "https://docs.imfreedom.org/gplugin-gtk3/" + + [dependencies."Talkatu-0.0"] + name = "Talkatu" + description = "Talkatu Gtk3 Chat Widgets" + docs_urls = "https://docs.imfreedom.org/talkatu/" + +[theme] +name = "basic" +show_index_summary = true +show_class_hierarchy = true + +[source-location] +base_url = "https://keep.imfreedom.org/pidgin/pidgin/file/default/" + +[extra] +# The same order will be used when generating the index +content_files = [ + "signals_gtkaccount.md", + "signals_gtkblist.md", + "signals_gtkconv.md", +] +content_images = [ +] +urlmap_file = "urlmap.js"
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/doc/reference/pidgin/signals_gtkaccount.md Tue Oct 19 02:49:28 2021 -0500 @@ -0,0 +1,21 @@ +Title: Account Signals +Slug: account-signals + +## Account Signals + +### account-modified + +```c +void user_function(PurpleAccount *account, gpointer user_data); +``` + +Emitted when the settings for an account have been changed and saved. + +**Parameters:** + +**account** +: The account that has been modified. + +**user_data** +: User data set when the signal handler was connected. +
--- a/doc/reference/pidgin/signals_gtkaccount.xml Tue Oct 19 00:48:05 2021 -0500 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,41 +0,0 @@ -<?xml version='1.0' encoding="ISO-8859-1"?> -<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" - "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [ -]> -<chapter id="chapter-signals-gtkaccount"> -<title>Account signals</title> - -<refsect1 id="gtkaccounts.signals" role="signal_proto"> -<title role="signal_proto.title">List of signals</title> -<synopsis> - "<link linkend="gtkaccounts-account-modified">account-modified</link>" -</synopsis> -</refsect1> - -<refsect1 id="gtkaccounts.signal-details" role="signals"> -<title role="signals.title">Signal details</title> - -<refsect2 id="gtkaccounts-account-modified" role="signal"> - <title>The <literal>"account-modified"</literal> signal</title> -<programlisting> -void user_function (PurpleAccount *account, - gpointer user_data) -</programlisting> - <para> -Emitted when the settings for an account have been changed and saved. - </para> - <variablelist role="params"> - <varlistentry> - <term><parameter>account</parameter> :</term> - <listitem><simpara>The account that has been modified.</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter>user_data</parameter> :</term> - <listitem><simpara>user data set when the signal handler was connected.</simpara></listitem> - </varlistentry> - </variablelist> -</refsect2> - -</refsect1> - -</chapter>
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/doc/reference/pidgin/signals_gtkblist.md Tue Oct 19 02:49:28 2021 -0500 @@ -0,0 +1,98 @@ +Title: Buddy List Signals +Slug: blist-signals + +## Buddy List Signals + +### gtkblist-hiding + +```c +void user_function(PurpleBuddyList *blist, gpointer user_data); +``` + +Emitted when the buddy list is about to be hidden. + +**Parameters:** + +**blist** +: The buddy list. + +**user_data** +: User data set when the signal handler was connected. + +### gtkblist-unhiding + +```c +void user_function(PurpleBuddyList *blist, gpointer user_data); +``` +Emitted when the buddy list is about to be unhidden. + +**Parameters:** + +**blist** +: The buddy list. + +**user_data** +: User data set when the signal handler was connected. + +### gtkblist-created + +```c +void user_function(PurpleBuddyList *blist, gpointer user_data); +``` + +Emitted when the buddy list is created. + +**Parameters:** + +**blist** +: The buddy list. + +**user_data** +: User data set when the signal handler was connected. + +### drawing-tooltip + +```c +void user_function(PurpleBlistNode *node, GString *text, gboolean full, gpointer user_data); +``` + +Emitted just before a tooltip is displayed. `text` is a standard GString, so +the plugin can modify the text that will be displayed. + +**Parameters:** + +**node** +: The blist node for the tooltip. + +**text** +: A pointer to the text that will be displayed. + +**full** +: Whether we're doing a full tooltip for the priority buddy or a compact +tooltip for a non-priority buddy. + +**user_data** +: User data set when the signal handler was connected. + +### drawing-buddy + +```c +char *user_function(PurpleBuddy *buddy, gpointer user_data); +``` + +Emitted to allow plugins to handle markup within a buddy's name or to override +the default of no formatting for names shown in the buddy list. + +**Parameters:** + +**buddy** +: A pointer to the PupleBuddy that will be displayed. + +**user_data** +: User data set when the signal handler was connected. + +**Returns:** + +The text to display (must be allocated), or `NULL` if no changes to the default +behavior are desired. +
--- a/doc/reference/pidgin/signals_gtkblist.xml Tue Oct 19 00:48:05 2021 -0500 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,146 +0,0 @@ -<?xml version='1.0' encoding="ISO-8859-1"?> -<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" - "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [ -]> -<chapter id="chapter-signals-gtkblist"> -<title>Buddy List signals</title> - -<refsect1 id="gtkblist.signals" role="signal_proto"> -<title role="signal_proto.title">List of signals</title> -<synopsis> - "<link linkend="gtkblist-gtkblist-hiding">gtkblist-hiding</link>" - "<link linkend="gtkblist-gtkblist-unhiding">gtkblist-unhiding</link>" - "<link linkend="gtkblist-gtkblist-created">gtkblist-created</link>" - "<link linkend="gtkblist-drawing-tooltip">drawing-tooltip</link>" - "<link linkend="gtkblist-drawing-buddy">drawing-buddy</link>" -</synopsis> -</refsect1> - -<refsect1 id="gtkblist.signal-details" role="signals"> -<title role="signals.title">Signal details</title> - -<refsect2 id="gtkblist-gtkblist-hiding" role="signal"> - <title>The <literal>"gtkblist-hiding"</literal> signal</title> -<programlisting> -void user_function (PurpleBuddyList *blist, - gpointer user_data) -</programlisting> - <para> -Emitted when the buddy list is about to be hidden. - </para> - <variablelist role="params"> - <varlistentry> - <term><parameter>blist</parameter> :</term> - <listitem><simpara>The buddy list.</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter>user_data</parameter> :</term> - <listitem><simpara>user data set when the signal handler was connected.</simpara></listitem> - </varlistentry> - </variablelist> -</refsect2> - -<refsect2 id="gtkblist-gtkblist-unhiding" role="signal"> - <title>The <literal>"gtkblist-unhiding"</literal> signal</title> -<programlisting> -void user_function (PurpleBuddyList *blist, - gpointer user_data) -</programlisting> - <para> -Emitted when the buddy list is about to be unhidden. - </para> - <variablelist role="params"> - <varlistentry> - <term><parameter>blist</parameter> :</term> - <listitem><simpara>The buddy list.</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter>user_data</parameter> :</term> - <listitem><simpara>user data set when the signal handler was connected.</simpara></listitem> - </varlistentry> - </variablelist> -</refsect2> - -<refsect2 id="gtkblist-gtkblist-created" role="signal"> - <title>The <literal>"gtkblist-created"</literal> signal</title> -<programlisting> -void user_function (PurpleBuddyList *blist, - gpointer user_data) -</programlisting> - <para> -Emitted when the buddy list is created. - </para> - <variablelist role="params"> - <varlistentry> - <term><parameter>blist</parameter> :</term> - <listitem><simpara>The buddy list.</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter>user_data</parameter> :</term> - <listitem><simpara>user data set when the signal handler was connected.</simpara></listitem> - </varlistentry> - </variablelist> -</refsect2> - -<refsect2 id="gtkblist-drawing-tooltip" role="signal"> - <title>The <literal>"drawing-tooltip"</literal> signal</title> -<programlisting> -void user_function (PurpleBlistNode *node, - GString *text, - gboolean full, - gpointer user_data) -</programlisting> - <para> -Emitted just before a tooltip is displayed. <literal>text</literal> is a standard GString, so the plugin can modify the text that will be displayed. - </para> - <note><para> -Make sure to free <literal>*text</literal> before you replace it! - </para></note> - <variablelist role="params"> - <varlistentry> - <term><parameter>node</parameter> :</term> - <listitem><simpara>The blist node for the tooltip.</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter>text</parameter> :</term> - <listitem><simpara>A pointer to the text that will be displayed.</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter>full</parameter> :</term> - <listitem><simpara>Whether we're doing a full tooltip for the priority buddy or a compact tooltip for a non-priority buddy.</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter>user_data</parameter> :</term> - <listitem><simpara>user data set when the signal handler was connected.</simpara></listitem> - </varlistentry> - </variablelist> -</refsect2> - -<refsect2 id="gtkblist-drawing-buddy" role="signal"> - <title>The <literal>"drawing-buddy"</literal> signal</title> -<programlisting> -char * user_function (PurpleBuddy *buddy, - gpointer user_data) -</programlisting> - <para> -Emitted to allow plugins to handle markup within a buddy's name or to override the default of no formatting for names shown in the buddy list. - </para> - <variablelist role="params"> - <varlistentry> - <term><parameter>buddy</parameter> :</term> - <listitem><simpara>A pointer to the PurpleBuddy that will be displayed.</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter>user_data</parameter> :</term> - <listitem><simpara>user data set when the signal handler was connected.</simpara></listitem> - </varlistentry> - <varlistentry> - <term><emphasis>Returns</emphasis> :</term> - <listitem><simpara>The text to display (must be allocated), or <literal>NULL</literal> if no changes to the default behavior are desired.</simpara></listitem> - </varlistentry> - </variablelist> -</refsect2> - -</refsect1> - -</chapter>
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/doc/reference/pidgin/signals_gtkconv.md Tue Oct 19 02:49:28 2021 -0500 @@ -0,0 +1,189 @@ +Title: Conversation Signals +Slug: conversation-signals + +## Conversation signals + +### displaying-im-msg + +```c +gboolean +user_function(PurpleAccount *account, + const gchar *who, + gchar **message, + PurpleConversation *conv, + PurpleMessageFlags flags, + gpointer user_data); +``` + +Emitted just before a message is displayed in an IM conversation. `message` is +a pointer to a string, so the plugin can replace the message that will be +displayed. This can also be used to cancel displaying a message by returning +`TRUE`. + +> **NOTE:** Make sure to free `*message` before you replace it! + +**Parameters:** + +**account** +: The account. + +**who** +: The name of the user. + +**message** +: A pointer to the message. + +**conv** +: The conversation. + +**flags** +: Flags for this message. + +**user_data** +: User data set when the signal handler was connected. + +**Returns:** + +`TRUE` if the message should be canceled, or `FALSE` otherwise. + +## displayed-im-msg + +```c +void +user_function(PurpleAccount *account, + const gchar *who, + gchar *message, + PurpleConversation *conv, + PurpleMessageFlags flags, + gpointer user_data); +``` + +Emitted after a message is displayed in an IM conversation. + +**Parameters:** + +**account** +: The account. + +**who** +: The name of the user. + +**message** +: The message. + +**conv** +: The conversation. + +**flags** +: Flags for this message. + +**user_data** +: User data set when the signal handler was connected. + +### displaying-chat-msg + +```c +gboolean +user_function(PurpleAccount *account, + const gchar *who, + gchar **message, + PurpleConversation *conv, + PurpleMessageFlags flags, + gpointer user_data); +``` + +Emitted just before a message is displayed in a chat. `message` is a pointer to +a string, so the plugin can replace the message that will be displayed. This +can also be used to cancel displaying a message by returning `TRUE`. + +> **NOTE:** Make sure to free `*message` before you replace it! + +**Parameters:** + +**account** +: The account the message is being displayed and sent on. + +**who** +: The name of the user. + +**message** +: A pointer to the message that will be displayed and sent. + +**conv** +: The conversation the message is being displayed and sent on. + +**flags** +: Flags for this message. + +**user_data** +: User data set when the signal handler was connected. + +**Returns:** + +`TRUE` if the message should be canceled, or `FALSE` otherwise. + +### displayed-chat-msg + +```c +void +user_function(PurpleAccount *account, + const gchar *who, + gchar *message, + PurpleConversation *conv, + PurpleMessageFlags flags, + gpointer user_data); +``` + +Emitted after a message is displayed in a chat conversation. + +**Parameters:** + +**account** +: The account the message is being displayed and sent on. + +**who** +: The name of the user. + +**message** +: A pointer to the message that will be displayed and sent. + +**conv** +: The conversation the message is being displayed and sent on. + +**flags** +: Flags for this message. + +**user_data** +: User data set when the signal handler was connected. + +### conversation-switched + +```c +void user_function(PurpleConversation *conv, gpointer user_data); +``` + +Emitted when a window switched from one conversation to another. + +**Parameters:** + +**new_conv** +: The now active conversation. + +**user_data** +: User data set when the signal handler was connected. + +### conversation-displayed + +```c +void user_function(PidginConversation *gtkconv, gpointer user_data); +``` + +Emitted right after the Pidgin UI is attached to a new conversation. + +**Parameters:** + +**gtkconv** +: The PidginConversation. + +**user_data** +: User data set when the signal handler was connected.
--- a/doc/reference/pidgin/signals_gtkconv.xml Tue Oct 19 00:48:05 2021 -0500 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,273 +0,0 @@ -<?xml version='1.0' encoding="ISO-8859-1"?> -<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" - "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [ -]> -<chapter id="chapter-signals-gtkconv"> -<title>Conversation signals</title> - -<refsect1 id="gtkconvs.signals" role="signal_proto"> -<title role="signal_proto.title">List of signals</title> -<synopsis> - "<link linkend="gtkconvs-conversation-dragging">conversation-dragging</link>" - "<link linkend="gtkconvs-displaying-im-msg">displaying-im-msg</link>" - "<link linkend="gtkconvs-displayed-im-msg">displayed-im-msg</link>" - "<link linkend="gtkconvs-displaying-chat-msg">displaying-chat-msg</link>" - "<link linkend="gtkconvs-displayed-chat-msg">displayed-chat-msg</link>" - "<link linkend="gtkconvs-conversation-switched">conversation-switched</link>" - "<link linkend="gtkconvs-conversation-displayed">conversation-displayed</link>" -</synopsis> -</refsect1> - -<refsect1 id="gtkconvs.signal-details" role="signals"> -<title role="signals.title">Signal details</title> - -<refsect2 id="gtkconvs-conversation-dragging" role="signal"> - <title>The <literal>"conversation-dragging"</literal> signal</title> -<programlisting> -void user_function (PidginConvWindow *source, - PidginConvWindow *destination, - gpointer user_data) -</programlisting> - <para> -Emitted when a conversation is being drag and dropped between windows. - </para> - <variablelist role="params"> - <varlistentry> - <term><parameter>source</parameter> :</term> - <listitem><simpara>The window where the conversation is.</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter>destination</parameter> :</term> - <listitem><simpara>The window where the conversation will be moved to.</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter>user_data</parameter> :</term> - <listitem><simpara>user data set when the signal handler was connected.</simpara></listitem> - </varlistentry> - </variablelist> -</refsect2> - - -<refsect2 id="gtkconvs-displaying-im-msg" role="signal"> - <title>The <literal>"displaying-im-msg"</literal> signal</title> -<programlisting> -gboolean user_function (PurpleAccount *account, - const char *who, - char **message, - PurpleConversation *conv, - PurpleMessageFlags flags, - gpointer user_data) -</programlisting> - <para> -Emitted just before a message is displayed in an IM conversation. <literal>message</literal> is a pointer to a string, so the plugin can replace the message that will be displayed. This can also be used to cancel displaying a message by returning <literal>TRUE</literal>. - </para> - <note><para> -Make sure to free <literal>*message</literal> before you replace it! - </para></note> - <variablelist role="params"> - <varlistentry> - <term><parameter>account</parameter> :</term> - <listitem><simpara>The account.</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter>who</parameter> :</term> - <listitem><simpara>The name of the user.</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter>message</parameter> :</term> - <listitem><simpara>A pointer to the message.</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter>conv</parameter> :</term> - <listitem><simpara>The conversation.</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter>flags</parameter> :</term> - <listitem><simpara>Flags for this message.</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter>user_data</parameter> :</term> - <listitem><simpara>user data set when the signal handler was connected.</simpara></listitem> - </varlistentry> - <varlistentry> - <term><emphasis>Returns</emphasis> :</term> - <listitem><simpara><literal>TRUE</literal> if the message should be canceled, or <literal>FALSE</literal> otherwise.</simpara></listitem> - </varlistentry> - </variablelist> -</refsect2> - -<refsect2 id="gtkconvs-displayed-im-msg" role="signal"> - <title>The <literal>"displayed-im-msg"</literal> signal</title> -<programlisting> -void user_function (PurpleAccount *account, - const char *who, - char *message, - PurpleConversation *conv, - PurpleMessageFlags flags, - gpointer user_data) -</programlisting> - <para> -Emitted after a message is displayed in an IM conversation. - </para> - <variablelist role="params"> - <varlistentry> - <term><parameter>account</parameter> :</term> - <listitem><simpara>The account.</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter>who</parameter> :</term> - <listitem><simpara>The name of the user.</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter>message</parameter> :</term> - <listitem><simpara>The message.</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter>conv</parameter> :</term> - <listitem><simpara>The conversation.</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter>flags</parameter> :</term> - <listitem><simpara>Flags for this message.</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter>user_data</parameter> :</term> - <listitem><simpara>user data set when the signal handler was connected.</simpara></listitem> - </varlistentry> - </variablelist> -</refsect2> - -<refsect2 id="gtkconvs-displaying-chat-msg" role="signal"> - <title>The <literal>"displaying-chat-msg"</literal> signal</title> -<programlisting> -gboolean user_function (PurpleAccount *account, - const char *who, - char **message, - PurpleConversation *conv, - PurpleMessageFlags flags, - gpointer user_data) -</programlisting> - <para> -Emitted just before a message is displayed in a chat. <literal>message</literal> is a pointer to a string, so the plugin can replace the message that will be displayed. This can also be used to cancel displaying a message by returning <literal>TRUE</literal>. - </para> - <note><para> -Make sure to free <literal>*message</literal> before you replace it! - </para></note> - <variablelist role="params"> - <varlistentry> - <term><parameter>account</parameter> :</term> - <listitem><simpara>The account the message is being displayed and sent on.</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter>who</parameter> :</term> - <listitem><simpara>The name of the user.</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter>message</parameter> :</term> - <listitem><simpara>A pointer to the message that will be displayed and sent.</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter>conv</parameter> :</term> - <listitem><simpara>The conversation the message is being displayed and sent on.</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter>flags</parameter> :</term> - <listitem><simpara>Flags for this message.</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter>user_data</parameter> :</term> - <listitem><simpara>user data set when the signal handler was connected.</simpara></listitem> - </varlistentry> - <varlistentry> - <term><emphasis>Returns</emphasis> :</term> - <listitem><simpara><literal>TRUE</literal> if the message should be canceled, or <literal>FALSE</literal> otherwise.</simpara></listitem> - </varlistentry> - </variablelist> -</refsect2> - -<refsect2 id="gtkconvs-displayed-chat-msg" role="signal"> - <title>The <literal>"displayed-chat-msg"</literal> signal</title> -<programlisting> -void user_function (PurpleAccount *account, - const char *who, - char *message, - PurpleConversation *conv, - PurpleMessageFlags flags, - gpointer user_data) -</programlisting> - <para> -Emitted after a message is displayed in a chat conversation. - </para> - <variablelist role="params"> - <varlistentry> - <term><parameter>account</parameter> :</term> - <listitem><simpara>The account the message is being displayed and sent on.</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter>who</parameter> :</term> - <listitem><simpara>The name of the user.</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter>message</parameter> :</term> - <listitem><simpara>A pointer to the message that will be displayed and sent.</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter>conv</parameter> :</term> - <listitem><simpara>The conversation the message is being displayed and sent on.</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter>flags</parameter> :</term> - <listitem><simpara>Flags for this message.</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter>user_data</parameter> :</term> - <listitem><simpara>user data set when the signal handler was connected.</simpara></listitem> - </varlistentry> - </variablelist> -</refsect2> - -<refsect2 id="gtkconvs-conversation-switched" role="signal"> - <title>The <literal>"conversation-switched"</literal> signal</title> -<programlisting> -void user_function (PurpleConversation *conv, - gpointer user_data) -</programlisting> - <para> -Emitted when a window switched from one conversation to another. - </para> - <variablelist role="params"> - <varlistentry> - <term><parameter>new_conv</parameter> :</term> - <listitem><simpara>The now active conversation.</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter>user_data</parameter> :</term> - <listitem><simpara>user data set when the signal handler was connected.</simpara></listitem> - </varlistentry> - </variablelist> -</refsect2> - -<refsect2 id="gtkconvs-conversation-displayed" role="signal"> - <title>The <literal>"conversation-displayed"</literal> signal</title> -<programlisting> -void user_function (PidginConversation *gtkconv, - gpointer user_data) -</programlisting> - <para> -Emitted right after the Pidgin UI is attached to a new conversation. - </para> - <variablelist role="params"> - <varlistentry> - <term><parameter>gtkconv</parameter> :</term> - <listitem><simpara>The PidginConversation.</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter>user_data</parameter> :</term> - <listitem><simpara>user data set when the signal handler was connected.</simpara></listitem> - </varlistentry> - </variablelist> -</refsect2> - -</refsect1> - -</chapter>
--- a/doc/reference/pidgin/signals_gtklog.xml Tue Oct 19 00:48:05 2021 -0500 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,46 +0,0 @@ -<?xml version='1.0' encoding="ISO-8859-1"?> -<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" - "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [ -]> -<chapter id="chapter-signals-gtklog"> -<title>Log signals</title> - -<refsect1 id="gtklogs.signals" role="signal_proto"> -<title role="signal_proto.title">List of signals</title> -<synopsis> - "<link linkend="gtklogs-log-displaying">log-displaying</link>" -</synopsis> -</refsect1> - -<refsect1 id="gtklogs.signal-details" role="signals"> -<title role="signals.title">Signal details</title> - -<refsect2 id="gtklogs-log-displaying" role="signal"> - <title>The <literal>"log-displaying"</literal> signal</title> -<programlisting> -void user_function (PidginLogViewer *viewer, - PurpleLog *log, - gpointer user_data) -</programlisting> - <para> -Emitted when a log is being displayed. - </para> - <variablelist role="params"> - <varlistentry> - <term><parameter>viewer</parameter> :</term> - <listitem><simpara>The log viewer.</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter>log</parameter> :</term> - <listitem><simpara>The log being displayed.</simpara></listitem> - </varlistentry> - <varlistentry> - <term><parameter>user_data</parameter> :</term> - <listitem><simpara>user data set when the signal handler was connected.</simpara></listitem> - </varlistentry> - </variablelist> -</refsect2> - -</refsect1> - -</chapter>
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/doc/reference/pidgin/urlmap.js Tue Oct 19 02:49:28 2021 -0500 @@ -0,0 +1,13 @@ +// SPDX-FileCopyrightText: 2021 GNOME Foundation +// SPDX-License-Identifier: LGPL-2.1-or-later + +// A map between namespaces and base URLs for their online documentation +baseURLs = [ + [ 'GLib', 'https://docs.gtk.org/glib/' ], + [ 'GObject', 'https://docs.gtk.org/gobject/' ], + [ 'GPlugin', 'https://docs.imfreedom.org/gplugin/' ], + [ 'GPlugin-Gtk3', 'https://docs.imfreedom.org/gplugin-gtk3/' ], + [ 'Gtk', 'https://docs.gtk.org/gtk3/' ], + [ 'Purple3', 'https://docs.imfreedom.org/purple3/' ], + [ 'Talkatu', 'https://docs.imfreedom.org/talkatu/' ], +]
--- a/doc/reference/pidgin/version.xml.in Tue Oct 19 00:48:05 2021 -0500 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,1 +0,0 @@ -@PURPLE_VERSION@
--- a/pidgin/gtkaccount.h Tue Oct 19 00:48:05 2021 -0500 +++ b/pidgin/gtkaccount.h Tue Oct 19 02:49:28 2021 -0500 @@ -25,13 +25,6 @@ #ifndef _PIDGINACCOUNT_H_ #define _PIDGINACCOUNT_H_ -/** - * SECTION:gtkaccount - * @section_id: pidgin-gtkaccount - * @short_description: <filename>gtkaccount.h</filename> - * @title: Account Editor UI - * @see_also: <link linkend="chapter-signals-gtkaccount">Account signals</link> - */ #include <purple.h>
--- a/pidgin/gtkblist.h Tue Oct 19 00:48:05 2021 -0500 +++ b/pidgin/gtkblist.h Tue Oct 19 02:49:28 2021 -0500 @@ -21,13 +21,6 @@ #ifndef _PIDGINBLIST_H_ #define _PIDGINBLIST_H_ -/** - * SECTION:gtkblist - * @section_id: pidgin-gtkblist - * @short_description: <filename>gtkblist.h</filename> - * @title: Buddy List API - * @see_also: <link linkend="chapter-signals-gtkblist">Buddy List signals</link> - */ #include <gtk/gtk.h> @@ -121,11 +114,6 @@ * GTK Buddy List API **************************************************************************/ -/** - * pidgin_buddy_list_get_type: - * - * Returns: The #GType for the #PidginBuddyList boxed structure. - */ G_DECLARE_FINAL_TYPE(PidginBuddyList, pidgin_buddy_list, PIDGIN, BUDDY_LIST, PurpleBuddyList)
--- a/pidgin/gtkconn.h Tue Oct 19 00:48:05 2021 -0500 +++ b/pidgin/gtkconn.h Tue Oct 19 02:49:28 2021 -0500 @@ -25,12 +25,6 @@ #ifndef _PIDGINCONN_H_ #define _PIDGINCONN_H_ -/** - * SECTION:gtkconn - * @section_id: pidgin-gtkconn - * @short_description: <filename>gtkconn.h</filename> - * @title: Connection API - */ G_BEGIN_DECLS
--- a/pidgin/gtkconv.h Tue Oct 19 00:48:05 2021 -0500 +++ b/pidgin/gtkconv.h Tue Oct 19 02:49:28 2021 -0500 @@ -25,13 +25,6 @@ #ifndef _PIDGIN_CONVERSATION_H_ #define _PIDGIN_CONVERSATION_H_ -/** - * SECTION:gtkconv - * @section_id: pidgin-gtkconv - * @short_description: <filename>gtkconv.h</filename> - * @title: Conversation API - * @see_also: <link linkend="chapter-signals-gtkconv">Conversation signals</link> - */ typedef struct _PidginImPane PidginImPane; typedef struct _PidginChatPane PidginChatPane;
--- a/pidgin/gtkconvwin.h Tue Oct 19 00:48:05 2021 -0500 +++ b/pidgin/gtkconvwin.h Tue Oct 19 02:49:28 2021 -0500 @@ -25,12 +25,6 @@ #ifndef _PIDGIN_CONVERSATION_WINDOW_H_ #define _PIDGIN_CONVERSATION_WINDOW_H_ -/** - * SECTION:gtkconvwin - * @section_id: pidgin-gtkconvwin - * @short_description: <filename>gtkconvwin.h</filename> - * @title: Conversation Window API - */ #include <gtk/gtk.h>
--- a/pidgin/gtkdialogs.h Tue Oct 19 00:48:05 2021 -0500 +++ b/pidgin/gtkdialogs.h Tue Oct 19 02:49:28 2021 -0500 @@ -25,12 +25,6 @@ #ifndef _PIDGINDIALOGS_H_ #define _PIDGINDIALOGS_H_ -/** - * SECTION:gtkdialogs - * @section_id: pidgin-gtkdialogs - * @short_description: <filename>gtkdialogs.h</filename> - * @title: Pidgin Dialogs - */ #include <purple.h>
--- a/pidgin/gtkdnd-hints.h Tue Oct 19 00:48:05 2021 -0500 +++ b/pidgin/gtkdnd-hints.h Tue Oct 19 02:49:28 2021 -0500 @@ -23,12 +23,6 @@ #ifndef _PIDGIN_DND_HINTS_H_ #define _PIDGIN_DND_HINTS_H_ -/** - * SECTION:gtkdnd-hints - * @section_id: pidgin-gtkdnd-hints - * @short_description: <filename>gtkdnd-hints.h</filename> - * @title: Drag-and-Drop Arrow Hints - */ #include <glib.h> #include <gtk/gtk.h>
--- a/pidgin/gtkicon-theme-loader.h Tue Oct 19 00:48:05 2021 -0500 +++ b/pidgin/gtkicon-theme-loader.h Tue Oct 19 02:49:28 2021 -0500 @@ -25,12 +25,6 @@ #ifndef PIDGIN_ICON_THEME_LOADER_H #define PIDGIN_ICON_THEME_LOADER_H -/** - * SECTION:gtkicon-theme-loader - * @section_id: pidgin-gtkicon-theme-loader - * @short_description: <filename>gtkicon-theme-loader.h</filename> - * @title: Pidgin Icon Theme Loader Class - */ #include <glib.h> #include <glib-object.h> @@ -44,11 +38,6 @@ /**************************************************************************/ G_BEGIN_DECLS -/** - * pidgin_icon_theme_loader_get_type: - * - * Returns: The #GType for an icon theme loader. - */ G_DECLARE_FINAL_TYPE(PidginIconThemeLoader, pidgin_icon_theme_loader, PIDGIN, ICON_THEME_LOADER, PurpleThemeLoader)
--- a/pidgin/gtkicon-theme.h Tue Oct 19 00:48:05 2021 -0500 +++ b/pidgin/gtkicon-theme.h Tue Oct 19 02:49:28 2021 -0500 @@ -25,12 +25,6 @@ #ifndef PIDGIN_ICON_THEME_H #define PIDGIN_ICON_THEME_H -/** - * SECTION:gtkicon-theme - * @section_id: pidgin-gtkicon-theme - * @short_description: <filename>gtkicon-theme.h</filename> - * @title: Icon Theme Class - */ #include <glib.h> #include <glib-object.h> @@ -49,11 +43,6 @@ /**************************************************************************/ G_BEGIN_DECLS -/** - * pidgin_icon_theme_get_type: - * - * Returns: The #GType for an icon theme. - */ G_DECLARE_DERIVABLE_TYPE(PidginIconTheme, pidgin_icon_theme, PIDGIN, ICON_THEME, PurpleTheme)
--- a/pidgin/gtkidle.h Tue Oct 19 00:48:05 2021 -0500 +++ b/pidgin/gtkidle.h Tue Oct 19 02:49:28 2021 -0500 @@ -25,12 +25,6 @@ #ifndef _PIDGIN_IDLE_H_ #define _PIDGIN_IDLE_H_ -/** - * SECTION:gtkidle - * @section_id: pidgin-gtkidle - * @short_description: <filename>gtkidle.h</filename> - * @title: Idle API - */ #include <purple.h>
--- a/pidgin/gtkmedia.h Tue Oct 19 00:48:05 2021 -0500 +++ b/pidgin/gtkmedia.h Tue Oct 19 02:49:28 2021 -0500 @@ -25,12 +25,6 @@ #ifndef __GTKMEDIA_H_ #define __GTKMEDIA_H_ -/** - * SECTION:gtkmedia - * @section_id: pidgin-gtkmedia - * @short_description: <filename>gtkmedia.h</filename> - * @title: Media API - */ G_BEGIN_DECLS
--- a/pidgin/gtknotify.h Tue Oct 19 00:48:05 2021 -0500 +++ b/pidgin/gtknotify.h Tue Oct 19 02:49:28 2021 -0500 @@ -25,12 +25,6 @@ #ifndef _PIDGINNOTIFY_H_ #define _PIDGINNOTIFY_H_ -/** - * SECTION:gtknotify - * @section_id: pidgin-gtknotify - * @short_description: <filename>gtknotify.h</filename> - * @title: Notification API - */ #include <purple.h>
--- a/pidgin/gtkpluginpref.h Tue Oct 19 00:48:05 2021 -0500 +++ b/pidgin/gtkpluginpref.h Tue Oct 19 02:49:28 2021 -0500 @@ -26,12 +26,6 @@ #ifndef _PIDGINPLUGINPREF_H_ #define _PIDGINPLUGINPREF_H_ -/** - * SECTION:gtkpluginpref - * @section_id: pidgin-gtkpluginpref - * @short_description: <filename>gtkpluginpref.h</filename> - * @title: Plugin Preferences - */ #include <purple.h>
--- a/pidgin/gtkprivacy.h Tue Oct 19 00:48:05 2021 -0500 +++ b/pidgin/gtkprivacy.h Tue Oct 19 02:49:28 2021 -0500 @@ -25,12 +25,6 @@ #ifndef _PIDGINPRIVACY_H_ #define _PIDGINPRIVACY_H_ -/** - * SECTION:gtkprivacy - * @section_id: pidgin-gtkprivacy - * @short_description: <filename>gtkprivacy.h</filename> - * @title: Privacy UI - */ #include <purple.h>
--- a/pidgin/gtkrequest.h Tue Oct 19 00:48:05 2021 -0500 +++ b/pidgin/gtkrequest.h Tue Oct 19 02:49:28 2021 -0500 @@ -25,12 +25,6 @@ #ifndef _PIDGINREQUEST_H_ #define _PIDGINREQUEST_H_ -/** - * SECTION:gtkrequest - * @section_id: pidgin-gtkrequest - * @short_description: <filename>gtkrequest.h</filename> - * @title: Request API - */ #include <purple.h>
--- a/pidgin/gtkroomlist.h Tue Oct 19 00:48:05 2021 -0500 +++ b/pidgin/gtkroomlist.h Tue Oct 19 02:49:28 2021 -0500 @@ -25,12 +25,6 @@ #ifndef _PIDGINROOMLIST_H_ #define _PIDGINROOMLIST_H_ -/** - * SECTION:gtkroomlist - * @section_id: pidgin-gtkroomlist - * @short_description: <filename>gtkroomlist.h</filename> - * @title: Room List UI - */ #include <purple.h>
--- a/pidgin/gtksavedstatuses.h Tue Oct 19 00:48:05 2021 -0500 +++ b/pidgin/gtksavedstatuses.h Tue Oct 19 02:49:28 2021 -0500 @@ -25,12 +25,6 @@ #ifndef _PIDGINSAVEDSTATUSES_H_ #define _PIDGINSAVEDSTATUSES_H_ -/** - * SECTION:gtksavedstatuses - * @section_id: pidgin-gtksavedstatuses - * @short_description: <filename>gtksavedstatuses.h</filename> - * @title: Saved Status Editor UI - */ #include <purple.h>
--- a/pidgin/gtkstatus-icon-theme.h Tue Oct 19 00:48:05 2021 -0500 +++ b/pidgin/gtkstatus-icon-theme.h Tue Oct 19 02:49:28 2021 -0500 @@ -25,12 +25,6 @@ #ifndef PIDGIN_STATUS_ICON_THEME_H #define PIDGIN_STATUS_ICON_THEME_H -/** - * SECTION:gtkstatus-icon-theme - * @section_id: pidgin-gtkstatus-icon-theme - * @short_description: <filename>gtkstatus-icon-theme.h</filename> - * @title: Pidgin Icon Theme Class - */ #include <glib-object.h> #include "gtkicon-theme.h" @@ -42,11 +36,6 @@ /**************************************************************************/ G_BEGIN_DECLS -/** - * pidgin_status_icon_theme_get_type: - * - * Returns: The #GType for a status icon theme. - */ G_DECLARE_FINAL_TYPE(PidginStatusIconTheme, pidgin_status_icon_theme, PIDGIN, STATUS_ICON_THEME, PidginIconTheme)
--- a/pidgin/gtkstatusbox.h Tue Oct 19 00:48:05 2021 -0500 +++ b/pidgin/gtkstatusbox.h Tue Oct 19 02:49:28 2021 -0500 @@ -27,13 +27,6 @@ #ifndef PIDGIN_STATUS_BOX_H #define PIDGIN_STATUS_BOX_H -/** - * SECTION:gtkstatusbox - * @section_id: pidgin-gtkstatusbox - * @short_description: <filename>gtkstatusbox.h</filename> - * @title: Status Selection Widget - */ - #include <gtk/gtk.h> #include <talkatu.h>
--- a/pidgin/gtkutils.h Tue Oct 19 00:48:05 2021 -0500 +++ b/pidgin/gtkutils.h Tue Oct 19 02:49:28 2021 -0500 @@ -25,12 +25,6 @@ #ifndef _PIDGINUTILS_H_ #define _PIDGINUTILS_H_ -/** - * SECTION:gtkutils - * @section_id: pidgin-gtkutils - * @short_description: <filename>gtkutils.h</filename> - * @title: Utility functions - */ #include "gtkconv.h"
--- a/pidgin/gtkwhiteboard.h Tue Oct 19 00:48:05 2021 -0500 +++ b/pidgin/gtkwhiteboard.h Tue Oct 19 02:49:28 2021 -0500 @@ -25,12 +25,6 @@ #ifndef _PIDGINWHITEBOARD_H_ #define _PIDGINWHITEBOARD_H_ -/** - * SECTION:gtkwhiteboard - * @section_id: pidgin-gtkwhiteboard - * @short_description: <filename>gtkwhiteboard.h</filename> - * @title: Whiteboard Frontend - */ G_BEGIN_DECLS
--- a/pidgin/gtkxfer.h Tue Oct 19 00:48:05 2021 -0500 +++ b/pidgin/gtkxfer.h Tue Oct 19 02:49:28 2021 -0500 @@ -25,12 +25,6 @@ #ifndef _PIDGINXFER_H_ #define _PIDGINXFER_H_ -/** - * SECTION:gtkxfer - * @section_id: pidgin-gtkxfer - * @short_description: <filename>gtkxfer.h</filename> - * @title: File Transfer UI - */ #include <purple.h>
--- a/pidgin/meson.build Tue Oct 19 00:48:05 2021 -0500 +++ b/pidgin/meson.build Tue Oct 19 02:49:28 2021 -0500 @@ -311,25 +311,17 @@ if enable_introspection introspection_sources = libpidgin_headers + libpidgin_prefs_headers - Pidgin_gir_includes = [ - 'GObject-2.0', 'Gtk-3.0', 'GPlugin-1.0', 'GPluginGtk3-1.0', - 'Talkatu-0.0', - # subproject needs to be before libpurple in the repo so that - # meson will use our variables and not try to discover them from - # libpurple. - libpurple_gir[0], - ] - - gnome.generate_gir(libpidgin, + pidgin_gir = gnome.generate_gir(libpidgin, sources : introspection_sources, - includes : Pidgin_gir_includes, + header : 'pidgin.h', + includes : ['GLib-2.0', 'GObject-2.0', 'Gtk-3.0'], namespace : 'Pidgin', symbol_prefix : 'pidgin', identifier_prefix : 'Pidgin', export_packages : 'pidgin-@0@'.format(purple_major_version), nsversion : '@0@.@1@'.format(purple_major_version, purple_minor_version), - dependencies : [gplugin_dep, gplugin_gtk_dep, talkatu_dep], + dependencies : [gplugin_dep, gplugin_gtk_dep, talkatu_dep, libpurple_dep], install : true, extra_args : ['-DPIDGIN_COMPILATION', '--quiet']) endif
--- a/pidgin/minidialog.h Tue Oct 19 00:48:05 2021 -0500 +++ b/pidgin/minidialog.h Tue Oct 19 02:49:28 2021 -0500 @@ -25,12 +25,6 @@ #ifndef PIDGIN_MINI_DIALOG_H #define PIDGIN_MINI_DIALOG_H -/** - * SECTION:minidialog - * @section_id: pidgin-minidialog - * @short_description: <filename>minidialog.h</filename> - * @title: Mini Dialog Widget - */ #include <glib-object.h> #include <gtk/gtk.h> @@ -95,12 +89,6 @@ GtkButton *button, gpointer user_data); /** - * pidgin_mini_dialog_get_type: - * - * Get the GType of #PidginMiniDialog. - */ - -/** * pidgin_mini_dialog_new: * * Creates a new #PidginMiniDialog with a #GtkIconTheme icon. This is a
--- a/pidgin/pidginabout.h Tue Oct 19 00:48:05 2021 -0500 +++ b/pidgin/pidginabout.h Tue Oct 19 02:49:28 2021 -0500 @@ -27,13 +27,6 @@ #ifndef PIDGIN_ABOUT_H #define PIDGIN_ABOUT_H -/** - * SECTION:pidginabout - * @section_id: pidgin-about - * @short_description: <filename>pidginabout.h</filename> - * @title: About Dialog - */ - #include <gtk/gtk.h> G_BEGIN_DECLS
--- a/pidgin/pidginaccountactionsmenu.h Tue Oct 19 00:48:05 2021 -0500 +++ b/pidgin/pidginaccountactionsmenu.h Tue Oct 19 02:49:28 2021 -0500 @@ -27,22 +27,19 @@ #ifndef PIDGIN_ACCOUNT_ACTIONS_MENU_H #define PIDGIN_ACCOUNT_ACTIONS_MENU_H -/** - * SECTION:pidginaccountactionsmenu - * @section_id: pidgin-account-actions-menu - * @short_description: A menu for managing account actions - * @title: Accounts Actions Menu - * - * #PidginAccountActionsMenu is a #GtkMenu that provides an interface for users - * to edit accounts and activate the account's actions. - */ - #include <gtk/gtk.h> #include <purple.h> G_BEGIN_DECLS +/** + * PidginAccountActionsMenu: + * + * A #GtkMenu that provides an interface for users to edit accounts and + * activate the account's actions. + */ + #define PIDGIN_TYPE_ACCOUNT_ACTIONS_MENU (pidgin_account_actions_menu_get_type()) G_DECLARE_FINAL_TYPE(PidginAccountActionsMenu, pidgin_account_actions_menu, PIDGIN, ACCOUNT_ACTIONS_MENU, GtkMenu)
--- a/pidgin/pidginaccountchooser.h Tue Oct 19 00:48:05 2021 -0500 +++ b/pidgin/pidginaccountchooser.h Tue Oct 19 02:49:28 2021 -0500 @@ -25,12 +25,6 @@ #ifndef PIDGIN_ACCOUNT_CHOOSER_H #define PIDGIN_ACCOUNT_CHOOSER_H -/** - * SECTION:pidginaccountchooser - * @section_id: pidgin-account-chooser - * @short_description: A #GtkComboBox for choosing accounts - * @title: Pidgin Account Chooser Combo Box Widget - */ #include <gtk/gtk.h>
--- a/pidgin/pidginaccountfilterconnected.h Tue Oct 19 00:48:05 2021 -0500 +++ b/pidgin/pidginaccountfilterconnected.h Tue Oct 19 02:49:28 2021 -0500 @@ -23,21 +23,20 @@ #ifndef PIDGIN_ACCOUNT_FILTER_CONNECTED_H #define PIDGIN_ACCOUNT_FILTER_CONNECTED_H +#include <gtk/gtk.h> + +G_BEGIN_DECLS + /** - * SECTION: pidginaccountfilterconnected - * @section_id: pidgin-account-filter-connected - * @short_description: A GtkTreeModelFilter that displays connected accounts. - * @title: Account Connected Filter + * PidginAccountFilterConnected: * * #PidginAccountFilterConnected is a #GtkTreeModelFilter that will only show * accounts that are connected. It's intended to be used with * #PidginAccountStore. + * + * Since: 3.0.0 */ -#include <gtk/gtk.h> - -G_BEGIN_DECLS - #define PIDGIN_TYPE_ACCOUNT_FILTER_CONNECTED pidgin_account_filter_connected_get_type() G_DECLARE_FINAL_TYPE(PidginAccountFilterConnected, pidgin_account_filter_connected, PIDGIN,
--- a/pidgin/pidginaccountfilterprotocol.h Tue Oct 19 00:48:05 2021 -0500 +++ b/pidgin/pidginaccountfilterprotocol.h Tue Oct 19 02:49:28 2021 -0500 @@ -23,21 +23,20 @@ #ifndef PIDGIN_ACCOUNT_FILTER_PROTOCOL_H #define PIDGIN_ACCOUNT_FILTER_PROTOCOL_H +#include <gtk/gtk.h> + +G_BEGIN_DECLS + /** - * SECTION:pidginaccountfilterprotocol - * @section_id: pidgin-account-filter-protocol - * @short_description: A GtkTreeModelFilter that displays the given protocol. - * @title: Account Protocol Filter + * PidginAccountFilterProtocol: * * #PidginAccountFilterProtocol is a #GtkTreeModelFilter that will only show * accounts for the given protocol. It's intended to be used with * #PidginAccountStore. + * + * Since: 3.0.0 */ -#include <gtk/gtk.h> - -G_BEGIN_DECLS - #define PIDGIN_TYPE_ACCOUNT_FILTER_PROTOCOL pidgin_account_filter_protocol_get_type() G_DECLARE_FINAL_TYPE(PidginAccountFilterProtocol, pidgin_account_filter_protocol, PIDGIN, @@ -67,6 +66,8 @@ * Gets the ID of the protocol that @filter is filtering for. * * Returns: The Protocol ID that @filter is filtering for. + * + * Since: 3.0.0 */ const gchar *pidgin_account_filter_protocol_get_protocol_id(PidginAccountFilterProtocol *filter);
--- a/pidgin/pidginaccountsmenu.h Tue Oct 19 00:48:05 2021 -0500 +++ b/pidgin/pidginaccountsmenu.h Tue Oct 19 02:49:28 2021 -0500 @@ -27,23 +27,22 @@ #ifndef PIDGIN_ACCOUNTS_MENU_H #define PIDGIN_ACCOUNTS_MENU_H +#include <gtk/gtk.h> + +G_BEGIN_DECLS + /** - * SECTION:pidginaccountsmenu - * @section_id: pidgin-accounts-menu - * @short_description: A menu for managing accounts and their actions - * @title: Accounts Menu + * PidginAccountsMenu: * * #PidginAccountsMenu is a #GtkMenu that provides an interface to users to open * the account manager as well as activate account actions. * * It manages itself as accounts are created/deleted and enabled/disabled and * can be added as a submenu to any #GtkMenuItem. + * + * Since: 3.0.0 */ -#include <gtk/gtk.h> - -G_BEGIN_DECLS - #define PIDGIN_TYPE_ACCOUNTS_MENU (pidgin_accounts_menu_get_type()) G_DECLARE_FINAL_TYPE(PidginAccountsMenu, pidgin_accounts_menu, PIDGIN, ACCOUNTS_MENU, GtkMenu)
--- a/pidgin/pidginaccountstore.h Tue Oct 19 00:48:05 2021 -0500 +++ b/pidgin/pidginaccountstore.h Tue Oct 19 02:49:28 2021 -0500 @@ -23,21 +23,20 @@ #ifndef PIDGIN_ACCOUNT_STORE_H #define PIDGIN_ACCOUNT_STORE_H +#include <gtk/gtk.h> + +#include <purple.h> + /** - * SECTION:pidginaccountstore - * @section_id: pidgin-account-store - * @short_description: A GtkListStore that keeps track of accounts - * @title: Account Store + * PidginAccountStore: * * #PidginAccountStore is a #GtkListStore that automatically keeps track of * what accounts are currently available in libpurple. It's intended to be * used any time that you need to present an account selection to the user. + * + * Since: 3.0.0 */ -#include <gtk/gtk.h> - -#include <purple.h> - /** * PidginAccountStoreColumn: * @PIDGIN_ACCOUNT_STORE_COLUMN_ACCOUNT: This column holds a reference to the
--- a/pidgin/pidginactiongroup.h Tue Oct 19 00:48:05 2021 -0500 +++ b/pidgin/pidginactiongroup.h Tue Oct 19 02:49:28 2021 -0500 @@ -27,21 +27,20 @@ #ifndef PIDGIN_ACTION_GROUP_H #define PIDGIN_ACTION_GROUP_H +#include <glib.h> + +#include <gio/gio.h> + /** - * SECTION:pidginactiongroup - * @section_id: pidgin-action-group - * @short_description: An action group for Pidgin - * @title: Action Group + * PidginActionGroup: * * A #GSimpleActionGroup containing most of our actions. A lot of this will * need to be added to the #GtkApplication, but I didn't want to do that part * quite yet, so I created this instead. + * + * Since: 3.0.0 */ -#include <glib.h> - -#include <gio/gio.h> - /** * PIDGIN_ACTION_SHOW_BUDDY_ICONS: *
--- a/pidgin/pidginapplication.h Tue Oct 19 00:48:05 2021 -0500 +++ b/pidgin/pidginapplication.h Tue Oct 19 02:49:28 2021 -0500 @@ -27,21 +27,20 @@ #ifndef PIDGIN_APPLICATION_H #define PIDGIN_APPLICATION_H -/** - * SECTION:pidginapplication - * @section_id: pidgin-application - * @short_description: A #GtkApplication subclass for Pidgin. - * @title: Pidgin Application - * - * #PidginApplication is a subclass of #GtkApplication that holds all of the - * application wide actions. - */ - #include <glib.h> #include <gtk/gtk.h> G_BEGIN_DECLS +/** + * PidginApplication: + * + * #PidginApplication is a subclass of #GtkApplication that holds all of the + * application wide actions. + * + * Since: 3.0.0 + */ + #define PIDGIN_TYPE_APPLICATION (pidgin_application_get_type()) G_DECLARE_FINAL_TYPE(PidginApplication, pidgin_application, PIDGIN, APPLICATION, GtkApplication)
--- a/pidgin/pidginattachment.h Tue Oct 19 00:48:05 2021 -0500 +++ b/pidgin/pidginattachment.h Tue Oct 19 02:49:28 2021 -0500 @@ -26,13 +26,6 @@ #ifndef PIDGIN_ATTACHMENT_H #define PIDGIN_ATTACHMENT_H -/** - * SECTION:pidginattachment - * @section_id: pidgin-pidginattachment - * @short_description: <filename>pidginattachment.h</filename> - * @title: Pidgin Attachment API - */ - #include <purple.h> #include <talkatu.h>
--- a/pidgin/pidginavatar.h Tue Oct 19 00:48:05 2021 -0500 +++ b/pidgin/pidginavatar.h Tue Oct 19 02:49:28 2021 -0500 @@ -27,16 +27,6 @@ #ifndef PIDGIN_AVATAR_H #define PIDGIN_AVATAR_H -/** - * SECTION:pidginavatar - * @section_id: pidgin-pidginavatar - * @short_description: Avatars - * @title: Avatar Widget - * - * #PidginAvatar is a widget that displays avatars for contacts or - * conversations. - */ - #include <glib.h> #include <gtk/gtk.h> @@ -46,9 +36,12 @@ G_BEGIN_DECLS /** - * PIDGIN_TYPE_AVATAR: + * PidginAvatar: * - * The standard _get_type macro for #PidginAvatar. + * #PidginAvatar is a widget that displays avatars for contacts or + * conversations. + * + * Since: 3.0.0 */ #define PIDGIN_TYPE_AVATAR (pidgin_avatar_get_type()) @@ -56,13 +49,6 @@ PIDGIN, AVATAR, GtkEventBox) /** - * PidginAvatar: - * - * #PidginAvatar is an opaque data structure and should only be accessed via - * its API. - */ - -/** * pidgin_avatar_new: * * Creates a new #PidginAvatar instance.
--- a/pidgin/pidgincellrendererexpander.h Tue Oct 19 00:48:05 2021 -0500 +++ b/pidgin/pidgincellrendererexpander.h Tue Oct 19 02:49:28 2021 -0500 @@ -27,17 +27,14 @@ #ifndef PIDGIN_CELL_RENDERER_EXPANDER_H #define PIDGIN_CELL_RENDERER_EXPANDER_H +#include <gtk/gtk.h> + /** - * SECTION:pidgincellrendererexpander - * @section_id: pidgin-cellrendererexpander - * @short_description: <filename>pidgincellrendererexpander.h</filename> - * @title: Cell Renderer Expander + * PidginCellRendererExpander: * * A #GtkCellRenderer that can hide its children. */ -#include <gtk/gtk.h> - #define PIDGIN_TYPE_CELL_RENDERER_EXPANDER (pidgin_cell_renderer_expander_get_type()) G_DECLARE_FINAL_TYPE(PidginCellRendererExpander, pidgin_cell_renderer_expander, PIDGIN, CELL_RENDERER_EXPANDER, GtkCellRenderer)
--- a/pidgin/pidginclosebutton.h Tue Oct 19 00:48:05 2021 -0500 +++ b/pidgin/pidginclosebutton.h Tue Oct 19 02:49:28 2021 -0500 @@ -26,22 +26,21 @@ #ifndef PIDGIN_CLOSE_BUTTON_H #define PIDGIN_CLOSE_BUTTON_H -/** - * SECTION:pidginclosebutton - * @section_id: pidgin-close-button - * @short_description: A widget to close things. - * @title: Close Button - * - * #PidginCloseButton is a transitional widget as we slowly migrate the - * conversation window to glade. - */ - #include <glib.h> #include <gtk/gtk.h> G_BEGIN_DECLS +/** + * PidginCloseButton: + * + * #PidginCloseButton is a transitional widget as we slowly migrate the + * conversation window to glade. + * + * Since: 3.0.0 + */ + #define PIDGIN_TYPE_CLOSE_BUTTON (pidgin_close_button_get_type()) G_DECLARE_FINAL_TYPE(PidginCloseButton, pidgin_close_button, PIDGIN, CLOSE_BUTTON, GtkButton)
--- a/pidgin/pidgincolor.h Tue Oct 19 00:48:05 2021 -0500 +++ b/pidgin/pidgincolor.h Tue Oct 19 02:49:28 2021 -0500 @@ -24,15 +24,6 @@ # error "only <pidgin.h> may be included directly" #endif -/** - * SECTION:pidgincolor - * @section_id: pidgin-color - * @short_description: Color related API - * @title: Color API - * - * A collection of API to help with color. - */ - #ifndef PIDGIN_COLOR_H #define PIDGIN_COLOR_H
--- a/pidgin/pidgincontactcompletion.h Tue Oct 19 00:48:05 2021 -0500 +++ b/pidgin/pidgincontactcompletion.h Tue Oct 19 02:49:28 2021 -0500 @@ -26,11 +26,14 @@ #ifndef PIDGIN_CONTACT_COMPLETION_H #define PIDGIN_CONTACT_COMPLETION_H +#include <gtk/gtk.h> + +#include <purple.h> + +G_BEGIN_DECLS + /** - * SECTION:pidgincontactcompletion - * @section_id: pidgin-contact-completion - * @short_description: A GtkEntryCompletion for contacts - * @title: Contact Name Completion + * PidginContactCompletion: * * #PidginContactCompletion should be treated like a normal * #GtkEntryCompletion, except it already does all of the setup for the @@ -46,12 +49,6 @@ * ]| */ -#include <gtk/gtk.h> - -#include <purple.h> - -G_BEGIN_DECLS - #define PIDGIN_TYPE_CONTACT_COMPLETION pidgin_contact_completion_get_type() G_DECLARE_FINAL_TYPE(PidginContactCompletion, pidgin_contact_completion, PIDGIN,
--- a/pidgin/pidgincontactlist.h Tue Oct 19 00:48:05 2021 -0500 +++ b/pidgin/pidgincontactlist.h Tue Oct 19 02:49:28 2021 -0500 @@ -27,34 +27,18 @@ #ifndef PIDGIN_CONTACT_LIST_H #define PIDGIN_CONTACT_LIST_H -/** - * SECTION:pidgincontactlist - * @section_id: pidgin-contactlist - * @short_description: The contact list widget. - * @title: Contact list widget - * - * #PidginContactList is a transitional widget as we slowly migrate it into the - * conversation window to make a single window application. - */ - #include <glib.h> #include <gtk/gtk.h> G_BEGIN_DECLS -/** - * PIDGIN_TYPE_CONTACT_LIST: - * - * The standard _get_type method for #PidginContactList. - * - * Since: 3.0.0 - */ /** * PidginContactList: * - * A #GtkWindow that contains the main contact list. + * #PidginContactList is a transitional widget as we slowly migrate it into the + * conversation window to make a single window application. * * Since: 3.0.0 */
--- a/pidgin/pidginconversationwindow.h Tue Oct 19 00:48:05 2021 -0500 +++ b/pidgin/pidginconversationwindow.h Tue Oct 19 02:49:28 2021 -0500 @@ -27,21 +27,20 @@ #ifndef PIDGIN_CONVERSATION_WINDOW_H #define PIDGIN_CONVERSATION_WINDOW_H -/** - * SECTION:pidginconversationwindow - * @section_id: pidgin-pidginconversationwindow - * @short_description: The main conversation window widget. - * @title: Conversation window widget - * - * #PidginConversationWindow is a widget that contains #PidginConversations. - */ - #include <glib.h> #include <gtk/gtk.h> G_BEGIN_DECLS +/** + * PidginConversationWindow: + * + * #PidginConversationWindow is a widget that contains #PidginConversations. + * + * Since: 3.0.0 + */ + #define PIDGIN_TYPE_CONVERSATION_WINDOW (pidgin_conversation_window_get_type()) G_DECLARE_FINAL_TYPE(PidginConversationWindow, pidgin_conversation_window, PIDGIN, CONVERSATION_WINDOW, GtkApplicationWindow)
--- a/pidgin/pidgincore.h Tue Oct 19 00:48:05 2021 -0500 +++ b/pidgin/pidgincore.h Tue Oct 19 02:49:28 2021 -0500 @@ -25,14 +25,6 @@ #ifndef PIDGIN_CORE_H #define PIDGIN_CORE_H -/** - * SECTION: pidgincore - * @section_id: pidgin-pidgincore - * @short_description: <filename>pidgincore.h</filename> - * @title: UI Definitions and Includes - * - * The very core of Pidgin. - */ #include <glib.h>
--- a/pidgin/pidgindebug.h Tue Oct 19 00:48:05 2021 -0500 +++ b/pidgin/pidgindebug.h Tue Oct 19 02:49:28 2021 -0500 @@ -25,12 +25,6 @@ #ifndef PIDGIN_DEBUG_H #define PIDGIN_DEBUG_H -/** - * SECTION:pidgindebug - * @section_id: pidgin-pidgindebug - * @short_description: <filename>pidgindebug.h</filename> - * @title: Debug API - */ #include <purple.h>
--- a/pidgin/pidgindialog.h Tue Oct 19 00:48:05 2021 -0500 +++ b/pidgin/pidgindialog.h Tue Oct 19 02:49:28 2021 -0500 @@ -26,22 +26,19 @@ #ifndef PIDGIN_DIALOG_H #define PIDGIN_DIALOG_H -/** - * SECTION:pidgindialog - * @section_id: pidgin-dialog - * @short_description: A base dialog widget. - * @title: Dialog - * - * #PidginDialog is a transitional widget as we slowly migrate everything to - * glade. - */ - #include <glib.h> #include <gtk/gtk.h> G_BEGIN_DECLS +/** + * PidginDialog: + * + * #PidginDialog is a transitional widget as we slowly migrate everything to + * glade. + */ + #define PIDGIN_TYPE_DIALOG (pidgin_dialog_get_type()) G_DECLARE_FINAL_TYPE(PidginDialog, pidgin_dialog, PIDGIN, DIALOG, GtkDialog)
--- a/pidgin/pidgingdkpixbuf.h Tue Oct 19 00:48:05 2021 -0500 +++ b/pidgin/pidgingdkpixbuf.h Tue Oct 19 02:49:28 2021 -0500 @@ -31,13 +31,6 @@ #include <purple.h> -/** - * SECTION:pidgingdkpixbuf - * @section_id: pidgin-gdk-pixbuf - * @short_description: <filename>pidgingdkpixbuf.h</filename> - * @title: GDK Pixbuf Helpers - */ - G_BEGIN_DECLS /**
--- a/pidgin/pidginiconname.h Tue Oct 19 00:48:05 2021 -0500 +++ b/pidgin/pidginiconname.h Tue Oct 19 02:49:28 2021 -0500 @@ -27,16 +27,6 @@ #ifndef PIDGIN_ICON_NAME_H #define PIDGIN_ICON_NAME_H -/** - * SECTION:pidginiconname - * @section_id: pidgin-pidginiconname - * @title: Icon Name Utilities - * @short_description: Get icon names for objects. - * - * This API makes it easy to determine which icon should be used for different - * objects. - */ - #include <glib.h> #include <purple.h>
--- a/pidgin/pidgininfopane.h Tue Oct 19 00:48:05 2021 -0500 +++ b/pidgin/pidgininfopane.h Tue Oct 19 02:49:28 2021 -0500 @@ -27,16 +27,6 @@ #ifndef PIDGIN_INFO_PANE_H #define PIDGIN_INFO_PANE_H -/** - * SECTION:pidgininfopane - * @section_id: pidgin-pidgininfopane - * @short_description: The information pane - * @title: Information Pane Widget - * - * #PidginInfoPane is a widget that displays information above - * #PidginConversations. - */ - #include <glib.h> #include <gtk/gtk.h> @@ -45,6 +35,15 @@ G_BEGIN_DECLS +/** + * PidginInfoPane: + * + * #PidginInfoPane is a widget that displays information above + * #PidginConversations. + * + * Since: 3.0.0 + */ + #define PIDGIN_TYPE_INFO_PANE (pidgin_info_pane_get_type()) G_DECLARE_FINAL_TYPE(PidginInfoPane, pidgin_info_pane, PIDGIN, INFO_PANE, GtkBox)
--- a/pidgin/pidgininvitedialog.h Tue Oct 19 00:48:05 2021 -0500 +++ b/pidgin/pidgininvitedialog.h Tue Oct 19 02:49:28 2021 -0500 @@ -26,11 +26,14 @@ #ifndef PIDGIN_INVITE_DIALOG_H #define PIDGIN_INVITE_DIALOG_H +#include <gtk/gtk.h> + +#include <purple.h> + +G_BEGIN_DECLS + /** - * SECTION:pidgininvitedialog - * @section_id: pidgin-invite-dialog - * @short_description: A dialog widget to invite others to chat - * @title: Invite Dialog + * PidginInviteDialog: * * #PidginInviteDialog is a simple #GtkDialog that presents the user with an * interface to invite another user to a conversation. Name completion is @@ -60,14 +63,7 @@ * ]| */ -#include <gtk/gtk.h> - -#include <purple.h> - -G_BEGIN_DECLS - #define PIDGIN_TYPE_INVITE_DIALOG pidgin_invite_dialog_get_type() - G_DECLARE_FINAL_TYPE(PidginInviteDialog, pidgin_invite_dialog, PIDGIN, INVITE_DIALOG, GtkDialog)
--- a/pidgin/pidginmenutray.h Tue Oct 19 00:48:05 2021 -0500 +++ b/pidgin/pidginmenutray.h Tue Oct 19 02:49:28 2021 -0500 @@ -24,13 +24,6 @@ #ifndef PIDGIN_MENU_TRAY_H #define PIDGIN_MENU_TRAY_H -/** - * SECTION:pidginmenutray - * @section_id: pidgin-menu-tray - * @short_description: <filename>pidginmenutray.h</filename> - * @title: Tray Menu Item - */ - #include <gtk/gtk.h> G_BEGIN_DECLS
--- a/pidgin/pidginmessage.h Tue Oct 19 00:48:05 2021 -0500 +++ b/pidgin/pidginmessage.h Tue Oct 19 02:49:28 2021 -0500 @@ -27,21 +27,20 @@ #ifndef PIDGIN_MESSAGE_H #define PIDGIN_MESSAGE_H -/** - * SECTION:pidginmessage - * @section_id: pidgin-pidginmessage - * @short_description: <filename>pidginmessage.h</filename> - * @title: Pidgin Message API - * - * #PidginMessage maps a #PurpleMessage to a #TalkatuMessage. - */ - #include <purple.h> #include <talkatu.h> G_BEGIN_DECLS +/** + * PidginMessage: + * + * #PidginMessage maps a #PurpleMessage to a #TalkatuMessage. + * + * Since: 3.0.0 + */ + #define PIDGIN_TYPE_MESSAGE (pidgin_message_get_type()) G_DECLARE_FINAL_TYPE(PidginMessage, pidgin_message, PIDGIN, MESSAGE, GObject)
--- a/pidgin/pidginmooddialog.h Tue Oct 19 00:48:05 2021 -0500 +++ b/pidgin/pidginmooddialog.h Tue Oct 19 02:49:28 2021 -0500 @@ -27,15 +27,6 @@ #ifndef PIDGIN_MOOD_DIALOG_H #define PIDGIN_MOOD_DIALOG_H -/** - * SECTION:pidginmooddialog - * @section_id: pidgin-mood-dialog - * @short_description: A dialog for selecting moods - * @title: Mood Dialog - * - * A simple dialog for selecting a global mood as well as a per account mood. - */ - #include <glib.h> #include <gtk/gtk.h>
--- a/pidgin/pidginplugininfo.h Tue Oct 19 00:48:05 2021 -0500 +++ b/pidgin/pidginplugininfo.h Tue Oct 19 02:49:28 2021 -0500 @@ -34,6 +34,14 @@ G_BEGIN_DECLS +/** + * PidginPluginInfo: + * + * A #GPluginPluginInfo subclass that adds some Pidgin specific properties. + * + * Since: 3.0.0 + */ + #define PIDGIN_TYPE_PLUGIN_INFO (pidgin_plugin_info_get_type()) G_DECLARE_FINAL_TYPE(PidginPluginInfo, pidgin_plugin_info, PIDGIN, PLUGIN_INFO, PurplePluginInfo)
--- a/pidgin/pidginpluginsdialog.h Tue Oct 19 00:48:05 2021 -0500 +++ b/pidgin/pidginpluginsdialog.h Tue Oct 19 02:49:28 2021 -0500 @@ -27,17 +27,16 @@ #ifndef PIDGIN_PLUGINS_DIALOG_H #define PIDGIN_PLUGINS_DIALOG_H -/** - * SECTION:pidginpluginsdialog - * @section_id: pidgin-plugins-dialog - * @short_description: A widget to display available plugins - * @title: Plugins Dialog - */ - #include <gtk/gtk.h> G_BEGIN_DECLS +/** + * PidginPluginsDialog: + * + * A dialog that allows the user to configure their plugins. + */ + #define PIDGIN_TYPE_PLUGINS_DIALOG (pidgin_plugins_dialog_get_type()) G_DECLARE_FINAL_TYPE(PidginPluginsDialog, pidgin_plugins_dialog, PIDGIN, PLUGINS_DIALOG, GtkDialog)
--- a/pidgin/pidginpluginsmenu.h Tue Oct 19 00:48:05 2021 -0500 +++ b/pidgin/pidginpluginsmenu.h Tue Oct 19 02:49:28 2021 -0500 @@ -27,23 +27,22 @@ #ifndef PIDGIN_PLUGINS_MENU_H #define PIDGIN_PLUGINS_MENU_H +#include <gtk/gtk.h> + +G_BEGIN_DECLS + /** - * SECTION:pidginpluginsmenu - * @section_id: pidgin-plugins-menu - * @short_description: A menu for managing plugins and their actions - * @title: Plugins Menu + * PidginPluginsMenu: * * #PidginPluginsMenu is a #GtkMenu that provides an interface to users to open * the plugin manager as well as activate plugin actions. * * It manages itself as plugins are loaded and unloaded and can be added as a * submenu to any #GtkMenuItem. + * + * Since: 3.0.0 */ -#include <gtk/gtk.h> - -G_BEGIN_DECLS - #define PIDGIN_TYPE_PLUGINS_MENU (pidgin_plugins_menu_get_type()) G_DECLARE_FINAL_TYPE(PidginPluginsMenu, pidgin_plugins_menu, PIDGIN, PLUGINS_MENU, GtkMenu)
--- a/pidgin/pidginpresenceicon.h Tue Oct 19 00:48:05 2021 -0500 +++ b/pidgin/pidginpresenceicon.h Tue Oct 19 02:49:28 2021 -0500 @@ -27,20 +27,19 @@ #ifndef PIDGIN_PRESENCE_ICON_H #define PIDGIN_PRESENCE_ICON_H +#include <gtk/gtk.h> + +#include <purple.h> + /** - * SECTION:pidginpresenceicon - * @section_id: pidgin-pidginpresenceicon - * @short_description: Icons for presences - * @title: Presence Icons + * PidginPresenceIcon: * * A #GtkImage subclass that will automatically update when the given presence * changes. + * + * Since: 3.0.0 */ -#include <gtk/gtk.h> - -#include <purple.h> - #define PIDGIN_TYPE_PRESENCE_ICON (pidgin_presence_icon_get_type()) G_DECLARE_FINAL_TYPE(PidginPresenceIcon, pidgin_presence_icon, PIDGIN, PRESENCE_ICON, GtkImage)
--- a/pidgin/pidginprotocolchooser.h Tue Oct 19 00:48:05 2021 -0500 +++ b/pidgin/pidginprotocolchooser.h Tue Oct 19 02:49:28 2021 -0500 @@ -28,13 +28,6 @@ #ifndef PIDGIN_PROTOCOL_CHOOSER_H #define PIDGIN_PROTOCOL_CHOOSER_H -/** - * SECTION:pidginprotocolchooser - * @section_id: pidgin-protocol-chooser - * @short_description: A #GtkComboBox for choosing protocols - * @title: Pidgin Protocol Chooser Combo Box Widget - */ - #include <gtk/gtk.h> #include <purple.h>
--- a/pidgin/pidginprotocolstore.h Tue Oct 19 00:48:05 2021 -0500 +++ b/pidgin/pidginprotocolstore.h Tue Oct 19 02:49:28 2021 -0500 @@ -27,14 +27,13 @@ #define PIDGIN_PROTOCOL_STORE_H /** - * SECTION:pidginprotocolstore - * @section_id: pidgin-protocol-store - * @short_description: A GtkListStore that keeps track of protocols - * @title: Protocol Store + * PidginProtocolStore: * * #PidginProtocolStore is a #GtkListStore that automatically keeps track of * what protocols are currently available in libpurple. It's intended to be * used any time that you need to present a protocol selection to the user. + * + * Since: 3.0.0 */ #include <gtk/gtk.h>
--- a/pidgin/pidginscrollbook.h Tue Oct 19 00:48:05 2021 -0500 +++ b/pidgin/pidginscrollbook.h Tue Oct 19 02:49:28 2021 -0500 @@ -27,9 +27,7 @@ #ifndef PIDGIN_SCROLL_BOOK_H #define PIDGIN_SCROLL_BOOK_H /** - * SECTION:pidginscrollbook - * @section_id: pidgin-pidginscrollbook - * @title: Scrolling Notebook Widget + * PidginScrollBook: * * This widget is used to show error messages in the buddy list window. */
--- a/pidgin/pidginstock.h Tue Oct 19 00:48:05 2021 -0500 +++ b/pidgin/pidginstock.h Tue Oct 19 02:49:28 2021 -0500 @@ -25,12 +25,6 @@ #ifndef _PIDGIN_STOCK_H_ #define _PIDGIN_STOCK_H_ -/** - * SECTION:pidginstock - * @section_id: pidgin-pidginstock - * @short_description: <filename>pidginstock.h</filename> - * @title: Stock Resources - */ #include <gtk/gtk.h> #include "gtkstatus-icon-theme.h"
--- a/pidgin/pidginstylecontext.h Tue Oct 19 00:48:05 2021 -0500 +++ b/pidgin/pidginstylecontext.h Tue Oct 19 02:49:28 2021 -0500 @@ -24,15 +24,6 @@ # error "only <pidgin.h> may be included directly" #endif -/** - * SECTION:pidginstylecontext - * @section_id: pidgin-pidginstylecontext - * @short_description: Dark theme helpers. - * @title: GtkStyleContext Helpers - * - * A collection of API to help with handling dark themes. - */ - #ifndef PIDGIN_STYLE_CONTEXT_H #define PIDGIN_STYLE_CONTEXT_H
--- a/pidgin/pidgintalkatu.h Tue Oct 19 00:48:05 2021 -0500 +++ b/pidgin/pidgintalkatu.h Tue Oct 19 02:49:28 2021 -0500 @@ -26,13 +26,6 @@ #ifndef PIDGIN_TALKATU_H #define PIDGIN_TALKATU_H -/** - * SECTION:pidgintalkatu - * @section_id: pidgin-talkatu - * @short_description: <filename>pidgintalkatu.h</filename> - * @title: Talkatu Helpers - */ - #include <gtk/gtk.h> #include <talkatu.h>
