INN commit: branches/2.5 (6 files)

INN Commit rra at isc.org
Mon Sep 28 19:59:48 UTC 2009


    Date: Monday, September 28, 2009 @ 12:59:48
  Author: iulius
Revision: 8638

Mention that active.times and distrib.pats should be encoded
in UTF-8, as well as ctlinnd and nnrpd arguments.

Modified:
  branches/2.5/doc/pod/active.times.pod
  branches/2.5/doc/pod/ctlinnd.pod
  branches/2.5/doc/pod/distrib.pats.pod
  branches/2.5/doc/pod/news.pod
  branches/2.5/doc/pod/nnrpd.pod
  branches/2.5/samples/distrib.pats

--------------------------+
 doc/pod/active.times.pod |   12 +++++++-----
 doc/pod/ctlinnd.pod      |   30 +++++++++++++++---------------
 doc/pod/distrib.pats.pod |    4 +++-
 doc/pod/news.pod         |    4 ++--
 doc/pod/nnrpd.pod        |    2 +-
 samples/distrib.pats     |    2 +-
 6 files changed, 29 insertions(+), 25 deletions(-)

Modified: doc/pod/active.times.pod
===================================================================
--- doc/pod/active.times.pod	2009-09-28 19:59:01 UTC (rev 8637)
+++ doc/pod/active.times.pod	2009-09-28 19:59:48 UTC (rev 8638)
@@ -16,10 +16,12 @@
 
 The first field is the name of the newsgroup.  The second field is the
 time it was created, expressed as the number of seconds since the epoch.
-The third field is the e-mail address of the person who created the group,
-as specified in the control message or on the B<ctlinnd> command line, or
-the newsmaster specified at configure time if no creator argument was
-given to B<ctlinnd> (by default, it is C<usenet>).
+The third field is plain text intended to describe the entity that created
+the newsgroup.  This field is encoded in UTF-8 and is usually the e-mail
+address of the person who created the group, as specified in the control
+message or on the B<ctlinnd> command line, or the newsmaster specified
+at configure time if no creator argument was given to B<ctlinnd> (by
+default, it is C<usenet>).
 
 You can get the F<active.times> file of another NNTP server with getlist(1).
 
@@ -27,7 +29,7 @@
 
 The line:
 
-   news.admin.moderation 1175716803 group-admin at isc.org
+   news.admin.moderation 1175716803 <group-admin at isc.org>
 
 shows that the newsgroup news.admin.moderation was created on April 4th, 2007,
 at 20:00:03 UTC.  This date can be obtained for instance with

Modified: doc/pod/ctlinnd.pod
===================================================================
--- doc/pod/ctlinnd.pod	2009-09-28 19:59:01 UTC (rev 8637)
+++ doc/pod/ctlinnd.pod	2009-09-28 19:59:48 UTC (rev 8638)
@@ -256,12 +256,12 @@
 identity of the person creating the group.  If the newsgroup already
 exists, this is equivalent to the C<changegroup> command.
 
-I<creator> may be omitted; if so, it will default to the newsmaster (as
-specified at configure time, normally C<usenet>).  I<mode> may also be
-omitted; if so, it will default to C<y> (a normal, unmoderated group).
-The combination of defaults make it possible to use the text of the
-Control: header directly (although don't do this without checking the
-syntactic validity of the header first).
+I<creator>, encoded in UTF-8 if given, may be omitted; if so, it will
+default to the newsmaster (as specified at configure time, normally
+C<usenet>).  I<mode> may also be omitted; if so, it will default to C<y>
+(a normal, unmoderated group).  The combination of defaults make it possible
+to use the text of the Control: header directly (although don't do this
+without checking the syntactic validity of the header first).
 
 This command can only be done while the server is running or throttled
 manually.  It will update its internal state when a C<go> command is
@@ -289,7 +289,7 @@
 be used for short-term locks, such as when replacing the history
 database.  If the server was not started with the B<-n y> flag, this
 command also does the equivalent of a C<readers> command with C<no> as the
-flag and I<reason> as the text.
+flag and I<reason> as the text, encoded in UTF-8.
 
 =item perl I<flag>
 
@@ -308,8 +308,8 @@
 Allow or disallow readers.  If I<flag> starts with the letter C<n>, then
 reading is disallowed by causing the server to pass I<text> as the value
 of the B<-r> flag to B<nnrpd>.  If I<flag> starts with the letter C<y> and
