.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "CLAWS-MAIL-FETCHINFO-PLUGIN 7"
.TH CLAWS-MAIL-FETCHINFO-PLUGIN 7 2024-04-28 4.2.0-2+b3 "Claws Mail"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH NAME
claws\-mail\-fetchinfo\-plugin \- inserts headers with download information
.SH DESCRIPTION
.IX Header "DESCRIPTION"
This manual page documents briefly the \fBclaws-mail-fetchinfo-plugin\fR
package.
.PP
This manual page was written for the Debian™ distribution because the
original program does not have a manual page.
.PP
\&\fBclaws-mail-fetchinfo-plugin\fR is a plugin (loadable module) for the
\&\fIClaws Mail\fR mailer.
.PP
This plugin enables adding several extra headers to the received mails
containing additional download information. These headers can be used
later in filtering or processing rules, extending mail identification
and/or classification capabilities.
.PP
Currently the following headers can be added:
.IP X\-FETCH-ACCOUNT 4
.IX Item "X-FETCH-ACCOUNT"
Receiving account name from \fIClaws Mail\fR configuration (As appears in
the accountrc file).
.IP X\-FETCH-SERVER 4
.IX Item "X-FETCH-SERVER"
POP3 server used for downloading.
.IP X\-FETCH-TIME 4
.IX Item "X-FETCH-TIME"
Timestamp of download, RFC\-822 formatted.
.IP X\-FETCH-UIDL 4
.IX Item "X-FETCH-UIDL"
UIDL specifying the message on the server.
.IP X\-FETCH-USERID 4
.IX Item "X-FETCH-USERID"
Username in the receiving account.
.SH USAGE
.IX Header "USAGE"
Before using a plugin you must instruct \fIClaws Mail\fR to load it on
startup.
.PP
For this you must go “Configuration” menu on main window toolbar, open
“Plugins...”  dialog, click on the “Load plugin...”  button and select
the plugin file, named \fBfetchinfo_plugin.so\fR, and press the “Open”
button.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
\&\fBclaws-mail\fR(1),
\&\fBclaws-mail-extra-plugins\fR(7).
.SH AUTHORS
.IX Header "AUTHORS"
.IP "Thorsten Maerz <torte@netztorte.de>" 4
.IX Item "Thorsten Maerz <torte@netztorte.de>"
Wrote the \fBclaws-mail-fetchinfo-plugin\fR plugin.
.IP "Ricardo Mones <mones@debian.org>" 4
.IX Item "Ricardo Mones <mones@debian.org>"
Wrote this manpage for the Debian™ system.
.SH COPYRIGHT
.IX Header "COPYRIGHT"
Copyright © 2006\-2020 Ricardo Mones
.PP
This manual page was written for the Debian system (but may be used by
others).
.PP
Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU General Public License, Version 3 or (at your
option) any later version published by the Free Software Foundation.
.PP
On Debian systems, the complete text of the GNU General Public License
can be found in \fI/usr/share/common\-licenses/GPL\fR.