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