INN commit: trunk/doc/pod (news.pod)

[INN Commit]

    Date: Thursday, February 26, 2009 @ 14:18:58
  Author: iulius
Revision: 8355

Better changelog for INN 2.5.0 (release candidate).
Separate more clearly changes with upgrade significance (in the
upgrading section) and the regular summary of changes section.

Modified:
  trunk/doc/pod/news.pod

----------+
 news.pod |  107 +++++++++++++++++++++++++++++++++++++------------------------
 1 file changed, 66 insertions(+), 41 deletions(-)

Modified: news.pod
===================================================================
--- news.pod	2009-02-26 20:45:06 UTC (rev 8354)
+++ news.pod	2009-02-26 22:18:58 UTC (rev 8355)
@@ -11,32 +11,28 @@
 
 =item *
 
-In order to process control messages, owing to the new application/news-groupinfo
-entity described in USEPRO, B<controlchan> needs the C<MIME::Parser> module.
-It is available from CPAN (C<MIME-tools> in F<modules/by-module/MIME/>,
-for instance on ftp.perl.org).  You can also use the one provided with your
-distribution, has it already been packaged for it.  A version of Perl superior
-to 5.8.0 is recommended with INN.
+In order to process control messages, B<controlchan> now needs the
+C<MIME::Parser> module.  It is available from CPAN (C<MIME-tools> in
+F<modules/by-module/MIME/>, for instance on ftp.perl.org).  You can also use
+the one provided with your distribution, has it already been packaged for it.
 
+A version of Perl superior to 5.8.0 is recommended with INN.  In case you
+are not using such a version, you will also need the C<Encode> module so as
+to process control messages (it was not part of Perl before its 5.8.0 version).
+
 =item *
 
-A new F<control.ctl.local> file has been added in I<pathetc>.  It is used
-by B<controlchan> and allows to specify local rules against control messages
-without having to modify F<control.ctl>.  It also contains the encodings
-to use for the F<newsgroups> file (by default, UTF-8 will be used for
-the descriptions of the newsgroups).
+You should use the new F<control.ctl.local> file shipped with INN in
+I<pathetc> and, at the same time, update your F<control.ctl> and F<moderators>
+files.  Also make sure that your F<active.times>, F<distrib.pats> and
+F<newsgroups> files are properly encoded in UTF-8, as it is strongly
+recommended by S<RFC 3977>.
 
-You should use that new file and, at the same time, update your F<control.ctl>
-and F<moderators> files.
-
 =item *
 
 The B<innreport> configuration file has slightly changed.  The new
 F<innreport.conf> file shipped with INN should be used and your possible
-changes backported to this new version.  Alexander Bartolich has greatly
-improved B<innreport> and especially its XHTML output (a XSL transformation
-is also provided, if needed, in F<innreport-filter.xslt>, in the F<contrib>
-directory).
+changes backported to this new version.
 
 =item *
 
@@ -47,13 +43,6 @@
 
 =back
 
-The legacy B<innshellvars.pl> script has been replaced with a real INN Perl
-module C<INN::Config> for Perl programs.  The location of Perl modules can
-be set with the B<--with-libperl-dir> option to C<configure>.  All Perl
-scripts shipped with INN have been converted to use that module.  You may
-want to consider using C<INN::Config> in your Perl scripts, though
-B<innshellvars.pl> is still provided with INN.
-
 The parameters used by B<nnrpd> to provide TLS support are now I<tlscafile>,
 I<tlscapath>, I<tlscertfile> and I<tlskeyfile> in F<inn.conf>.  The F<sasl.conf>
 file used for that in previous versions of INN is obsolete.  B<innupgrade>
@@ -62,25 +51,14 @@
 The I<nntpactsync> parameter has been renamed to I<incominglogfrequency>
 in F<inn.conf>; B<innupgrade> handles this renaming during the update.
 
-B<inndstart> and B<startinnfeed> are no longer part of INN and are no
-longer used.  Instead, a separate setuid root helper program written by
-Russ Allbery is used to bind to the news ports (and does only that),
-and is run by B<innd> and B<nnrpd> when necessary.  This means that INN
-may not be able to increase file descriptor limits for itself the way
-that it could before.  If you get error messages about resetting the file
-descriptor limits, you may need to increase the file descriptor limits
-as root before running B<rc.news> as the news user.  See the sample init
-script in F<contrib> for an example of how to do this.  More information
-on file descriptor limits can be found in F<INSTALL>.
-
 In F<newsfeeds>, B<innfeed> should be run directly rather than through
 B<startinnfeed>.  B<innupgrade> will attempt to take care of this
