comparison doc/man/irccd.1.in @ 0:1158cffe5a5e

Initial import
author David Demelier <markand@malikania.fr>
date Mon, 08 Feb 2016 16:43:14 +0100
parents
children 2a6ac6daceee
comparison
equal deleted inserted replaced
-1:000000000000 0:1158cffe5a5e
1 .\"
2 .\" Copyright (c) 2013-2016 David Demelier <markand@malikania.fr>
3 .\"
4 .\" Permission to use, copy, modify, and/or distribute this software for any
5 .\" purpose with or without fee is hereby granted, provided that the above
6 .\" copyright notice and this permission notice appear in all copies.
7 .\"
8 .\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
9 .\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
10 .\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
11 .\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
12 .\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
13 .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
14 .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
15 .\"
16 .Dd @MONTH@ @DAY@, @YEAR@
17 .Dt IRCCD 1
18 .Os
19 .Sh NAME
20 .Nm irccd
21 .Nd an IRC client daemon
22 .Sh SYNOPSIS
23 .Nm
24 .Op Fl f
25 .Op Fl v
26 .Op Fl c Ar config
27 .Sh DESCRIPTION
28 The irccd program aims to provide an IRC client that acts as a daemon.
29 .Pp
30 The features are listed below:
31 .Bl -bullet
32 .It
33 Connect to one or more servers,
34 .It
35 Use different identities for each servers,
36 .It
37 Manageable by UNIX or Internet sockets (both TCP and UDP),
38 .It
39 Highly extensible with Lua plugins,
40 .El
41 .Pp
42 The application run as daemon and wait for events in both IRC servers
43 or from the irccdctl(1) utility.
44 .Pp
45 For instance, when IRC events happen, it calls Lua functions from plugins to
46 execute specific actions. Example: someone join the channel, the
47 .Nm irccd
48 daemon will notify all plugins that a specific user joined.
49 .Pp
50 But it is also possible to use irccdctl(1) to control
51 .Nm irccd .
52 For instance, you may want at any time to change the nick of the irccd daemon,
53 is it possible with one command.
54 .Pp
55 The following options are available:
56 .Bl -tag -width indent
57 .It Fl f
58 Do not run as a daemon.
59 .It Fl c Ar config
60 A path to a config file.
61 .It Fl v
62 Be more verbose.
63 .El
64 .\" SEE ALSO
65 .Sh SEE ALSO
66 .Xr irccdctl 1 ,
67 .Xr irccd.conf 5
68 .\" AUTHORS
69 .Sh AUTHORS
70 irccd was written by David Demelier <markand@malikania.fr>