INN commit: trunk/doc/pod (innd.pod newsfeeds.pod)

INN Commit rra at isc.org
Mon Sep 18 19:47:53 UTC 2017


    Date: Monday, September 18, 2017 @ 12:47:53
  Author: iulius
Revision: 10174

Clarify the wording about the propagation of control articles

Modified:
  trunk/doc/pod/innd.pod
  trunk/doc/pod/newsfeeds.pod

---------------+
 innd.pod      |    4 +++-
 newsfeeds.pod |   15 ++++++++-------
 2 files changed, 11 insertions(+), 8 deletions(-)

Modified: innd.pod
===================================================================
--- innd.pod	2017-09-18 19:05:32 UTC (rev 10173)
+++ innd.pod	2017-09-18 19:47:53 UTC (rev 10174)
@@ -287,7 +287,9 @@
     news.*,!control,!control.*
     control,control.*
 
-but the sites with the following subscription patterns will not receive it:
+As a matter of fact, for the first pattern, C<control.newgroup> (or
+C<control>) is included in C<*>.  However, the sites with the following
+subscription patterns will not receive it:
 
     *, at news.*,!control,!control.*
     comp.*, at news.*

Modified: newsfeeds.pod
===================================================================
--- newsfeeds.pod	2017-09-18 19:05:32 UTC (rev 10173)
+++ newsfeeds.pod	2017-09-18 19:47:53 UTC (rev 10174)
@@ -205,10 +205,11 @@
 example:
 
     $LOCALGROUPS=local.*,example.*
+    $CONTROLGROUPS=control,control.*
 
-This sets the variable C<LOCALGROUPS> to C<local.*,example.*>.  This
-variable can later be used elsewhere in the file, such as in a site entry
-like:
+This sets the variable C<LOCALGROUPS> to C<local.*,example.*> and the
+variable C<CONTROLGROUPS> to C<control,control.*>.  They can later be
+used elsewhere in the file, such as in a site entry like:
 
     news.example.com:$LOCALGROUPS:Tf,Wnm:
 
@@ -223,14 +224,14 @@
 variables to construct feed patterns.  The utility becomes more obvious
 when you observe that the line:
 
-    news.example.net:*,@$LOCALGROUPS:Tf,Wnm:
+    news.example.net:*,@$LOCALGROUPS,!$CONTROLGROUPS:Tf,Wnm:
 
 is therefore equivalent to:
 
-    news.example.net:*, at local.*, at example.*:Tf,Wnm:
+    news.example.net:*, at local.*, at example.*,!control,!control.*:Tf,Wnm:
 
-which (as explained below) excludes all of the groups in $LOCALGROUPS from
-the feed to that site.
+which (as explained below) excludes all of the groups in $LOCALGROUPS
+and unwanted control articles from the feed to that site.
 
 =head1 FLAG VALUES
 



More information about the inn-committers mailing list