INN commit: trunk (10 files)

INN Commit Russ_Allbery at isc.org
Mon Apr 28 12:44:07 UTC 2008


    Date: Monday, April 28, 2008 @ 05:44:07
  Author: iulius
Revision: 7808

Add POD documentation for distributions(5) and a corresponding
sample file.

Added:
  trunk/doc/pod/distributions.pod
  trunk/samples/distributions
Modified:
  trunk/MANIFEST
  trunk/TODO
  trunk/doc/man/	(properties)
  trunk/doc/man/Makefile
  trunk/doc/pod/Makefile
  trunk/site/	(properties)
  trunk/site/Makefile
  trunk/support/mkmanifest

---------------------------+
 MANIFEST                  |    7 ++++--
 TODO                      |    2 -
 doc/man/Makefile          |    2 -
 doc/pod/Makefile          |    3 +-
 doc/pod/distributions.pod |   49 ++++++++++++++++++++++++++++++++++++++++++++
 samples/distributions     |   14 ++++++++++++
 site/Makefile             |    5 +++-
 support/mkmanifest        |    1 
 8 files changed, 76 insertions(+), 7 deletions(-)

Modified: MANIFEST
===================================================================
--- MANIFEST	2008-04-28 12:41:40 UTC (rev 7807)
+++ MANIFEST	2008-04-28 12:44:07 UTC (rev 7808)
@@ -161,6 +161,7 @@
 doc/man/cycbuff.conf.5                Manpage for cycbuff.conf config file
 doc/man/dbz.3                         Manpage for DBZ database interface
 doc/man/distrib.pats.5                Manpage for distrib.pats config file
+doc/man/distributions.5               Manpage for distributions config file
 doc/man/docheckgroups.8               Manpage for docheckgroups
 doc/man/domain.8                      Manpage for domain resolver
 doc/man/expire.8                      Manpage for expire
@@ -266,6 +267,7 @@
 doc/pod/ctlinnd.pod                   Master file for ctlinnd.8
 doc/pod/cycbuff.conf.pod              Master file for cycbuff.conf.5
 doc/pod/distrib.pats.pod              Master file for distrib.pats.5
+doc/pod/distributions.pod             Master file for distributions.5
 doc/pod/docheckgroups.pod             Master file for docheckgroups.8
 doc/pod/domain.pod                    Master file for domain.8
 doc/pod/expire.ctl.pod                Master file for expire.ctl.5
@@ -484,7 +486,7 @@
 lib/daemonize.c                       Code necessary to become a daemon
 lib/date.c                            Date parsing and conversion routines
 lib/dbz.c                             DBZ database library
-lib/defdist.c                         Determine default Distribution header
+lib/defdist.c                         Determine default Distribution: header
 lib/dispatch.c                        Dispatch a command to a function
 lib/fdflags.c                         Set or clear file descriptor flags
 lib/fdlimit.c                         File descriptor limits
@@ -617,7 +619,8 @@
 samples/buffindexed.conf.in           Buffindexed overview config file
 samples/control.ctl                   Access control for control messages
 samples/cycbuff.conf                  Sample cycbuff.conf file
-samples/distrib.pats                  Default values for Distribution header
+samples/distrib.pats                  Default values for Distribution: header
+samples/distributions                 Recommended values for Distribution: header
 samples/expire.ctl                    Expiration config file
 samples/filter_innd.pl                Sample Perl filter for innd
 samples/filter_innd.py                Sample Python filter for innd

Modified: TODO
===================================================================
--- TODO	2008-04-28 12:41:40 UTC (rev 7807)
+++ TODO	2008-04-28 12:44:07 UTC (rev 7808)
@@ -212,8 +212,6 @@
 * Audit readers.conf.5 against perm.c for missing options ("include" at
   least is missing from the documentation).
 
-* The distributions file is undocumented.
-
 * More comprehensive documentation in texinfo would be interesting; it
   would allow for better organization, separation of specialized topics
   into cleaner chapters, and a significantly better printed manual.  This


Property changes on: trunk/doc/man
___________________________________________________________________
Name: svn:ignore
   - active.5
