From a1c8462557e62c32089063d8096fc5d78f4a8f09 Mon Sep 17 00:00:00 2001
From: Matt Simerson <matt@tnpi.net>
Date: Mon, 7 May 2012 03:35:56 -0400
Subject: [PATCH] moved warn plugin POD to top, merged with # comments

---
 plugins/logging/warn | 75 ++++++++++++++++++++++----------------------
 1 file changed, 37 insertions(+), 38 deletions(-)

diff --git a/plugins/logging/warn b/plugins/logging/warn
index ce41b49..c85b9d5 100644
--- a/plugins/logging/warn
+++ b/plugins/logging/warn
@@ -1,8 +1,41 @@
 #!perl -w
-# this is a simple 'warn' plugin like the default builtin logging
-#
-# It demonstrates that a logging plugin can call ->log itself as well
-# as how to ignore log entries from itself
+
+=head1 NAME
+
+warn - Default logging plugin for qpsmtpd
+
+=head1 DESCRIPTION
+
+A qpsmtpd plugin which replicates the built in logging functionality, which
+is to send all logging messages to STDERR below a specific log level.
+
+It demonstrates that a logging plugin can call ->log itself as well
+as how to ignore log entries from itself
+
+=head1 INSTALL AND CONFIG
+
+Place this plugin in the plugin/logging directory beneath the standard
+qpsmtpd installation.  Edit the config/logging file and add a line like
+this:
+
+  logging/warn [loglevel]
+
+where the optional parameters C<loglevel> is either the numeric or text
+representation of the maximum log level, as shown in the
+L<config.sample/loglevel> file.
+
+=head1 AUTHOR
+
+John Peacock <jpeacock@cpan.org>
+
+=head1 COPYRIGHT AND LICENSE
+
+Copyright (c) 2005 John Peacock
+
+This plugin is licensed under the same terms as the qpsmtpd package itself.
+Please see the LICENSE file included with qpsmtpd for details.
+
+=cut
 
 sub register {
   my ($self, $qp, $loglevel) = @_;
@@ -41,37 +74,3 @@ sub hook_logging {
     return DECLINED;
 }
 
-=head1 NAME
-
-warn - Default logging plugin for qpsmtpd
-
-=head1 DESCRIPTION
-
-A qpsmtpd plugin which replicates the built in logging functionality, which
-is to send all logging messages to STDERR below a specific log level.
-
-=head1 INSTALL AND CONFIG
-
-Place this plugin in the plugin/logging directory beneath the standard
-qpsmtpd installation.  Edit the config/logging file and add a line like
-this:
-
-  logging/warn [loglevel]
-
-where the optional parameters C<loglevel> is either the numeric or text
-representation of the maximum log level, as shown in the
-L<config.sample/loglevel> file.
-
-=head1 AUTHOR
-
-John Peacock <jpeacock@cpan.org>
-
-=head1 COPYRIGHT AND LICENSE
-
-Copyright (c) 2005 John Peacock
-
-This plugin is licensed under the same terms as the qpsmtpd package itself.
-Please see the LICENSE file included with qpsmtpd for details.
-
-=cut
-