Update documentation.

- Fix clientstats doc (copied from hoststats).
- Add some more examples ro README.

Signed-off-by: Thomas Hochstein <thh@thh.name>

bin/hoststats.pl

@@ -197,7 +197,7 @@ See L<doc/README>.
 
 =head1 DESCRIPTION
 
-This script create reports on newsgroup usage (number of postings from
+This script creates reports on newsgroup usage (number of postings from
 each host) taken from result tables created by B<gatherstats.pl>.
 
 =head2 Features and options
@@ -236,18 +236,19 @@ please see below.
 
 The results will be formatted as a kind of table; you can change the
 output format to a simple list or just a list of names and number of
-postings with the B<--format> option. Captions will be added by means of
-the B<--caption> option; all comments (and captions) can be supressed by
-using B<--nocomments>.
+postings with the B<--format> option. Captions will be added by means
+of the B<--caption> option; all comments (and captions) can be
+supressed by using B<--nocomments>.
 
-Last but not least you can redirect all output to a number of files, e.g.
-one for each month, by submitting the B<--filetemplate> option, see below.
+Last but not least you can redirect all output to a number of files,
+e.g. one for each month, by submitting the B<--filetemplate> option,
+see below.
 
 =head2 Configuration
 
 B<hoststats> will read its configuration from F<newsstats.conf>
-which should be present in etc/ via Config::Auto or from a configuration file
-submitted by the B<--conffile> option.
+which should be present in etc/ via Config::Auto or from a configuration
+file submitted by the B<--conffile> option.
 
 See doc/INSTALL for an overview of possible configuration options.
 
@@ -259,18 +260,18 @@ You can override some configuration options via the B<--db> option.
 
 =item B<-V>, B<--version>
 
-Print out version and copyright information and exit.
+Display version and copyright information and exit.
 
 =item B<-h>, B<--help>
 
-Print this man page and exit.
+Display this man page and exit.
 
 =item B<-m>, B<--month> I<YYYY-MM[:YYYY-MM]|all>
 
 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). By using the keyword I<all> instead, you can set no
-processing period to process the whole database.
+processing period to process the whole database. Defaults to last month.
 
 =item B<-n>, B<--names> I<name(s)>
 
@@ -284,7 +285,8 @@ example
 =item B<-s>, B<--sums|--nosums> (sum per month)
 
 Include a "virtual" host named "ALL" for every month in output,
-containing the sum of all detected hosts for that month.
+containing the sum of all detected hosts for that month. False
+by default.
 
 =item B<-r>, B<--report> I<default|sums>
 
@@ -315,8 +317,8 @@ considered.
 
 =item B<-g>, B<--group-by> I<month[-desc]|name[-desc]>
 
-By default, all results are grouped by month, sorted chronologically in
-ascending order, like this:
+By default, all results are grouped by month, sorted chronologically
+in ascending order, like this:
 
     # ----- 2012-01:
     arcor-online.net :  9379
@@ -339,8 +341,8 @@ The results can be grouped by host instead via B<--group-by> I<name>:
     2012-01: 9063
     2012-02: 7879
 
-By appending I<-desc> to the group-by option parameter, you can reverse
-the sort order - e.g. B<--group-by> I<month-desc> will give:
+By appending I<-desc> to the group-by option parameter, you can
+reverse the sort order - e.g. B<--group-by> I<month-desc> will give:
 
     # ----- 2012-02:
     arcor-online.net :  8606
@@ -427,7 +429,7 @@ Override I<DBTableHosts> from F<newsstats.conf>.
 
 =item B<--conffile> I<filename>
 
-Load configuration from I<filename> instead of F<newsstats.conf>.
+Read configuration from I<filename> instead of F<newsstats.conf>.
 
 =back
 
@@ -437,7 +439,7 @@ See L<doc/INSTALL>.
 
 =head1 EXAMPLES
 
-Show number of postings per group for lasth month in I<pretty> format:
+Show number of postings per host for lasth month in I<pretty> format:
 
     hoststats