active.times.5
actsync.8
archive.8
auth_krb5.8
auth_smb.8
batcher.8
buffchan.8
buffindexed.conf.5
ckpasswd.8
control.ctl.5
convdate.1
ctlinnd.8
cycbuff.conf.5
distrib.pats.5
docheckgroups.8
domain.8
expire.ctl.5
expireover.8
fastrm.1
getlist.1
grephistory.1
ident.8
inews.1
inn.conf.5
innbind.8
innconfval.1
innd.8
inndf.8
innmail.1
innupgrade.8
libauth.3
libinnhist.3
list.3
mailpost.8
makehistory.8
moderators.5
motd.news.5
newsfeeds.5
newslog.5
newsgroups.5
ninpaths.8
nnrpd.8
ovdb.5
ovdb_init.8
ovdb_monitor.8
ovdb_server.8
ovdb_stat.8
overchan.8
passwd.nntp.5
perl-nocem.8
pgpverify.1
pullnews.1
qio.3
radius.8
radius.conf.5
rc.news.8
readers.conf.5
rnews.1
sasl.conf.5
scanlogs.8
send-uucp.8
sendinpaths.8
simpleftp.1
sm.1
storage.conf.5
subscriptions.5
tally.control.8
tdx-util.8
tinyleaf.8
tst.3
uwildmat.3

   + active.5
active.times.5
actsync.8
archive.8
auth_krb5.8
auth_smb.8
batcher.8
buffchan.8
buffindexed.conf.5
ckpasswd.8
control.ctl.5
convdate.1
ctlinnd.8
cycbuff.conf.5
distrib.pats.5
distributions.5
docheckgroups.8
domain.8
expire.ctl.5
expireover.8
fastrm.1
getlist.1
grephistory.1
ident.8
inews.1
inn.conf.5
innbind.8
innconfval.1
innd.8
inndf.8
innmail.1
innupgrade.8
libauth.3
libinnhist.3
list.3
mailpost.8
makehistory.8
moderators.5
motd.news.5
newsfeeds.5
newslog.5
newsgroups.5
ninpaths.8
nnrpd.8
ovdb.5
ovdb_init.8
ovdb_monitor.8
ovdb_server.8
ovdb_stat.8
overchan.8
passwd.nntp.5
perl-nocem.8
pgpverify.1
pullnews.1
qio.3
radius.8
radius.conf.5
rc.news.8
readers.conf.5
rnews.1
sasl.conf.5
scanlogs.8
send-uucp.8
sendinpaths.8
simpleftp.1
sm.1
storage.conf.5
subscriptions.5
tally.control.8
tdx-util.8
tinyleaf.8
tst.3
uwildmat.3


Modified: doc/man/Makefile
===================================================================
--- doc/man/Makefile	2008-04-28 12:41:40 UTC (rev 7807)
+++ doc/man/Makefile	2008-04-28 12:44:07 UTC (rev 7808)
@@ -12,7 +12,7 @@
 	libstorage.3 list.3 qio.3 tst.3 uwildmat.3
 
 SEC5	= active.5 active.times.5 buffindexed.conf.5 control.ctl.5 \
-	cycbuff.conf.5 distrib.pats.5 expire.ctl.5 history.5 incoming.conf.5 \
+	cycbuff.conf.5 distrib.pats.5 distributions.5 expire.ctl.5 history.5 incoming.conf.5 \
 	inn.conf.5 innfeed.conf.5 innwatch.ctl.5 moderators.5 motd.news.5 \
 	newsfeeds.5 newsgroups.5 newslog.5 nnrpd.track.5 nntpsend.ctl.5 ovdb.5 \
 	overview.fmt.5 passwd.nntp.5 radius.conf.5 readers.conf.5 \

Modified: doc/pod/Makefile
===================================================================
--- doc/pod/Makefile	2008-04-28 12:41:40 UTC (rev 7807)
+++ doc/pod/Makefile	2008-04-28 12:44:07 UTC (rev 7808)
@@ -20,7 +20,7 @@
 
 MAN5	= ../man/active.5 ../man/active.times.5 ../man/buffindexed.conf.5 \
 	../man/control.ctl.5 ../man/cycbuff.conf.5 ../man/distrib.pats.5 \
-	../man/expire.ctl.5 ../man/inn.conf.5 ../man/moderators.5 \
+	../man/distributions.5 ../man/expire.ctl.5 ../man/inn.conf.5 ../man/moderators.5 \
 	../man/motd.news.5 ../man/newsfeeds.5 ../man/newsgroups.5 \
 	../man/newslog.5 ../man/ovdb.5 \
 	../man/passwd.nntp.5 ../man/radius.conf.5 ../man/readers.conf.5 \
