INN commit: trunk/doc/pod (3 files)
INN Commit
Russ_Allbery at isc.org
Fri Aug 10 17:48:06 UTC 2007
Date: Friday, August 10, 2007 @ 10:48:06
Author: iulius
Revision: 7643
Typos.
Modified:
trunk/doc/pod/buffchan.pod
trunk/doc/pod/buffindexed.conf.pod
trunk/doc/pod/storage.conf.pod
----------------------+
buffchan.pod | 11 ++++++-----
buffindexed.conf.pod | 5 +++--
storage.conf.pod | 18 +++++++++---------
3 files changed, 18 insertions(+), 16 deletions(-)
Modified: buffchan.pod
===================================================================
--- buffchan.pod 2007-08-10 11:25:05 UTC (rev 7642)
+++ buffchan.pod 2007-08-10 17:48:06 UTC (rev 7643)
@@ -26,8 +26,9 @@
options.
As an exploder feed (see newsfeeds(5) for an explanation), B<buffchan>
-interprets lines beginning with an exclamation point as commands. There
-are three supported commands:
+interprets lines beginning with an exclamation point as commands. Besides
+C<!begin> (which only marks the start of the feed), there are three
+supported commands:
=over 4
@@ -91,7 +92,7 @@
This flag may be used to specify a directory the program should change to
before starting. If this flag is used, the default for the B<-s> flag
-(see below) is changed to be a simple "%s" (in other words, output files
+(see below) is changed to be a simple C<%s> (in other words, output files
are considered to be relative to I<directory>).
=item B<-f> I<num-fields>
@@ -144,9 +145,9 @@
The B<-s> flag may be used to specify a format that maps a filename from
the filename fields at the end of each line to an actual filename. This
is a sprintf(3) format string that should contain a single instance of
-"%s", which will be replaced with the value of the filename field
+C<%s>, which will be replaced with the value of the filename field
(possibly after mapping with the map file from B<-m>). The default value
-is I<pathoutgoing>/%s.
+is I<pathoutgoing>/C<%s>.
=item B<-u>
Modified: buffindexed.conf.pod
===================================================================
--- buffindexed.conf.pod 2007-08-10 11:25:05 UTC (rev 7642)
+++ buffindexed.conf.pod 2007-08-10 17:48:06 UTC (rev 7643)
@@ -44,7 +44,7 @@
<filename> is the path to the buffer. The length of the path should not
be longer than 63 characters.
-<size> is the length of the buffer in kilobytes (1KB = 1024 byte). If
+<size> is the length of the buffer in kilobytes (1KB = 1024 bytes). If
<filename> does not specify a special device, the file size of the buffer
must be <size> * 1024 bytes. If it does specify a special device, that
device must have at least <size> space available. Buffers over 2GB are
@@ -122,7 +122,7 @@
major=`ls -Ll "$1" | awk '{print $5}' | tr -d ,`
minor=`ls -Ll "$1" | awk '{print $6}`
mkdir -p /usr/local/news/spool/overview
- mknod /usr/local/news/spool/overvew/"$base" b "$major" "$minor"
+ mknod /usr/local/news/spool/overview/"$base" b "$major" "$minor"
chown news:news /usr/local/news/spool/overview/"$base"
chmod 644 /usr/local/news/spool/overview/"$base"
@@ -144,6 +144,7 @@
expireover(8),
inn.conf(5),
+inndf(8),
makehistory(8).
=cut
Modified: storage.conf.pod
===================================================================
--- storage.conf.pod 2007-08-10 11:25:05 UTC (rev 7642)
+++ storage.conf.pod 2007-08-10 17:48:06 UTC (rev 7643)
@@ -78,7 +78,7 @@
the newsgroup names in the Newsgroups: header (see inn.conf(5) for discussion
of the differences between these possibilities). Poison wildmat expressions
(expressions starting with C<@>) are allowed and can be used to exclude certain
-group patterns: articles crossposted to poisoned newsgroups will not be stored
+group patterns: articles crossposted to poisoned newsgroups will not be stored
using this storage method. The <wildmat> pattern is matched in order.
There is no default newsgroups pattern; if an entry should match all
@@ -179,7 +179,7 @@
the metacycbuff into which articles matching that entry should be stored;
see cycbuff.conf(5) for details on metacycbuffs.
-Advantages: By far the fastest of all storage methods (except for C<trash>),
+Advantages: By far the fastest of all storage methods (except for C<trash>),
since it eliminates the overhead of dealing with a file system and creating
new files. Unlike all other storage methods, it does not require manual
article expiration. With CNFS, the server will never throttle itself
@@ -187,7 +187,7 @@
files given so that they can never use more than the amount of disk space
allocated to them.
-Disadvantages: Article retention times are more difficult to control
+Disadvantages: Article retention times are more difficult to control
because old articles are overwritten automatically. Attacks on Usenet,
such as flooding or massive amounts of spam, can result in wanted articles
expiring much faster than intended (with no warning).
@@ -207,11 +207,11 @@
have self-expire functionality (meaning B<expire> has to run periodically
to delete old articles). EXPENSIVESTAT is false for this method.
-Advantages: It is roughly four times faster than C<timehash> for article
+Advantages: It is roughly four times faster than C<timehash> for article
writes, since much of the file system overhead is bypassed, while still
retaining the same fine control over article retention time.
-Disadvantages: Using this method means giving up all but the most careful
+Disadvantages: Using this method means giving up all but the most careful
manually fiddling with the article spool; in this aspect, it looks like
C<cnfs>. As one of the newer and least widely used storage types,
C<timecaf> has not been as thoroughly tested as the other methods.
@@ -230,10 +230,10 @@
documented above under C<timecaf>). This method does not have self-expire
functionality. EXPENSIVESTAT is true for this method.
-Advantages: Heavy traffic groups do not cause bottlenecks, and a fine control
+Advantages: Heavy traffic groups do not cause bottlenecks, and a fine control
of article retention time is still possible.
-Disadvantages: The ability to easily find all articles in a given newsgroup
+Disadvantages: The ability to easily find all articles in a given newsgroup
and manually fiddle with the article spool is lost, and INN still suffers
from speed degradation due to file system overhead (creating and deleting
individual files is a slow operation).
@@ -254,14 +254,14 @@
used by C News and earlier news systems. This method does not have
self-expire functionality. EXPENSIVESTAT is true for this method.
-Advantages: It is widely used and well-understood; it can read article
+Advantages: It is widely used and well-understood; it can read article
spools written by older versions of INN and it is compatible with all
third-party INN add-ons. This storage mechanism provides easy and direct
access to the articles stored on the server and makes writing programs
that fiddle with the news spool very easy, and gives fine control over
article retention times.
-Disadvantages: It takes a very fast file system and I/O system to keep up with
+Disadvantages: It takes a very fast file system and I/O system to keep up with
current Usenet traffic volumes due to file system overhead. Groups with heavy
traffic tend to create a bottleneck because of inefficiencies in storing large
numbers of article files in a single directory. It requires a nightly expire
More information about the inn-committers
mailing list