.\" -*- 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-LIBRAVATAR 7"
.TH CLAWS-MAIL-LIBRAVATAR 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\-libravatar \- show profile images from a libravatar server
.SH DESCRIPTION
.IX Header "DESCRIPTION"
This manual page documents briefly the \fBclaws-mail-libravatar\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-libravatar\fR is a plugin (loadable module) for the \fIClaws
Mail\fR mailer.
.PP
Allows showing the sender profile image stored in the libravatar server
configured in the sender's domain (a federated domain) or the
libravatar.org server if the former is not available.
.PP
If no profile is available in libravatar.org, as current fallback of the
service, gravatar.com servers are also tried. This behaviour can be
disabled by plugin's configuration if desired.
.PP
If no profile image is found at all the plugin can be also configured to
request a generated image from the libravatar service (through one of
the available methods) or even from a custom URL.
.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 \fBlibravatar.so\fR, and press the “Open” button.
.SH CAVEATS
.IX Header "CAVEATS"
This plugin may slow down message display because of the additional
network access required for image retrieval, specially on flaky
networks. Disabling image cache or setting a cache refresh interval too
low will only make this slowness more noticeable and is not recommended.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
\&\fBclaws-mail\fR(1),
\&\fBclaws-mail-extra-plugins\fR(7),
Libravatar site .
.SH AUTHORS
.IX Header "AUTHORS"
.IP "Ricardo Mones " 4
.IX Item "Ricardo Mones "
Wrote the \fBclaws-mail-libravatar\fR plugin.
.IP "Ricardo Mones " 4
.IX Item "Ricardo Mones "
Wrote this manpage for the Debian™ system.
.SH COPYRIGHT
.IX Header "COPYRIGHT"
Copyright © 2014\-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.