pidgin/pidgin

closing merged branch
Ball--Gy-rgy/update-screenshot-url-in-appdata-file-1591293245974
2020-06-07, Gary Kramlich
708c6622acc6
closing merged branch
<?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-xfer">
<title>File Transfer signals</title>
<refsect1 id="xfers.signals" role="signal_proto">
<title role="signal_proto.title">List of signals</title>
<synopsis>
&quot;<link linkend="xfers-file-recv-request">file-recv-request</link>&quot;
</synopsis>
</refsect1>
<refsect1 id="xfers.signal-details" role="signals">
<title role="signals.title">Signal details</title>
<refsect2 id="xfers-file-recv-request" role="signal">
<title>The <literal>&quot;file-recv-request&quot;</literal> signal</title>
<programlisting>
void user_function (PurpleXfer *xfer,
gpointer data)
</programlisting>
<para>
Emitted before the user is prompted for an incoming file-transfer. Plugins can intercept the signal to auto-accept/auto-reject the requests. To auto-accept the file transfer, use purple_xfer_request_accepted(). To auto-reject, set the status of the xfer to PURPLE_XFER_STATUS_CANCEL_LOCAL.
</para>
<variablelist role="params">
<varlistentry>
<term><parameter>xfer</parameter>&#160;:</term>
<listitem><simpara>The file transfer.</simpara></listitem>
</varlistentry>
<varlistentry>
<term><parameter>data</parameter>&#160;:</term>
<listitem><simpara>User data.</simpara></listitem>
</varlistentry>
</variablelist>
</refsect2>
</refsect1>
</chapter>