Mercurial > irccd
view plugins/history/history.7 @ 1087:eee4d67d78a8
irccd: resurrect -v option
author | David Demelier <markand@malikania.fr> |
---|---|
date | Wed, 21 Jul 2021 08:41:38 +0200 |
parents | 3dec26654d06 |
children | f06e9761cc90 |
line wrap: on
line source
.\" .\" Copyright (c) 2013-2021 David Demelier <markand@malikania.fr> .\" .\" Permission to use, copy, modify, and/or distribute this software for any .\" purpose with or without fee is hereby granted, provided that the above .\" copyright notice and this permission notice appear in all copies. .\" .\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES .\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF .\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR .\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES .\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. .\" .Dd @IRCCD_MAN_DATE@ .Dt IRCCD-PLUGIN-HISTORY 7 .Os .\" NAME .Sh NAME .Nm history .Nd irccd history plugin .\" DESCRIPTION .Sh DESCRIPTION The .Nm plugin is used to check when someone has been seen for the last time on a channel. For that purpose, irccd needs to be on that channel forever if possible. .\" INSTALLATION .Sh INSTALLATION The plugin .Nm is distributed with irccd. To enable it add it into your .Xr irccd.conf 5 configuration file. .Pp .Bd -literal -offset indent plugin "history" .Ed .\" USAGE .Sh USAGE The plugin .Nm history reacts to the special command. It understands .Ar seen and .Ar said sub commands. .Pp .Bl -bullet -compact .It The sub command .Ar seen tells you when the user has been seen for the last time. .It The sub command .Ar said tells you what the user has said for the last time. .El .Pp Example .Bd -literal -offset Ds markand: !history seen jean irccd: markand, the last time I've seen jean was on 18/01/1989 at 20:55 markand: !history said jean irccd: markand, the last thing that jean said was: hello world .Ed .\" CONFIGURATION .Sh CONFIGURATION The plugin .Nm supports the following configuration properties: .Bl -tag -width "file (string)" .It Va file No (string) path to the JSON file for saving information (Optional. default to cache directory). .El .\" TEMPLATES .Sh TEMPLATES The plugin .Nm supports the following template properties: .Bl -tag -width unknown .It Va error Template when an internal error occured. Keywords: .It Va seen Template for showing last seen. Keywords: .Em target , (date) . .It Va said Template for showing the last message. Keywords: .Em message , target , (date) . .It Va unknown Template when the user has never been seen. Keywords: .Em target . .It Va usage Template to show the plugin usage. .El .Pp All templates support the following standard keywords: .Em channel , command , nickname , origin , plugin , server . .\" EXAMPLES .Sh EXAMPLES Example of configuration file: .Bd -literal plugin "history" { templates { "seen" "#{target} has been seen on #{channel} the last time on: %d/%m/%Y %H:%M"; } } .Ed .\" SEE ALSO .Sh SEE ALSO .Xr irccd 1 , .Xr irccd-templates 7