-I<text> is either an empty string or the same string that was used when
-reading was disabled, reading will be re-enabled.
+I<text> is either an empty string or the same string, encoded in UTF-8, that
+was used when reading was disabled, reading will be re-enabled.
 
 This command has no effect if B<nnrpd> is being run separately rather than
 spawned by B<innd>.
@@ -317,8 +317,8 @@
 =item reject I<reason>
 
 Remote connections (those that would not be handed off to B<nnrpd>) are
-rejected with I<reason> given as the explanation.  Existing connections
-are not closed.
+rejected with I<reason> given as the explanation, encoded in UTF-8.  Existing
+connections are not closed.
 
 =item reload I<what> I<reason>
 
@@ -373,9 +373,9 @@
 =item reserve I<reason>
 
 Require the next C<pause> or C<throttle> command to use I<reason> as its
-reason.  This reservation is cleared by giving an empty string for the
-reason.  This is used by programs like B<expire> to coordinate pauses and
-throttles of the server and avoid trampling on other instances of
+reason, encoded in UTF-8.  This reservation is cleared by giving an empty
+string for the reason.  This is used by programs like B<expire> to coordinate
+pauses and throttles of the server and avoid trampling on other instances of
 themselves.
 
 =item rmgroup I<group>
@@ -427,7 +427,7 @@
 
 If the server was not started with the B<-n y> flag, then this
 command also does the equivalent of a C<readers> command with C<no> as the
-flag and I<reason> as the text.
+flag and I<reason> as the text, encoded in UTF-8.
 
 =item timer (off | I<interval>)
 

Modified: doc/pod/distrib.pats.pod
===================================================================
--- doc/pod/distrib.pats.pod	2009-09-28 19:59:01 UTC (rev 8637)
+++ doc/pod/distrib.pats.pod	2009-09-28 19:59:48 UTC (rev 8638)
@@ -23,7 +23,9 @@
 The third field is the value that should be used for the Distribution:
 header of a posted article, if this line was picked as the best match and
 no Distribution: header was supplied by the user.  It can be an empty
-string, specifying that no Distribution: header should be added.
+string, specifying that no Distribution: header should be added.  If it
+is not empty, it is better to only use US-ASCII characters for that field;
+otherwise, make sure it is encoded in UTF-8.
 
 When a post is received by B<nnrpd> that does not already contain a
 Distribution: header, each newsgroup to which an article is posted will be

Modified: doc/pod/news.pod
===================================================================
--- doc/pod/news.pod	2009-09-28 19:59:01 UTC (rev 8637)
+++ doc/pod/news.pod	2009-09-28 19:59:48 UTC (rev 8638)
@@ -131,8 +131,8 @@
 =item *
 
 As UTF-8 is the default character set in S<RFC 3977>, C<ctlinnd pause>,
-C<ctlinnd readers>, C<ctlinnd reject>, C<ctlinnd throttle> and
-C<nnrpd -r> commands now require the given reason to be encoded in UTF-8,
+C<ctlinnd readers>, C<ctlinnd reject>, C<ctlinnd reserve>, C<ctlinnd throttle>
+and C<nnrpd -r> commands now require the given reason to be encoded in UTF-8,
 so that it can be properly sent to news readers.
 
 =item *

Modified: doc/pod/nnrpd.pod
===================================================================
--- doc/pod/nnrpd.pod	2009-09-28 19:59:01 UTC (rev 8637)
+++ doc/pod/nnrpd.pod	2009-09-28 19:59:48 UTC (rev 8638)
@@ -141,7 +141,7 @@
 
 If the B<-r> flag is used, then B<nnrpd> will reject the incoming
 connection giving I<reason> as the text.  This flag is used by innd(8)
-when it is paused or throttled.
+when it is paused or throttled.  I<reason> should be encoded in UTF-8.
 
 =item B<-s> I<padding>
 

Modified: samples/distrib.pats
===================================================================
--- samples/distrib.pats	2009-09-28 19:59:01 UTC (rev 8637)
+++ samples/distrib.pats	2009-09-28 19:59:48 UTC (rev 8638)
@@ -11,7 +11,7 @@
 ##  the one with the highest weight.
 ##      <weight>        The weight assigned to this match, integer.
 ##      <pattern>       Newsgroup name or single wildmat(3) pattern.
-##      <value>         Value of Distribution: header.
+##      <value>         Value of Distribution: header, encoded in UTF-8.
 ##
 ##  See the distrib.pats man page for more information.
 




More information about the inn-committers mailing list