From 6e6c520f943284696f75ad24d4f87f77830a0ba9 Mon Sep 17 00:00:00 2001 From: Daniel Weber Date: Tue, 28 Sep 2010 22:15:08 +0200 Subject: [PATCH 1/4] README: improve phrasing. Signed-off-by: Thomas Hochstein --- doc/README | 13 +++++++------ 1 file changed, 7 insertions(+), 6 deletions(-) diff --git a/doc/README b/doc/README index 440cd11..150077f 100644 --- a/doc/README +++ b/doc/README @@ -12,7 +12,7 @@ the Free Software Foundation. What's that? There's a multitude of tools for the statistical examination of - newsgroups: number of postings month or per person, longest + newsgroups: number of postings per month or per person, longest threads, and so on (see [German language] for an incomplete list). Most of them use a per- newsgroup approach while NewsStats is hierarchy oriented. @@ -27,7 +27,7 @@ Workflow That raw data will be regularly - e.g. monthly - processed to a second set of database tables each dedicated to a certain - statistical aspect, e.g. number of postings per group per month. + statistical aspect, e.g. number of postings per group and month. Several kinds of reports can then be generated from those result tables. @@ -35,8 +35,8 @@ Workflow Prerequisites NewsStats is written in Perl (5.8.x and above) and makes use of a - MySQL database, so you'll need Perl, some modules, mysql and, of - course, an INN. + MySQL database, so you will need Perl, some modules, mysql and, of + course, INN. * Perl 5.8.x with standard modules - Cwd @@ -62,12 +62,12 @@ Getting Started table. See the feedlog.pl man page for more information. You can process that data via 'gatherstats.pl'; currently only the - tabulation of postings per group per month is supported. More to + tabulation of postings per group and month is supported. More to come. See the gatherstats.pl man page for more information. Report generation is handled by specialised scripts for each report type. Currently only reports on the number of postings per - group per month are supported; you can use 'groupstats.pl' for + group and month are supported; you can use 'groupstats.pl' for this. See the groupstats.pl man page for more information. Reporting Bugs @@ -95,3 +95,4 @@ Author Thomas Hochstein + From 435a99783c6f0fdf6fc0f584d6d8a9968d9bf6de Mon Sep 17 00:00:00 2001 From: Thomas Hochstein Date: Sat, 13 Oct 2012 01:35:34 +0200 Subject: [PATCH 2/4] README: Update copyright notice. Signed-off-by: Thomas Hochstein --- doc/README | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/README b/doc/README index 150077f..4c88ef2 100644 --- a/doc/README +++ b/doc/README @@ -1,4 +1,4 @@ -NewsStats 0.1 (c) 2010 Thomas Hochstein +NewsStats 0.1 (c) 2010-2012 Thomas Hochstein NewsStats is a software package for gathering statistical data live from a Usenet feed and subsequent examination. From b31f78506404cd5db097135a0b5ac7abe270c71f Mon Sep 17 00:00:00 2001 From: Thomas Hochstein Date: Sat, 13 Oct 2012 01:36:17 +0200 Subject: [PATCH 3/4] Improve INSTALL documentation. Fix wrong example for newsfeeds entry (lacking backslashes). Fix typos, update copyright, improve phrasing. Signed-off-by: Thomas Hochstein --- doc/INSTALL | 11 ++++++----- 1 file changed, 6 insertions(+), 5 deletions(-) diff --git a/doc/INSTALL b/doc/INSTALL index 225fdbf..0c2790c 100644 --- a/doc/INSTALL +++ b/doc/INSTALL @@ -1,4 +1,4 @@ -NewsStats 0.1 (c) 2010 Thomas Hochstein +NewsStats 0.1 (c) 2010-2012 Thomas Hochstein NewsStats is a software package for gathering statistical data live from a Usenet feed and subsequent examination. @@ -20,7 +20,8 @@ INSTALLATION INSTRUCTIONS # tar -xzf newsstats-nn.tar.gz - Scripts in this path should be executable by the news user. + Scripts in this path - at least feedlog.pl - should be executable by the + news user. 2) Configuration @@ -80,8 +81,8 @@ INSTALLATION INSTRUCTIONS * Edit your 'newsfeeds' file and insert something like ## gather statistics for NewsStats - newsstats! - :!*,de.* + newsstats!\ + :!*,de.*\ :Tc,WmtfbsPNH,Ac:/path/to/feedlog.pl * You should only feed that hierarchy (those hierarchies ...) to @@ -109,7 +110,7 @@ INSTALLATION INSTRUCTIONS Everything should be going smoothly now. * If INN is spewing error messages to 'errlog' or reporting - continous respaws of feedlog.pl to 'news.notice', stop your feed: + continous respawns of feedlog.pl to 'news.notice', stop your feed: # ctlinnd drop 'newsstats!' From 95d9fe2cfd944f93036d3c584328a91d952c5c7c Mon Sep 17 00:00:00 2001 From: Thomas Hochstein Date: Sun, 11 Aug 2013 22:44:08 +0200 Subject: [PATCH 4/4] Some documentation fixes and enhancments. Signed-off-by: Thomas Hochstein --- doc/INSTALL | 4 ++-- feedlog.pl | 2 +- gatherstats.pl | 8 ++++---- groupstats.pl | 11 +++++++---- 4 files changed, 14 insertions(+), 11 deletions(-) diff --git a/doc/INSTALL b/doc/INSTALL index 0c2790c..3539ab2 100644 --- a/doc/INSTALL +++ b/doc/INSTALL @@ -1,7 +1,7 @@ NewsStats 0.1 (c) 2010-2012 Thomas Hochstein -NewsStats is a software package for gathering statistical data live -from a Usenet feed and subsequent examination. +NewsStats is a software package used to gather statistical information +from a live Usenet feed and for its subsequent examination. This script package is free software; you can redistribute it and/or modify it under the terms of the GNU Public License as published by diff --git a/feedlog.pl b/feedlog.pl index 636de83..0814f2c 100755 --- a/feedlog.pl +++ b/feedlog.pl @@ -200,7 +200,7 @@ Suppress logging to syslog. =head1 INSTALLATION -See L +See L. =head1 EXAMPLES diff --git a/gatherstats.pl b/gatherstats.pl index 4c539f1..64ea87b 100755 --- a/gatherstats.pl +++ b/gatherstats.pl @@ -205,7 +205,7 @@ gatherstats - process statistical data from a raw source =head1 SYNOPSIS -B [B<-Vhdt>] [B<-m> I | I] [B<-s> I I]] [B<--hierarchy> I] [B<--rawdb> I] [B<-groupsdb> I] [B<--clientsdb> I] [B<--hostsdb> I] +B [B<-Vhdt>] [B<-m> I | I] [B<-s> I] [B<-c> I]] [B<--hierarchy> I] [B<--rawdb> I] [B<-groupsdb> I] [B<--clientsdb> I] [B<--hostsdb> I] =head1 REQUIREMENTS @@ -292,7 +292,6 @@ Set processing period to a single month in YYYY-MM format or to a time period between two month in YYYY-MM:YYYY-MM format (two month, separated by a colon). - =item B<-s>, B<--stats> I Set processing type to one of I and I. Defaults to all @@ -306,8 +305,9 @@ one group on each line and ignoring everything after the first whitespace (so you can use a file in checkgroups format or (part of) your INN active file). -The filename is taken from I, amended by each B<-- -month> B is processing, so that +The filename is taken from I, amended by each +B<--month> B is processing in the form of I, +so that gatherstats -m 2010-01:2010-12 -c checkgroups diff --git a/groupstats.pl b/groupstats.pl index 14d19c6..efd34ef 100755 --- a/groupstats.pl +++ b/groupstats.pl @@ -372,6 +372,9 @@ Restrict output to those newgroups present in a file in checkgroups format (one newgroup name per line; everything after the first whitespace on each line is ignored). All other newsgroups will be removed from output. +Contrary to B, I is not a template, but refers to +a single file in checkgroups format. + =item B<-r>, B<--report> I Choose the report type: I, I or I @@ -429,8 +432,8 @@ you'll get the following result: de.comp.datenbanken.misc has not been considered even though it has 38 postings in total, because it has less than 25 postings in every single -month. If you want to list all newsgroups with more than 25 postings U, you'll have to set the boundary type to I, see below. +month. If you want to list all newsgroups with more than 25 postings +I, you'll have to set the boundary type to I, see below. A boundary type of I will show only those newsgroups - at all - that satisfy the boundaries in each and every single month. With the above @@ -442,10 +445,10 @@ you'll get this result: de.comp.datenbanken.ms-access 293 de.comp.datenbanken.mysql has not been considered because it had less than -25 postings in 2012-02. +25 postings in 2012-02 (only). You can use that to get a list of newsgroups that have more (or less) then -x postings during the whole reporting period. +x postings in every month during the whole reporting period. A boundary type of I will show only those newsgroups - at all -that satisfy the boundaries on average. With the above list of newsgroups and