@@ -82,6 +82,7 @@
 ../man/control.ctl.5:	control.ctl.pod		; $(POD2MAN) -s 5 $? > $@
 ../man/cycbuff.conf.5:	cycbuff.conf.pod	; $(POD2MAN) -s 5 $? > $@
 ../man/distrib.pats.5:	distrib.pats.pod	; $(POD2MAN) -s 5 $? > $@
+../man/distributions.5:	distributions.pod	; $(POD2MAN) -s 5 $? > $@
 ../man/expire.ctl.5:	expire.ctl.pod		; $(POD2MAN) -s 5 $? > $@
 ../man/inn.conf.5:	inn.conf.pod		; $(POD2MAN) -s 5 $? > $@
 ../man/moderators.5:	moderators.pod		; $(POD2MAN) -s 5 $? > $@

Added: doc/pod/distributions.pod
===================================================================
--- doc/pod/distributions.pod	                        (rev 0)
+++ doc/pod/distributions.pod	2008-04-28 12:44:07 UTC (rev 7808)
@@ -0,0 +1,49 @@
+=head1 NAME
+
+distributions - Recommended values for the Distribution: header
+
+=head1 DESCRIPTION
+
+The file I<pathetc>/distributions contains a list of relevant
+distributions and their descriptions.  It provides local information
+for posters who wish to add a Distribution: header to their articles
+so as to restrict their propagation, although it does not guarantee
+that such articles will not leak elsewhere because of a misconfiguration
+of a news server to which they are fed.  See newsfeeds(5) for more
+information about how a news server handles the Distribution: header.
+
+Each line of this file consists in a distribution area followed by
+its description after at least a whitespace.  For instance:
+
+    all     Everywhere:  it is a worldwide distribution.
+    fr      Local to France.
+    local   Local to this news server.
+    nj      Local to New Jersey.
+    usa     Local to the United States of America.
+    world   Everywhere:  it is a worldwide distribution.
+
+Blank lines and lines beginning with a number sign (C<#>) are ignored.
+
+Any client that issues the LIST DISTRIBUTIONS command obtain these
+recommended values, if available.  However, be aware that use of the
+LIST DISTRIBUTIONS command is not widespread and most news clients will
+never ask for this file.
+
+If this file is missing, it is not an error.  The server will just send
+the client an empty response.
+
+The Distribution: header can also be automatically set by B<nnrpd>
+if distrib.pats(5) is correctly configured.
+
+=head1 HISTORY
+
+Written by Julien Elie <julien at trigofacile.com> for InterNetNews.
+
+$Id$
+
+=head1 SEE ALSO
+
+distrib.pats(5), newsfeeds(5), nnrpd(8).
+
+=cut
+


Property changes on: trunk/doc/pod/distributions.pod
___________________________________________________________________
Name: svn:keywords
   + Author Date Id Revision
Name: svn:eol-style
   + native

Added: samples/distributions
===================================================================
--- samples/distributions	                        (rev 0)
+++ samples/distributions	2008-04-28 12:44:07 UTC (rev 7808)
@@ -0,0 +1,14 @@
+##  $Id$
+##
+##  Sample distributions configuration file.
+##
+##  It contains recommended values for the Distribution: header.
+##  See the distributions man page for more information.
+
+#all     Everywhere:  it is a worldwide distribution.
+#fr      Local to France.
+#local   Local to this news server.
+#nj      Local to New Jersey.
+#usa     Local to the United States of America.
+#world   Everywhere:  it is a worldwide distribution.
+


Property changes on: trunk/samples/distributions
___________________________________________________________________
Name: svn:keywords
   + Author Date Id Revision
Name: svn:eol-style
   + native


Property changes on: trunk/site
___________________________________________________________________
Name: svn:ignore
   - INN.py
active.minimal
actsync.cfg
actsync.ign
buffindexed.conf
config
control.ctl
cycbuff.conf
distrib.pats
expire.ctl
filter.tcl
filter_innd.pl
filter_innd.py
filter_nnrpd.pl
incoming.conf
inn.conf
innfeed.conf
innreport.conf
innwatch.ctl
localgroups
moderators
motd.news
news2mail.cf
newsfeeds
newsgroups.minimal
nnrpd.track
nnrpd_access.pl
nnrpd_auth.pl
nnrpd_auth.py
nntpsend.ctl
nocem.ctl
ovdb.conf
overview.fmt
passwd.nntp
radius.conf
readers.conf
sasl.conf
send-uucp.cf
startup.tcl
startup_innd.pl
storage.conf
subscriptions
update

   + INN.py
active.minimal
actsync.cfg
actsync.ign
buffindexed.conf
config
control.ctl
cycbuff.conf
distrib.pats
distributions
expire.ctl
filter.tcl
filter_innd.pl
filter_innd.py
filter_nnrpd.pl
incoming.conf
inn.conf
innfeed.conf
innreport.conf
innwatch.ctl
localgroups
moderators
motd.news
news2mail.cf
newsfeeds
newsgroups.minimal
nnrpd.track
nnrpd_access.pl
nnrpd_auth.pl
nnrpd_auth.py
nntpsend.ctl
nocem.ctl
ovdb.conf
overview.fmt
passwd.nntp
radius.conf
readers.conf
sasl.conf
send-uucp.cf
startup.tcl
startup_innd.pl
storage.conf
subscriptions
update


Modified: site/Makefile
===================================================================
--- site/Makefile	2008-04-28 12:41:40 UTC (rev 7807)
+++ site/Makefile	2008-04-28 12:44:07 UTC (rev 7808)
@@ -28,6 +28,7 @@
 PATH_INNDHOSTS		= ${PATHETC}/incoming.conf
 PATH_MODERATORS		= ${PATHETC}/moderators
 PATH_DISTPATS		= ${PATHETC}/distrib.pats
+PATH_DISTRIBUTIONS	= ${PATHETC}/distributions
 PATH_NEWSFEEDS		= ${PATHETC}/newsfeeds
 PATH_READERSCONF	= ${PATHETC}/readers.conf
 PATH_NNRPDTRACK		= ${PATHETC}/nnrpd.track
@@ -56,7 +57,7 @@
 	newsfeeds incoming.conf nnrpd.track passwd.nntp \
 	inn.conf moderators innreport.conf localgroups \
 	control.ctl expire.ctl nntpsend.ctl overview.fmt \
-	innwatch.ctl distrib.pats actsync.cfg actsync.ign \
+	innwatch.ctl distrib.pats distributions actsync.cfg actsync.ign \
 	motd.news storage.conf cycbuff.conf buffindexed.conf \
 	innfeed.conf startup_innd.pl filter_innd.pl filter_nnrpd.pl \
 	filter_innd.py INN.py \
@@ -179,6 +180,7 @@
 $D$(PATH_CONFIG):	inn.conf	; $(COPY_RPUB) $? $@
 $D$(PATH_MODERATORS):	moderators	; $(COPY_RPUB) $? $@
 $D$(PATH_DISTPATS):	distrib.pats	; $(COPY_RPUB) $? $@
+$D$(PATH_DISTRIBUTIONS): distributions  ; $(COPY_RPUB) $? $@
 $D$(PATH_NNTPPASS):	passwd.nntp	; $(COPY_RPRI) $? $@
 $D$(PATHETC)/nntpsend.ctl: nntpsend.ctl	; $(COPY_RPUB) $? $@
 $D$(PATHETC)/news2mail.cf: news2mail.cf	; $(COPY_RPUB) $? $@
@@ -240,6 +242,7 @@
 innfeed.conf:	../samples/innfeed.conf		; $(COPY) $? $@
 moderators:	../samples/moderators		; $(COPY) $? $@
 distrib.pats:	../samples/distrib.pats		; $(COPY) $? $@
+distributions:	../samples/distributions	; $(COPY) $? $@
 motd.news:	../samples/motd.news		; $(COPY) $? $@
 news2mail.cf:	../samples/news2mail.cf		; $(COPY) $? $@
 newsfeeds:	../samples/newsfeeds		; $(COPY) $? $@

Modified: support/mkmanifest
===================================================================
--- support/mkmanifest	2008-04-28 12:41:40 UTC (rev 7807)
+++ support/mkmanifest	2008-04-28 12:44:07 UTC (rev 7808)
@@ -212,6 +212,7 @@
 site/control.ctl
 site/cycbuff.conf
 site/distrib.pats
+site/distributions
 site/expire.ctl
 site/filter.tcl
 site/filter_innd.pl



More information about the inn-committers mailing list