Refreshed kill-dot-pl patch.
[sven/pflogsumm.git] / debian / patches / kill-dot-pl
1 Starting with 1.1.3-2 the pflogsumm package no longer ships the
2 '.pl' compatiblity symlinks. Thus for consistency we've to do some
3 s/pflogsumm.pl/pflogsumm/ all over the place.
4 --- a/pflogsumm-faq.txt
5 +++ b/pflogsumm-faq.txt
6 @@ -1,5 +1,5 @@
7  
8 -FAQ for Pflogsumm.pl - A Log Summarizer/Analyzer for the Postfix MTA
9 +FAQ for pflogsumm - A Log Summarizer/Analyzer for the Postfix MTA
10  
11  Introduction
12  
13 @@ -7,13 +7,13 @@ Introduction
14      hearted exercise in improving my facility with Perl--with the hope
15      that something useful would come out of it as well--has turned out to
16      be a somewhat popular utility.  And as more Admins find out about
17 -    postfix, and more end up trying pflogsumm.pl,  many of the questions,
18 +    postfix, and more end up trying pflogsumm,  many of the questions,
19      suggestions, and enhancement requests are becoming "frequently
20      asked".  So odd as it seems (to me, at any rate), it looks like it's
21      time for a FAQ.
22  
23  
24 -Index of pflogsumm.pl Frequently Asked Questions (in no particular order)
25 +Index of pflogsumm Frequently Asked Questions (in no particular order)
26  
27       1. Project Status
28       2. "Could You Make" or "Here's A Patch To Make" Pflogsumm Do ...
29 @@ -137,11 +137,11 @@ Index of pflogsumm.pl Frequently Asked Q
30      "creeping over-feature-itis" if I can.  My position is *not* set in
31      stone on this issue.  In the mean-time:
32  
33 -       zcat /var/log/maillog.0.gz |pflogsumm.pl <args...>
34 +       zcat /var/log/maillog.0.gz |pflogsumm <args...>
35  
36         or
37  
38 -       gunzip </var/log/maillog.0.gz |pflogsumm.pl <args...>
39 +       gunzip </var/log/maillog.0.gz |pflogsumm <args...>
40  
41      should do the trick quite nicely for you.
42  
43 @@ -149,7 +149,7 @@ Index of pflogsumm.pl Frequently Asked Q
44      exactly at midnight, you might try something like:
45  
46         (zcat /var/log/maillog.0.gz; cat /var/log/maillog) \
47 -           |pflogsumm.pl -d yesterday
48 +           |pflogsumm -d yesterday
49  
50      See Also:  5. Processing Multiple Log Files
51                17. How Do I Get Pflogsumm To Email Reports To Me
52 @@ -175,7 +175,7 @@ Index of pflogsumm.pl Frequently Asked Q
53      A more complex example, where compressed logs are involved:
54  
55         (zcat `ls -rt /var/log/maillog.*.gz`; cat /var/log/maillog) \
56 -           |pflogsumm.pl
57 +           |pflogsumm
58  
59      Obviously, this depends on the file modification times for your logs
60      being reflective of their chronological order.  If that can't be
61 @@ -185,12 +185,12 @@ Index of pflogsumm.pl Frequently Asked Q
62         (for each in 3 2 1 0; do
63              zcat "/var/log/maillog.$each.gz"
64          done
65 -        cat /var/log/maillog) |pflogsumm.pl
66 +        cat /var/log/maillog) |pflogsumm
67  
68      or (somewhat more efficiently--by running zcat only once):
69  
70         (zcat `for ea in 3 2 1 0; do echo "/var/log/maillog.$ea.gz";
71 -        done`; cat /var/log/maillog) |pflogsumm.pl
72 +        done`; cat /var/log/maillog) |pflogsumm
73  
74      [Note: I didn't actually run these.  So you would be well-advised
75       to double-check them.]
76 @@ -305,7 +305,7 @@ Index of pflogsumm.pl Frequently Asked Q
77         Message size is reported only by the queue manager.  The message
78         may be delivered long-enough after the (last) qmgr log entry that
79         the information is not in the log(s) processed by a particular run
80 -       of pflogsumm.pl.
81 +       of pflogsumm.
82  
83      The Result:
84  
85 @@ -337,7 +337,7 @@ Index of pflogsumm.pl Frequently Asked Q
86  
87  10. Pflogsumm misses/mis-diagnoses/mis-reports, etc. <whatever>
88  
89 -    Are you using a real old version of VMailer?  As of pflogsumm.pl
90 +    Are you using a real old version of VMailer?  As of pflogsumm
91      version 19990220-06, versions of VMailer prior to 19981023 are no
92      longer supported.  Sorry.  Pflogsumm-19990121-01.pl will be made
93      permanently available from now on for those with out-of-date versions
94 @@ -346,7 +346,7 @@ Index of pflogsumm.pl Frequently Asked Q
95      Are you processing your log files in chronological order?  See item
96      "5: "Processing Multiple Log Files".
97  
98 -    Pflogsumm.pl is being developed by me on my rather small-scale server
99 +    pflogsumm is being developed by me on my rather small-scale server
100      at home.  There are only two users on the system.  And I do no
101      mail-forwarding.  So the log samples I have to work with are
102      commensurately limited.
103 @@ -366,13 +366,13 @@ Index of pflogsumm.pl Frequently Asked Q
104  11. Pflogsumm is generating lots of "uninitialized value" warnings
105  
106      Are you using a version of Perl lower than 5.004_04?  Perhaps with a
107 -    "beta" version of pflogsumm.pl?  If so, try turning off the "-w"
108 +    "beta" version of pflogsumm?  If so, try turning off the "-w"
109      switch.  Pflogsumm as of 19990413-02beta appeared to work correctly
110      with Perl 5.003 in spite of the warnings.  (Those warnings didn't
111      appear with Perl 5.004.)
112  
113      I don't guarantee that I'll remember to test future versions of
114 -    pflogsumm.pl against 5.003, but I'll try to :-).
115 +    pflogsumm against 5.003, but I'll try to :-).
116  
117      You really should consider upgrading your Perl to 5.004 or later.
118  
119 --- a/pflogsumm.1
120 +++ b/pflogsumm.1
121 @@ -130,13 +130,13 @@
122  .if n .ad l
123  .nh
124  .SH "NAME"
125 -pflogsumm.pl \- Produce Postfix MTA logfile summary
126 +pflogsumm \- Produce Postfix MTA logfile summary
127  .PP
128  Copyright (C) 1998\-2010 by James S. Seymour, Release 1.1.4
129  .SH "SYNOPSIS"
130  .IX Header "SYNOPSIS"
131  .Vb 8
132 -\&    pflogsumm.pl \-[eq] [\-d <today|yesterday>] [\-\-detail <cnt>]
133 +\&    pflogsumm \-[eq] [\-d <today|yesterday>] [\-\-detail <cnt>]
134  \&        [\-\-bounce\-detail <cnt>] [\-\-deferral\-detail <cnt>]
135  \&        [\-h <cnt>] [\-i|\-\-ignore\-case] [\-\-iso\-date\-time] [\-\-mailq]
136  \&        [\-m|\-\-uucp\-mung] [\-\-no\-no\-msg\-size] [\-\-problems\-first]
137 @@ -145,7 +145,7 @@ Copyright (C) 1998\-2010 by James S. Sey
138  \&        [\-\-syslog\-name=string] [\-u <cnt>] [\-\-verbose\-msg\-detail]
139  \&        [\-\-verp\-mung[=<n>]] [\-\-zero\-fill] [file1 [filen]]
140  \&
141 -\&    pflogsumm.pl \-[help|version]
142 +\&    pflogsumm \-[help|version]
143  \&
144  \&    If no file(s) specified, reads from stdin.  Output is to stdout.
145  .Ve
146 @@ -268,7 +268,7 @@ Copyright (C) 1998\-2010 by James S. Sey
147  \&                    The message may be delivered long\-enough after the
148  \&                    (last) qmgr log entry that the information is not in
149  \&                    the log(s) processed by a particular run of
150 -\&                    pflogsumm.pl.  This throws off "Recipients by message
151 +\&                    pflogsumm.  This throws off "Recipients by message
152  \&                    size" and the total for "bytes delivered." These are
153  \&                    normally reported by pflogsumm as "Messages with no
154  \&                    size data."
155 @@ -386,15 +386,15 @@ Copyright (C) 1998\-2010 by James S. Sey
156  .Vb 1
157  \&    Produce a report of previous day\*(Aqs activities:
158  \&
159 -\&        pflogsumm.pl \-d yesterday /var/log/maillog
160 +\&        pflogsumm \-d yesterday /var/log/maillog
161  \&
162  \&    A report of prior week\*(Aqs activities (after logs rotated):
163  \&
164 -\&        pflogsumm.pl /var/log/maillog.0
165 +\&        pflogsumm /var/log/maillog.0
166  \&
167  \&    What\*(Aqs happened so far today:
168  \&
169 -\&        pflogsumm.pl \-d today /var/log/maillog
170 +\&        pflogsumm \-d today /var/log/maillog
171  \&
172  \&    Crontab entry to generate a report of the previous day\*(Aqs activity
173  \&    at 10 minutes after midnight.
174 --- a/pflogsumm.pl
175 +++ b/pflogsumm.pl
176 @@ -4,13 +4,13 @@ eval 'exec perl -S $0 "$@"'
177  
178  =head1 NAME
179  
180 -pflogsumm.pl - Produce Postfix MTA logfile summary
181 +pflogsumm - Produce Postfix MTA logfile summary
182  
183  Copyright (C) 1998-2010 by James S. Seymour, Release 1.1.4
184  
185  =head1 SYNOPSIS
186  
187 -    pflogsumm.pl -[eq] [-d <today|yesterday>] [--detail <cnt>]
188 +    pflogsumm -[eq] [-d <today|yesterday>] [--detail <cnt>]
189         [--bounce-detail <cnt>] [--deferral-detail <cnt>]
190         [-h <cnt>] [-i|--ignore-case] [--iso-date-time] [--mailq]
191         [-m|--uucp-mung] [--no-no-msg-size] [--problems-first]
192 @@ -19,7 +19,7 @@ Copyright (C) 1998-2010 by James S. Seym
193         [--syslog-name=string] [-u <cnt>] [--verbose-msg-detail]
194         [--verp-mung[=<n>]] [--zero-fill] [file1 [filen]]
195  
196 -    pflogsumm.pl -[help|version]
197 +    pflogsumm -[help|version]
198  
199      If no file(s) specified, reads from stdin.  Output is to stdout.
200  
201 @@ -140,7 +140,7 @@ Copyright (C) 1998-2010 by James S. Seym
202                     The message may be delivered long-enough after the
203                     (last) qmgr log entry that the information is not in
204                     the log(s) processed by a particular run of
205 -                   pflogsumm.pl.  This throws off "Recipients by message
206 +                   pflogsumm.  This throws off "Recipients by message
207                     size" and the total for "bytes delivered." These are
208                     normally reported by pflogsumm as "Messages with no
209                     size data."
210 @@ -255,15 +255,15 @@ Copyright (C) 1998-2010 by James S. Seym
211  
212      Produce a report of previous day's activities:
213  
214 -        pflogsumm.pl -d yesterday /var/log/maillog
215 +        pflogsumm -d yesterday /var/log/maillog
216  
217      A report of prior week's activities (after logs rotated):
218  
219 -        pflogsumm.pl /var/log/maillog.0
220 +        pflogsumm /var/log/maillog.0
221  
222      What's happened so far today:
223  
224 -        pflogsumm.pl -d today /var/log/maillog
225 +        pflogsumm -d today /var/log/maillog
226  
227      Crontab entry to generate a report of the previous day's activity
228      at 10 minutes after midnight.