INN commit: branches/2.5 (doc/pod/pullnews.pod frontends/pullnews.in)

[INN Commit]

    Date: Sunday, January 23, 2011 @ 02:22:50
  Author: iulius
Revision: 9161

Missing commit, related to revision 9136.  I forgot to commit the
new documentation:

* Add authentication to the downstream server.

* Improve documentation (especially the example for the "-m" flag that
should be quoted for the shell).

Modified:
  branches/2.5/doc/pod/pullnews.pod
  branches/2.5/frontends/pullnews.in

-----------------------+
 doc/pod/pullnews.pod  |   14 ++++++++------
 frontends/pullnews.in |    2 +-
 2 files changed, 9 insertions(+), 7 deletions(-)

Modified: doc/pod/pullnews.pod
===================================================================
--- doc/pod/pullnews.pod	2011-01-23 10:22:06 UTC (rev 9160)
+++ doc/pod/pullnews.pod	2011-01-23 10:22:50 UTC (rev 9161)
@@ -109,7 +109,7 @@
 whitespace-separated tuples (each tuple being a colon-separated header and
 regular expression).  For instance:
 
-    Hdr1:regexp1 !Hdr2:regexp2
+    -m "Hdr1:regexp1 !Hdr2:regexp2"
 
 specifies that the article will be passed only if the C<Hdr1:> header
 matches C<regexp1> and the C<Hdr2:> header does not match C<regexp2>.
@@ -215,11 +215,13 @@
 
 =head1 CONFIG FILE
 
-The config file for B<pullnews> is divided into blocks, one block for each
-remote server to connect to.  A block begins with the host line, which
-must have no leading whitespace and contains just the hostname of the
-remote server, optionally followed by authentication details (username
-and password for that server).
+The config file for B<pullnews> is divided into blocks, one block for
+each remote server to connect to.  A block begins with the host line
+(which must have no leading whitespace) and contains just the hostname of
+the remote server, optionally followed by authentication details (username
+and password for that server).  Note that authentication details can also
+be provided for the downstream server (a host line could be added for it
+in the configuration file, with no newsgroup to fetch).
 
 Following the host line should be one or more newsgroup lines which start
 with whitespace followed by the name of a newsgroup to retrieve.  Only one

Modified: frontends/pullnews.in
===================================================================
--- frontends/pullnews.in	2011-01-23 10:22:06 UTC (rev 9160)
+++ frontends/pullnews.in	2011-01-23 10:22:50 UTC (rev 9161)
@@ -346,7 +346,7 @@
     print LOG "        ``+'' is an article the downstream server accepted\n";
     print LOG "        ``x'' is an article the upstream server couldn't ";
     print LOG "give out\n";
-    print LOG "        ``m'' is an article skipped due to headers (-m)\n";
+    print LOG "        ``m'' is an article skipped due to headers (-m or -P)\n";
     print LOG "\n";
     print LOG "Writing to rnews-format output: $rnews\n\n" if $rnews;
 }