Subject: | POD issues, typos |
Hi,
while packaging version 1.000 of Log-Agent for Debian, our automated QA tools called my attention to a number of typos and minor POD issues, and I'd like to share the patch for inclusion at your convenience.
Florian
Subject: | pod-errors.patch |
--- a/Agent/Driver/Default.pm
+++ b/Agent/Driver/Default.pm
@@ -179,6 +179,8 @@
$prefix. When no prefix is configured, the first letter of each logged
string will be uppercased.
+=back
+
=head1 CHANNELS
The C<error>, C<output> and C<debug> channels all go to STDERR.
--- a/Agent/Driver/Fork.pm
+++ b/Agent/Driver/Fork.pm
@@ -308,6 +308,8 @@
distributes them to the drivers in @drivers. The arguments must be the return
value of the make() call for the client drivers.
+=back
+
=head1 NOTES
Many thanks go to Daniel Lundin and Jason May who proposed this module
--- a/Agent.pm
+++ b/Agent.pm
@@ -469,7 +469,7 @@
=head1 DESCRIPTION
The C<Log::Agent> module provides an abstract layer for logging and
-tracing, which is independant from the actual method used to physically
+tracing, which is independent from the actual method used to physically
perform those activities. It acts as an agent (hence the name) that
collects the requests and delegates processing to a sublayer: the
logging driver.
@@ -599,7 +599,7 @@
=item Log::Agent::inited
-Returns true when C<Log::Agent> was initialized, either explicitely via
+Returns true when C<Log::Agent> was initialized, either explicitly via
a logconfig() or implicitely via any logxxx() call.
=back
@@ -624,7 +624,7 @@
For applications that wish to implement a debug layer on top of
C<Log::Agent>, the following routine is provided. Note that it is not
-imported by default, i.e. it needs to be explicitely mentionned at C<use>
+imported by default, i.e. it needs to be explicitly mentionned at C<use>
time, since it is not meant to be used directly under regular usage.
=over 4
--- a/Agent/Driver.pm
+++ b/Agent/Driver.pm
@@ -559,7 +559,7 @@
=back
The following routine is B<frozen>. There is no way in Perl to freeze a routine,
-i.e. to explicitely forbid any redefinition, so this is an informal
+i.e. to explicitly forbid any redefinition, so this is an informal
notification:
=over 4
--- a/Agent/Tag/Priority.pm
+++ b/Agent/Tag/Priority.pm
@@ -134,7 +134,7 @@
=item C<-level> => I<level>
This parameter is internally added by C<Log::Agent> when computing the
-priority tag, since only it knows the level of the current messsage.
+priority tag, since only it knows the level of the current message.
=item C<-postfix> => I<flag>
@@ -144,7 +144,7 @@
=item C<-priority> => I<prio>
This parameter is internally added by C<Log::Agent> when computing the
-priority tag, since only it knows the priority of the current messsage.
+priority tag, since only it knows the priority of the current message.
=item C<-separator> => I<string>