1feedfe13be33ee5a9457fecf31ccee20c17101c
[ngircd-alex.git] / README
1
2                      ngIRCd - Next Generation IRC Server
3
4                         (c)2001-2007 Alexander Barton,
5                     alex@barton.de, http://www.barton.de/
6
7                ngIRCd is free software and published under the
8                    terms of the GNU General Public License.
9
10                                 -- README --
11
12
13 I. Introduction
14 ~~~~~~~~~~~~~~~
15
16 ngIRCd is an Open Source server for the Internet Relay Chat (IRC), which
17 is developed and published under the terms of the GNU General Public
18 Licence (URL: http://www.gnu.org/licenses/gpl.html). ngIRCd means "next
19 generation IRC daemon", it's written from scratch and not deduced from the
20 "grandfather of IRC daemons", the daemon of the IRCNet.
21
22 Please see the INSTALL document for installation and upgrade information!
23
24
25 II. Status
26 ~~~~~~~~~~~
27
28 It is not the goal of ngIRCd to implement all the nasty behaviours of the
29 original ircd, but to implement most of the useful commands and semantics
30 specified by the RFCs.
31
32 In the meantime ngIRCd should be quite feature complete and stable to be
33 used in real IRC networks.
34
35 Implemented IRC-commands are:
36
37 ADMIN, AWAY, CHANINFO, CONNECT, DIE, DISCONNECT, ERROR, HELP, INFO, INVITE,
38 ISON, JOIN, KICK, KILL, LINKS, LIST, LUSERS, MODE, MOTD, NAMES, NICK, NJOIN,
39 NOTICE, OPER, PART, PASS, PING, PONG, PRIVMSG, QUIT, REHASH, RESTART, SERVER,
40 SERVICE, SERVLIST, SQUERY, SQUIT,  STATS, SUMMON, TIME, TOPIC, TRACE, USER,
41 USERHOST, USERS, VERSION, WALLOPS, WEBIRC, WHO, WHOIS, WHOWAS.
42
43
44 III. Features (or: why use ngIRCd?)
45 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
46
47 - no problems with servers which have dynamic IP addresses
48 - simple, easy understandable configuration file,
49 - freely published open-source C source code,
50 - ngIRCd will be developed on in the future.
51 - wide field of supported platforms, including AIX, A/UX, FreeBSD, HP-UX,
52   IRIX, Linux, Mac OS X, NetBSD, OpenBSD, Solaris, and Windows with Cygwin.
53
54
55 IV. Documentation
56 ~~~~~~~~~~~~~~~~~
57
58 More documentation can be found in the "doc/" directory and the homepage of
59 the ngIRCd: <http://ngircd.barton.de/>.
60
61
62 V. Download
63 ~~~~~~~~~~~
64
65 The homepage of the ngIRCd is: <http://ngircd.barton.de/>; you will find
66 the newest information about the ngIRCd and the most recent ("stable")
67 releases there.
68
69 If you are interested in the latest development versions (which are not
70 always stable), then please read the section about "GIT" on the homepage and
71 the file "doc/GIT.txt" which describes the use of GIT, the version control
72 system used by ngIRCd (homepage: http://git.or.cz/).
73
74
75 VI. Bugs
76 ~~~~~~~~
77
78 If you find bugs in the ngIRCd (which might be there :-), please report
79 them at the following URL:
80
81 <http://ngircd.barton.de/bugtracker.php>
82
83 There you can read about known bugs and limitations, too.
84
85 If you have critics, patches or something else, please feel free to post a
86 mail to the ngIRCd mailing list: <ngircd-ml@arthur.ath.cx> (please see
87 <http://ngircd.barton.de/support.php#ml> for details).