-modification during C<make update>.  When starting B<innd> by hand, B<innd>
-can just be run directly rather than using B<inndstart>.
+modification during C<make update>.
 
-Support for S<Berkeley DB> versions prior to 4.3 has been dropped.
-You will have to use at least S<Berkeley DB 4.4>; the recommended version
-is 4.7.
+When starting B<innd> by hand, B<innd> can just be run directly rather
+than using B<inndstart>.  If you get error messages about resetting the file
+descriptor limits, you may need to increase the file descriptor limits.
+See the sample init script in F<contrib> for an example of how to do this.
 
 If you are upgrading from a version prior to S<INN 2.4>, see also
 L<Upgrading from 2.3 to 2.4>.
@@ -115,6 +93,25 @@
 
 =item *
 
+Alexander Bartolich has greatly improved B<innreport> and especially
+its XHTML output (a XSL transformation is also provided, if needed,
+in F<innreport-filter.xslt>, in the F<contrib> directory).
+
+=item *
+
+B<inndstart> and B<startinnfeed> are no longer part of INN and are no
+longer used.  Instead, a separate setuid root helper program written by
+Russ Allbery is used to bind to the news ports (and does only that),
+and is run by B<innd> and B<nnrpd> when necessary.  This means that INN
+may not be able to increase file descriptor limits for itself the way
+that it could before.  If you get error messages about resetting the file
+descriptor limits, you may need to increase the file descriptor limits
+as root before running B<rc.news> as the news user.  See the sample init
+script in F<contrib> for an example of how to do this.  More information
+on file descriptor limits can be found in F<INSTALL>.
+
+=item *
+
 INN now uses S<autoconf 2.59> or later for configuration.  As a result, some
 C<configure> options have changed slightly and more of the standard B<--*dir>
 options should be supported in lieu of the old INN-specific options.  See
@@ -134,6 +131,19 @@
 
 =item *
 
+B<controlchan> recognizes the new application/news-groupinfo entity described
+in USEPRO.  The C<MIME::Parser> and C<Encode> modules are used.  Processing
+control messages has been greatly improved, especially checkgroups:  the
+F<active> and F<newsgroups> files are now properly updated by them.
+
+A new F<control.ctl.local> file has also been added in I<pathetc>.  It is
+used by B<controlchan> and allows to specify local rules against control messages
+without having to modify F<control.ctl>.  It contains the encodings to use
+for the F<newsgroups> file (by default, UTF-8 will be used for the descriptions
+of the newsgroups, as strongly recommended by S<RFC 3977>).
+
+=item *
+
 The Perl and Python I<filter_mode> hooks are now called when B<innd> is shutting
 down via either C<ctlinnd shutdown> or C<ctlinnd xexec> with a new mode
 value of C<shutdown>.  This will allow the Perl hooks to save filter data
@@ -143,6 +153,15 @@
 
 =item *
 
+The legacy B<innshellvars.pl> script has been replaced with a real INN Perl
+module C<INN::Config> for Perl programs.  The location of Perl modules can
+be set with the B<--with-libperl-dir> option to C<configure>.  All Perl
+scripts shipped with INN have been converted to use that module.  You may
+want to consider using C<INN::Config> in your Perl scripts, though
+B<innshellvars.pl> is still provided with INN.
+
+=item *
+
 Support for embedded Tcl filters in B<innd> has been removed.  It hasn't
 worked for some time and causes B<innd> crashes if compiled in (even if not
 used).  If someone wants to step forward and maintain it, we recommend
@@ -186,6 +205,12 @@
 
 =item *
 
+Support for S<Berkeley DB> versions prior to 4.3 has been dropped.
+You will have to use at least S<Berkeley DB 4.4>; the recommended version
+is 4.7.
+
+=item *
+
 A lot of work has been done on documentation:  improvements of existing one,
 writing new one and proof-reading.  Samples are also more detailed.