Fri, 01 Oct 2021 17:49:31 -0500
move the zephyr protocol plugins icons to a resource in the plugin
Testing Done:
Ran in devenv with a logo inverted (which was reverted before committing).
Reviewed at https://reviews.imfreedom.org/r/981/
<?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-notify"> <title>Notify signals</title> <refsect1 id="notify.signals" role="signal_proto"> <title role="signal_proto.title">List of signals</title> <synopsis> "<link linkend="notify-displaying-userinfo">displaying-userinfo</link>" "<link linkend="notify-displaying-email-notification">displaying-email-notification</link>" "<link linkend="notify-displaying-emails-notification">displaying-emails-notification</link>" </synopsis> </refsect1> <refsect1 id="notify.signal-details" role="signals"> <title role="signals.title">Signal details</title> <refsect2 id="notify-displaying-userinfo" role="signal"> <title>The <literal>"displaying-userinfo"</literal> signal</title> <programlisting> void user_function (PurpleAccount *account, const char *who, PurpleNotifyUserInfo *user_info, gpointer user_data) </programlisting> <para> Emitted before userinfo is handed to the UI to display. <literal>user_info</literal> can be manipulated via the PurpleNotifyUserInfo API in notify.c. </para> <note><para> If adding a PurpleNotifyUserInfoEntry, be sure not to free it -- PurpleNotifyUserInfo assumes responsibility for its objects. </para></note> <variablelist role="params"> <varlistentry> <term><parameter>account</parameter> :</term> <listitem><simpara>The account on which the info was obtained.</simpara></listitem> </varlistentry> <varlistentry> <term><parameter>who</parameter> :</term> <listitem><simpara>The name of the buddy whose info is to be displayed.</simpara></listitem> </varlistentry> <varlistentry> <term><parameter>user_info</parameter> :</term> <listitem><simpara>The information to be displayed, as PurpleNotifyUserInfoEntry objects.</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="notify-displaying-email-notification" role="signal"> <title>The <literal>"displaying-email-notification"</literal> signal</title> <programlisting> void user_function (const char *subject, const char *from, const char *to, const char *url, gpointer user_data) </programlisting> <para> Emitted before notification of a single email is handed to the UI to display. </para> <variablelist role="params"> <varlistentry> <term><parameter>subject</parameter> :</term> <listitem><simpara>Subject of email being notified of.</simpara></listitem> </varlistentry> <varlistentry> <term><parameter>from</parameter> :</term> <listitem><simpara>Who the email is from.</simpara></listitem> </varlistentry> <varlistentry> <term><parameter>to</parameter> :</term> <listitem><simpara>Who the email is to.</simpara></listitem> </varlistentry> <varlistentry> <term><parameter>url</parameter> :</term> <listitem><simpara>A url to view the email.</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="notify-displaying-emails-notification" role="signal"> <title>The <literal>"displaying-emails-notification"</literal> signal</title> <programlisting> void user_function (const char **subjects, const char **froms, const char **tos, const char **urls, guint count, gpointer user_data) </programlisting> <para> Emitted before notification of multiple emails is handed to the UI to display. </para> <variablelist role="params"> <varlistentry> <term><parameter>subjects</parameter> :</term> <listitem><simpara>Subjects of emails being notified of.</simpara></listitem> </varlistentry> <varlistentry> <term><parameter>froms</parameter> :</term> <listitem><simpara>Who the emails are from.</simpara></listitem> </varlistentry> <varlistentry> <term><parameter>tos</parameter> :</term> <listitem><simpara>Who the emails are to.</simpara></listitem> </varlistentry> <varlistentry> <term><parameter>urls</parameter> :</term> <listitem><simpara>The urls to view the emails.</simpara></listitem> </varlistentry> <varlistentry> <term><parameter>count</parameter> :</term> <listitem><simpara>Number of emails being notified of.</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>