From: Alexander Barton Date: Sun, 6 Sep 2015 16:34:54 +0000 (+0200) Subject: Update documentation for ngIRCd Release 23~rc1 X-Git-Url: https://arthur.barton.de/gitweb/?p=ngircd-web.git;a=commitdiff_plain;h=e02d091d60f53af2f1aacd458448f3081a71cb34;hp=c381a009cb99635fbfa3cc0e3320f2fbe0e21ad5 Update documentation for ngIRCd Release 23~rc1 --- diff --git a/doc/AUTHORS b/doc/AUTHORS index ce6d113..749dc3a 100644 --- a/doc/AUTHORS +++ b/doc/AUTHORS @@ -9,9 +9,11 @@ -- AUTHORS and CONTRIBUTORS -- -Note: If you have critics, patches or something else, please feel free to -post a mail to the ngIRCd mailing list: (please -see for details). +Note: +If you have comments, patches or something else, please feel free to post +a mail to the ngIRCd mailing list: (please see + for details) or join the ngIRCd IRC +channel: . Don't mail the people listed here directly, if possible! @@ -39,15 +41,23 @@ Eric Grunow Federico G. Schwindt Gabor Adam Toth Goetz Hoffart +Ian Chard Ilja Osthoff Jari Aalto +LucentW +Mantas Mikulėnas Neale Pickett +Peter Powell Rolf Eike Beer +Roy Sindre Norangshol Scott Perry Sean Reifschneider Sebastian Köhler Tassilo Schweyer +Tom Ryder +Unit 193 William Pitcock +Yecheng Fu xor diff --git a/doc/ChangeLog b/doc/ChangeLog index bd65366..b39ef88 100644 --- a/doc/ChangeLog +++ b/doc/ChangeLog @@ -9,6 +9,78 @@ -- ChangeLog -- +ngIRCd 23 + + ngIRCd 23~rc1 (2015-09-06) + - Add ".clang_complete" file, which is used by the "linter-clang" package + of the Atom editor, for example. + - Make server-to-server protocol more robust: ngIRCd now catches more + errors on the server-to-server (S2S) protocol that could crash the + daemon before. This hasn't been a real problem because the IRC S2S + protocol is "trusted" by design, but the behavior is much better now. + Thanks to wowaname on #ngircd for pointing this out! + - Make platformtest.sh, autogen.sh, and ngircd.init more portable. + - Enables "reproducible builds" for ngIRCd: Use the optional BIRTHTIME + constant while building ngIRCd, which contains a time stamp for the + "Birth Date" information, in seconds since the epoch. + See . + - Update "contrib/ngircd.service" file for systemd. + - INSTALL: Add deprecation notice for "PredefChannelsOnly" variable. + - Use "NOTICE *" before registration instead of "NOTICE AUTH". "AUTH" is + a valid nickname so sending notices to it is probably not a good idea. + Use "*" as the target instead as done with numerics when the nick is not + available. This mimics the behaviour in Charybdis, IRCD-Hybrid, InspIRCd + 2.2, Plexus 4, etc. Closes #217. + The "NoticeAuth" configuration variable (ngircd.conf) has been renamed + to "NoticeBeforeRegistration" accordingly, but the old name is still + supported for compatibility reasons. + - Implement new channel mode "N" (regular users can't change their nick + name while on this channel). Closes #214. + - README, AUTHORS: Update mailing list and issue tracker URLs. + - Remove doc/GIT.txt (it is outdated), update doc/Contributing.txt: + ngIRCd uses GitHub, and Git itself is quite common today. So don't + include an own Git "mini HowTo" any longer. + - Specify session context for OpenSSL clients. This enables some OpenSSL + clients, including Pidgin and stunnel 5.06, to reuse a session. + Patch by Tom Ryder , thanks! Closes #182. + - Keep track of who placed bans, invites, and excepts. + Idee and implementation by LucentW, Thanks! Closes #203. + - Make setgroups(3) function optional: For example, Interix is missing + this function, which prevented ngIRCd to build on this platform. When + setgroups(3) isn't available, a warning message is issued on startup. + - Implement numeric RPL_LISTSTART(321). lightIRC and other clients + expecting RPL_LISTSTART should now behave correctly. + Idee and implementation by LucentW, Thanks! Closes #207. + - Update ngircd.conf.5: "CloadUserToNick" hides user _and_ real name. + This closes #208. + - Fix case insensitive pattern matching: Up to now, only the the input + string became lowercased and was then compared to the pattern -- which + failed when the pattern itself wasn't all lowercase! + - Streamline the effect of "MorePrivacy" option: Update documentation + in ngircd.conf(5); don't hide channels for IRC Ops on LIST and don't + hide IP addresses/hostnames on WHOIS when "MorePrivacy" is in effect. + This closes #198. + - IRC operators now can kick anyone when "OperCanMode" is set. + Idee and implementation by LucentW, Thanks! Closes #202. + - Implement user mode "I": Hide channels on WHOIS: this mode prevents + ngIRCd from showing channels on WHOIS (IRC Operators can always see + the channel list). + Idee and implementation by LucentW, Thanks! Closes #197. + - INVITE command: Implement ERR_USERNOTONSERV(504) numeric and make sure + that the target user is on the same server when inviting other users + to local ("&") channels. + Idea by Cahata, thanks! Closes #183. + - INVITE command: Enforce 1 second penalty time, which prevents flooding + of the target client. + This closes #186. Reported by Cahata, thanks! + - MODE command: Always report channel creation time. Up to now when + receiving a MODE command, ngIRCd only reported the channel creation + time to clients that were members of the channel. This patch reports + the channel creation time to all clients, regardless if they are joined + to that channel or not. At least ircd-seven behaves like this. + This closes #188. Reported by Cahata, thanks! + - Update Xcode project for latest Xcode version (6.3). + ngIRCd 22.1 (2015-04-06) - Update doc/Platforms.txt and doc/FAQ.txt. diff --git a/doc/Contributing.txt b/doc/Contributing.txt index 089afd4..677a1b8 100644 --- a/doc/Contributing.txt +++ b/doc/Contributing.txt @@ -2,7 +2,7 @@ ngIRCd - Next Generation IRC Server http://ngircd.barton.de/ - (c)2001-2011 Alexander Barton and Contributors. + (c)2001-2015 Alexander Barton and Contributors. ngIRCd is free software and published under the terms of the GNU General Public License. @@ -52,3 +52,9 @@ get an idea of how to do it the best :-) And this is open source, your work must not be 100% finished and perfect, work in progress is interesting, too: "release early, release often"! + +- Use GitHub to create "Pull Requests" + + ngIRCd is hosted on GitHub (), so please use the + tools available there and open issues (comment!) and create pull requests! + See for details. diff --git a/doc/HowToRelease.txt b/doc/HowToRelease.txt index c965b79..af78cee 100644 --- a/doc/HowToRelease.txt +++ b/doc/HowToRelease.txt @@ -37,6 +37,7 @@ II. How to prepare a new ngIRCd release? ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ a) Make sure the source tree is in a releasable state ;-) + - is the AUTHORS file up to date? b) Make sure you have working versions of GNU autoconf and GNU automake installed on the system you use for generating the release: diff --git a/doc/INSTALL b/doc/INSTALL index fa73bd7..c442676 100644 --- a/doc/INSTALL +++ b/doc/INSTALL @@ -14,6 +14,10 @@ I. Upgrade Information Differences to version 22.x +- The "NoticeAuth" ngircd.conf configuration variable has been renamed to + "NoticeBeforeRegistration". The old "NoticeAuth" variable still works but + is deprecated now. + - The default value of the SSL "CipherList" variable has been changed to "HIGH:!aNULL:@STRENGTH:!SSLv3" (OpenSSL) and "SECURE128:-VERS-SSL3.0" (GnuTLS) to disable the old SSLv3 protocol by default. @@ -32,6 +36,10 @@ Differences to version 20.x the new mask will be KILL'ed. This was not the case with earlier versions that only added the mask but didn't kill already connected users. +- The "PredefChannelsOnly" configuration variable has been superseeded by the + new "AllowedChannelTypes" variable. It is still supported and translated to + the apropriate "AllowedChannelTypes" setting but is deprecated now. + Differences to version 19.x - Starting with ngIRCd 20, users can "cloak" their hostname only when the @@ -40,7 +48,7 @@ Differences to version 19.x set mode +x. This prevents regular users from changing their hostmask to the name of the IRC server itself, which confused quite a few people ;-) -Differences to version 17 +Differences to version 17.x - Support for ZeroConf/Bonjour/Rendezvous service registration has been removed. The configuration option "NoZeroconf" is no longer available. @@ -77,7 +85,7 @@ Differences to version 17 You should adjust your ngircd.conf and run "ngircd --configtest" to make sure that your settings are correct and up to date! -Differences to version 16 +Differences to version 16.x - Changes to the "MotdFile" specified in ngircd.conf now require a ngircd configuration reload to take effect (HUP signal, REHASH command). diff --git a/doc/Modes.txt b/doc/Modes.txt index a931787..d2f6dad 100644 --- a/doc/Modes.txt +++ b/doc/Modes.txt @@ -2,7 +2,7 @@ ngIRCd - Next Generation IRC Server http://ngircd.barton.de/ - (c)2001-2014 Alexander Barton and Contributors. + (c)2001-2015 Alexander Barton and Contributors. ngIRCd is free software and published under the terms of the GNU General Public License. @@ -28,6 +28,7 @@ channels he is using at the moment. C 19 Only users that share a channel are allowed to send messages. F 22 Relaxed flood protection (only settable by IRC Operators). i 0.0.1 User is "invisible". + I 23 No channels are shown on WHOIS (IRC Ops can always see those). o 0.0.1 User is IRC operator. q 20 User is protected, can not be kicked from a channel. r 0.0.1 User is restricted. @@ -55,6 +56,7 @@ users to lists (e.g. "invite list", "ban list"), others have parameters m 0.3.0 Channel is moderated, only "voiced" users can send messages. M 20 Only registered users (and IRC Ops) can send messages. n 0.3.0 Channel doesn't allow messages of users not being members. + N 23 Users can't change their nickname while on this channel. O 18 Only IRC operators are allowed to join this channel. P 0.5.0 Channel is "persistent". Q 20 Nobody can be kicked from the channel. diff --git a/doc/NEWS b/doc/NEWS index 578b9f0..8fd24a3 100644 --- a/doc/NEWS +++ b/doc/NEWS @@ -9,6 +9,45 @@ -- NEWS -- +ngIRCd 23 + + ngIRCd 23~rc1 (2015-09-06) + - Use "NOTICE *" before registration instead of "NOTICE AUTH". "AUTH" is + a valid nickname so sending notices to it is probably not a good idea. + Use "*" as the target instead as done with numerics when the nick is not + available. This mimics the behaviour in Charybdis, IRCD-Hybrid, InspIRCd + 2.2, Plexus 4, etc. Closes #217. + The "NoticeAuth" configuration variable (ngircd.conf) has been renamed + to "NoticeBeforeRegistration" accordingly, but the old name is still + supported for compatibility reasons. + - Implement new channel mode "N" (regular users can't change their nick + name while on this channel). Closes #214. + - Keep track of who placed bans, invites, and excepts. + Idee and implementation by LucentW, Thanks! Closes #203. + - Implement numeric RPL_LISTSTART(321). lightIRC and other clients + expecting RPL_LISTSTART should now behave correctly. + Idee and implementation by LucentW, Thanks! Closes #207. + - Streamline the effect of "MorePrivacy" option: Update documentation + in ngircd.conf(5); don't hide channels for IRC Ops on LIST and don't + hide IP addresses/hostnames on WHOIS when "MorePrivacy" is in effect. + This closes #198. + - IRC operators now can kick anyone when "OperCanMode" is set. + Idee and implementation by LucentW, Thanks! Closes #202. + - Implement user mode "I": Hide channels on WHOIS: this mode prevents + ngIRCd from showing channels on WHOIS (IRC Operators can always see + the channel list). + Idee and implementation by LucentW, Thanks! Closes #197. + - INVITE command: Implement ERR_USERNOTONSERV(504) numeric and make sure + that the target user is on the same server when inviting other users + to local ("&") channels. + Idea by Cahata, thanks! Closes #183. + - MODE command: Always report channel creation time. Up to now when + receiving a MODE command, ngIRCd only reported the channel creation + time to clients that were members of the channel. This patch reports + the channel creation time to all clients, regardless if they are joined + to that channel or not. At least ircd-seven behaves like this. + This closes #188. Reported by Cahata, thanks! + ngIRCd 22.1 (2015-04-06) - Update "CipherList" to not enable SSLv3 by default. Idea, initial patch, diff --git a/doc/README b/doc/README index ef71c27..05644ec 100644 --- a/doc/README +++ b/doc/README @@ -74,7 +74,7 @@ releases there. If you are interested in the latest development versions (which are not always stable), then please read the section about "GIT" on the homepage and the file "doc/GIT.txt" which describes the use of GIT, the version control -system used by ngIRCd (homepage: http://git-scm.com/). +system used by ngIRCd (homepage: ). VI. Bugs @@ -83,11 +83,11 @@ VI. Bugs If you find bugs in the ngIRCd (which might be there :-), please report them at the following URL: - + There you can read about known bugs and limitations, too. -If you have critics, patches or something else, please feel free to post a -mail to the ngIRCd mailing list: (please see - for details) or join the ngIRCd -IRC channel: . +If you have comments, patches or something else, please feel free to post +a mail to the ngIRCd mailing list: (please see + for details) or join the ngIRCd IRC +channel: .