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