INN commit: trunk/doc/pod (10 files)

Wed Aug 1 20:15:03 UTC 2007

Date: Wednesday, August 1, 2007 @ 13:15:03
  Author: iulius
Revision: 7618

Fix errors and warnings returned by podchecker().

Modified:
  trunk/doc/pod/buffindexed.conf.pod
  trunk/doc/pod/checklist.pod
  trunk/doc/pod/ckpasswd.pod
  trunk/doc/pod/grephistory.pod
  trunk/doc/pod/hook-python.pod
  trunk/doc/pod/inn.conf.pod
  trunk/doc/pod/install.pod
  trunk/doc/pod/libinnhist.pod
  trunk/doc/pod/news.pod
  trunk/doc/pod/rc.news.pod

----------------------+
 buffindexed.conf.pod |    2 ++
 checklist.pod        |    2 +-
 ckpasswd.pod         |    4 ++--
 grephistory.pod      |    2 ++
 hook-python.pod      |    2 +-
 inn.conf.pod         |    2 +-
 install.pod          |    6 +++---
 libinnhist.pod       |    2 ++
 news.pod             |   10 +++++-----
 rc.news.pod          |    2 +-
 10 files changed, 20 insertions(+), 14 deletions(-)

Modified: buffindexed.conf.pod
===================================================================

--- buffindexed.conf.pod	2007-08-01 17:50:01 UTC (rev 7617)
+++ buffindexed.conf.pod	2007-08-01 20:15:03 UTC (rev 7618)
@@ -131,6 +131,8 @@
 both).  Also make sure that the permissions on the devices allow the news
 user to read and write.
 
+=back
+
 =head1 HISTORY
 
 Written by Katsuhiro Kondou <kondou at nec.co.jp> for InterNetNews.

Modified: checklist.pod
===================================================================
--- checklist.pod	2007-08-01 17:50:01 UTC (rev 7617)
+++ checklist.pod	2007-08-01 20:15:03 UTC (rev 7618)
@@ -263,7 +263,7 @@
         read: "local.*"
         post: "!*"
     }
-    
+
 You don't need to reload anything after modifying F<readers.conf>; every
 time an nnrpd launches it reads its configuration from disk.
 

Modified: ckpasswd.pod
===================================================================
--- ckpasswd.pod	2007-08-01 17:50:01 UTC (rev 7617)
+++ ckpasswd.pod	2007-08-01 20:15:03 UTC (rev 7618)
@@ -10,7 +10,7 @@
 =head1 DESCRIPTION
 
 B<ckpasswd> is the basic password authenticator for nnrpd, suitable for
-being run from an auth stanza in I<readers.conf>.  See readers.conf(5) for
+being run from an auth stanza in F<readers.conf>.  See readers.conf(5) for
 more information on how to configure an nnrpd authenticator.
 
 B<ckpasswd> accepts a username and password from nnrpd and tells nnrpd(8)
@@ -121,7 +121,7 @@
 that you should be able to check by hand for security.
 
 This configuration is not recommended if it can be avoided, for serious
-security reasons.  See L<readers.confZ<>(5)/SECURITY CONSIDERATIONS> for
+security reasons.  See "SECURITY CONSIDERATIONS" in readers.conf(5) for
 discussion.
 
 =item B<-u> I<username>

Modified: grephistory.pod
===================================================================
--- grephistory.pod	2007-08-01 17:50:01 UTC (rev 7617)
+++ grephistory.pod	2007-08-01 20:15:03 UTC (rev 7618)
@@ -71,6 +71,8 @@
 Print out the hash of the message ID for diagnostic purposes, as well as
 any other requested information.  This flag is not useful with B<-s>.
 
+=back
+
 =head1 HISTORY
 
 Written by Rich $alz <rsalz at uunet.uu.net> for InterNetNews.  Rewritten in

Modified: hook-python.pod
===================================================================
--- hook-python.pod	2007-08-01 17:50:01 UTC (rev 7617)
+++ hook-python.pod	2007-08-01 20:15:03 UTC (rev 7618)
@@ -71,7 +71,7 @@
 art is a dictionary containing an article's headers and body.  This method
 is called every time innd receives an article.  The following can be
 defined:
-            
+
     Approved, Control, Date, Distribution, Expires, From, Lines,
     Message-ID, Newsgroups, Path, Reply-To, Sender, Subject,
     Supersedes, Bytes, Also-Control, References, Xref, Keywords,

Modified: inn.conf.pod
===================================================================
--- inn.conf.pod	2007-08-01 17:50:01 UTC (rev 7617)
+++ inn.conf.pod	2007-08-01 20:15:03 UTC (rev 7618)
@@ -66,7 +66,7 @@
 in it, then it is assumed to have the full domain name.  As this parameter
 is rarely used, do not use it to affect the righthand side of
 autogenerated Message-IDs; see instead I<virtualhost> and I<domain> in
-L<readers.conf>.  The default value is unset.
+readers.conf(5).  The default value is unset.
 
 =item I<innflags>
 

Modified: install.pod
===================================================================
--- install.pod	2007-08-01 17:50:01 UTC (rev 7617)
+++ install.pod	2007-08-01 20:15:03 UTC (rev 7618)
@@ -923,7 +923,7 @@
         :Tc,Wnsm:/usr/local/news/bin/controlchan
 
 (modified for the actual path to F<controlchan> if you put it somewhere
-else).  See L<Processing Control Messages> for more details.
+else).  See L<Processing Newsgroup Control Messages> for more details.
 
 For those of you upgrading from earlier versions of INN, note that the
 functionality of overchan(8) and F<crosspost> is now incorporated into INN
@@ -1030,7 +1030,7 @@
 you should put them in their own metacycbuff as well, so that they don't
 get pushed out by other traffic.  (Or you might store them in one of the
 other storage methods, such as tradspool.)
-   
+
 For each metacycbuff, you now need to determine how many cycbuffs will
 make up the metacycbuff, the size of those cycbuffs, and where they will
 be stored.  Some OSes do not support files larger than 2 GB, which will
@@ -1089,7 +1089,7 @@
 more details.
 
 Finally, you have to create the cycbuffs.  See L<Creating the Article
-Spool> for more information on how to do that.
+Spool (CNFS only)> for more information on how to do that.
 
 =head2 storage.conf
 

Modified: libinnhist.pod
===================================================================
--- libinnhist.pod	2007-08-01 17:50:01 UTC (rev 7617)
+++ libinnhist.pod	2007-08-01 20:15:03 UTC (rev 7618)
@@ -293,6 +293,8 @@
 nnrpd(8) like applications. I<val> should be a pointer to a value of
 type B<time_t> and will not be modified by the call.
 
+=back
+
 =head1 HISTORY
 
 Written by Alex Kiernan <alexk at demon.net> for InterNetNews 2.4.0.

Modified: news.pod
===================================================================
--- news.pod	2007-08-01 17:50:01 UTC (rev 7617)
+++ news.pod	2007-08-01 20:15:03 UTC (rev 7618)
@@ -312,13 +312,13 @@
 with a cleaner interface to the underlying BerkeleyDB database.
 
 If you use Perl authentication for nnrpd (if I<nnrpdperlauth> in
-F<inn.conf> is true), there have been major changes.  See L<"Changes to
-Perl Authentication Support for nnrpd"> in F<doc/hook-perl> for details.
+F<inn.conf> is true), there have been major changes.  See "Changes to
+Perl Authentication Support for nnrpd" in F<doc/hook-perl> for details.
 
 Similarly, if you use Python authentication for nnrpd (if
 I<nnrpdpythonauth> in F<inn.conf> is true), there have been major changes.
-See L<"Changes to Python Authentication and Access Control Support for
-nnrpd"> in F<doc/hook-python> for details.
+See "Changes to Python Authentication and Access Control Support for
+nnrpd" in F<doc/hook-python> for details.
 
 If you use B<send-uucp>, it has been completely rewritten and now takes a
 configuration file to specify its behavior.  See its man page for more
@@ -458,7 +458,7 @@
 Local connections to INN support a new special mode, MODE CANCEL, that
 allows efficient batch cancellation of messages.  This is intended to be
 the preferred interface for external spam and abuse filters like NoCeM.
-See L<CANCEL FEEDS> in innd(8) for details.
+See "CANCEL FEEDS" in innd(8) for details.
 
 =item *
 

Modified: rc.news.pod
===================================================================
--- rc.news.pod	2007-08-01 17:50:01 UTC (rev 7617)
+++ rc.news.pod	2007-08-01 20:15:03 UTC (rev 7618)
@@ -68,7 +68,7 @@
 To run INN at startup time from appropriate system boot scripts:
 
        su - news -c ~news/bin/rc.news >/dev/console
-  
+
 To stop INN (throttling first):
 
        ~news/bin/ctlinnd throttle reason

