You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@spamassassin.apache.org by qu...@apache.org on 2005/01/30 23:56:08 UTC

svn commit: r149177 - in spamassassin/trunk/lib/Mail/SpamAssassin/Plugin: DCC.pm DomainKeys.pm Hashcash.pm MSExec.pm NetCache.pm Pyzor.pm Razor2.pm RelayCountry.pm SPF.pm SpamCop.pm Test.pm URIDNSBL.pm

Author: quinlan
Date: Sun Jan 30 14:56:06 2005
New Revision: 149177

URL: http://svn.apache.org/viewcvs?view=rev&rev=149177
Log:
make sure every plugin has NAME, SYNOPSIS, DESCRIPTION, and a license
block at the top of the file

Modified:
    spamassassin/trunk/lib/Mail/SpamAssassin/Plugin/DCC.pm
    spamassassin/trunk/lib/Mail/SpamAssassin/Plugin/DomainKeys.pm
    spamassassin/trunk/lib/Mail/SpamAssassin/Plugin/Hashcash.pm
    spamassassin/trunk/lib/Mail/SpamAssassin/Plugin/MSExec.pm
    spamassassin/trunk/lib/Mail/SpamAssassin/Plugin/NetCache.pm
    spamassassin/trunk/lib/Mail/SpamAssassin/Plugin/Pyzor.pm
    spamassassin/trunk/lib/Mail/SpamAssassin/Plugin/Razor2.pm
    spamassassin/trunk/lib/Mail/SpamAssassin/Plugin/RelayCountry.pm
    spamassassin/trunk/lib/Mail/SpamAssassin/Plugin/SPF.pm
    spamassassin/trunk/lib/Mail/SpamAssassin/Plugin/SpamCop.pm
    spamassassin/trunk/lib/Mail/SpamAssassin/Plugin/Test.pm
    spamassassin/trunk/lib/Mail/SpamAssassin/Plugin/URIDNSBL.pm

Modified: spamassassin/trunk/lib/Mail/SpamAssassin/Plugin/DCC.pm
URL: http://svn.apache.org/viewcvs/spamassassin/trunk/lib/Mail/SpamAssassin/Plugin/DCC.pm?view=diff&r1=149176&r2=149177
==============================================================================
--- spamassassin/trunk/lib/Mail/SpamAssassin/Plugin/DCC.pm (original)
+++ spamassassin/trunk/lib/Mail/SpamAssassin/Plugin/DCC.pm Sun Jan 30 14:56:06 2005
@@ -1,7 +1,29 @@
+# <@LICENSE>
+# Copyright 2004 Apache Software Foundation
+# 
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+# 
+#     http://www.apache.org/licenses/LICENSE-2.0
+# 
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+# </...@LICENSE>
+
 =head1 NAME
 
 Mail::SpamAssassin::Plugin::DCC - perform DCC check of messages
 
+=head1 SYNOPSIS
+
+  loadplugin     Mail::SpamAssassin::Plugin::DCC
+
+=head1 DESCRIPTION
+
 The DCC or Distributed Checksum Clearinghouse is a system of servers
 collecting and counting checksums of millions of mail messages. The
 counts can be used by SpamAssassin to detect and reject or filter spam.
@@ -13,29 +35,9 @@
 See http://www.rhyolite.com/anti-spam/dcc/ for more information about
 DCC.
 
-=head1 SYNOPSIS
-
-  loadplugin     Mail::SpamAssassin::Plugin::DCC
-
 =over 4
 
 =cut
-
-# <@LICENSE>
-# Copyright 2004 Apache Software Foundation
-#
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-#
-#     http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
-# </...@LICENSE>
 
 package Mail::SpamAssassin::Plugin::DCC;
 

Modified: spamassassin/trunk/lib/Mail/SpamAssassin/Plugin/DomainKeys.pm
URL: http://svn.apache.org/viewcvs/spamassassin/trunk/lib/Mail/SpamAssassin/Plugin/DomainKeys.pm?view=diff&r1=149176&r2=149177
==============================================================================
--- spamassassin/trunk/lib/Mail/SpamAssassin/Plugin/DomainKeys.pm (original)
+++ spamassassin/trunk/lib/Mail/SpamAssassin/Plugin/DomainKeys.pm Sun Jan 30 14:56:06 2005
@@ -1,3 +1,19 @@
+# <@LICENSE>
+# Copyright 2004 Apache Software Foundation
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+# </...@LICENSE>
+
 =head1 NAME
 
 Mail::SpamAssassin::Plugin::DomainKeys - perform DomainKeys verification tests
@@ -13,21 +29,6 @@
 This is the DomainKeys plugin and it needs lots more documentation.
 
 =cut
-# <@LICENSE>
-# Copyright 2004 Apache Software Foundation
-# 
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-# 
-#     http://www.apache.org/licenses/LICENSE-2.0
-# 
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
-# </...@LICENSE>
 
 package Mail::SpamAssassin::Plugin::DomainKeys;
 

Modified: spamassassin/trunk/lib/Mail/SpamAssassin/Plugin/Hashcash.pm
URL: http://svn.apache.org/viewcvs/spamassassin/trunk/lib/Mail/SpamAssassin/Plugin/Hashcash.pm?view=diff&r1=149176&r2=149177
==============================================================================
--- spamassassin/trunk/lib/Mail/SpamAssassin/Plugin/Hashcash.pm (original)
+++ spamassassin/trunk/lib/Mail/SpamAssassin/Plugin/Hashcash.pm Sun Jan 30 14:56:06 2005
@@ -1,28 +1,34 @@
-=head1 NAME
-
-Mail::SpamAssassin::Plugin::Hashcash - perform hashcash verification tests
-
-=head1 SYNOPSIS
-
-  loadplugin     Mail::SpamAssassin::Plugin::Hashcash
-
-=cut
-
 # <@LICENSE>
 # Copyright 2004 Apache Software Foundation
-#
+# 
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
 # You may obtain a copy of the License at
-#
+# 
 #     http://www.apache.org/licenses/LICENSE-2.0
-#
+# 
 # Unless required by applicable law or agreed to in writing, software
 # distributed under the License is distributed on an "AS IS" BASIS,
 # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 # See the License for the specific language governing permissions and
 # limitations under the License.
 # </...@LICENSE>
+
+=head1 NAME
+
+Mail::SpamAssassin::Plugin::Hashcash - perform hashcash verification tests
+
+=head1 SYNOPSIS
+
+  loadplugin     Mail::SpamAssassin::Plugin::Hashcash
+
+=head1 DESCRIPTION
+
+Hashcash is a payment system for email where CPU cycles used as the
+basis for an e-cash system.  This plugin makes it possible to use valid
+hashcash tokens added by mail programs as a bonus for messages.
+
+=cut
 
 =over 4
 

Modified: spamassassin/trunk/lib/Mail/SpamAssassin/Plugin/MSExec.pm
URL: http://svn.apache.org/viewcvs/spamassassin/trunk/lib/Mail/SpamAssassin/Plugin/MSExec.pm?view=diff&r1=149176&r2=149177
==============================================================================
--- spamassassin/trunk/lib/Mail/SpamAssassin/Plugin/MSExec.pm (original)
+++ spamassassin/trunk/lib/Mail/SpamAssassin/Plugin/MSExec.pm Sun Jan 30 14:56:06 2005
@@ -1,7 +1,30 @@
+# <@LICENSE>
+# Copyright 2004 Apache Software Foundation
+# 
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+# 
+#     http://www.apache.org/licenses/LICENSE-2.0
+# 
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+# </...@LICENSE>
+
 =head1 NAME
 
 MSExec - determine if the message includes a Microsoft executable file
 
+=head1 SYNOPSIS
+
+  loadplugin     Mail::SpamAssassin::Plugin::MSExec
+  body           MICROSOFT_EXECUTABLE eval:check_microsoft_executable()
+
+=head1 DESCRIPTION
+
 This rule works by checking for 3 possibilities in the message in any
 application/* or text/* part in the message:
 
@@ -14,11 +37,6 @@
 =item - in application parts, look for a base64 encoded executable start string
 
 =back
-
-=head1 SYNOPSIS
-
-  loadplugin     Mail::SpamAssassin::Plugin::MSExec
-  body           MICROSOFT_EXECUTABLE eval:check_microsoft_executable()
 
 =cut
 

Modified: spamassassin/trunk/lib/Mail/SpamAssassin/Plugin/NetCache.pm
URL: http://svn.apache.org/viewcvs/spamassassin/trunk/lib/Mail/SpamAssassin/Plugin/NetCache.pm?view=diff&r1=149176&r2=149177
==============================================================================
--- spamassassin/trunk/lib/Mail/SpamAssassin/Plugin/NetCache.pm (original)
+++ spamassassin/trunk/lib/Mail/SpamAssassin/Plugin/NetCache.pm Sun Jan 30 14:56:06 2005
@@ -1,18 +1,43 @@
-=head1 
+# <@LICENSE>
+# Copyright 2004 Apache Software Foundation
+# 
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+# 
+#     http://www.apache.org/licenses/LICENSE-2.0
+# 
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+# </...@LICENSE>
 
-To try this out, write these lines to /etc/mail/spamassassin/plugintest.cf:
+=head1 NAME
+
+Mail::SpamAssassin::Plugin::NetCache - store network check results in headers
+
+=head1 SYNOPSIS
 
   loadplugin     Mail::SpamAssassin::Plugin::NetCache
 
-=cut
+=head1 DESCRIPTION
+
+This is a work-in-progress experimental plugin not for general use.
 
-## This is a plugin to store network check results in the message header
-## the idea is that we store all results (positive and negative) in the
-## headers, then during mass-check we pull the results out and use them for
-## "live" data to give better results during score generation.
-##
-## Definitely still a WOP.  Needs more plugin hooks as appropriate, needs code
-## to put results in header and to pull results back out from said headers, etc.
+This plugin stores network check results in the message header.  The
+idea is to store all results (positive and negative) in the headers,
+then during mass-check, pull the results out and use them for "live"
+data to give better results during SpamAssassin score generation.
+
+This needs more plugin hooks as appropriate, needs code to put results
+in header and to pull results back out from said headers, etc.
+
+To try this plugin, write the above two lines in the synopsis to
+C</etc/mail/spamassassin/plugintest.cf>.
+
+=cut
 
 package Mail::SpamAssassin::Plugin::NetCache;
 

Modified: spamassassin/trunk/lib/Mail/SpamAssassin/Plugin/Pyzor.pm
URL: http://svn.apache.org/viewcvs/spamassassin/trunk/lib/Mail/SpamAssassin/Plugin/Pyzor.pm?view=diff&r1=149176&r2=149177
==============================================================================
--- spamassassin/trunk/lib/Mail/SpamAssassin/Plugin/Pyzor.pm (original)
+++ spamassassin/trunk/lib/Mail/SpamAssassin/Plugin/Pyzor.pm Sun Jan 30 14:56:06 2005
@@ -1,20 +1,3 @@
-=head1 NAME
-
-Mail::SpamAssassin::Plugin::Pyzor - perform Pyzor check of messages
-
-Pyzor is a collaborative, networked system to detect and block spam
-using identifying digests of messages.
-
-See http://pyzor.sourceforge.net/ for more information about Pyzor.
-
-=head1 SYNOPSIS
-
-  loadplugin     Mail::SpamAssassin::Plugin::Pyzor
-
-=over 4
-
-=cut
-
 # <@LICENSE>
 # Copyright 2004 Apache Software Foundation
 #
@@ -30,6 +13,25 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 # </...@LICENSE>
+
+=head1 NAME
+
+Mail::SpamAssassin::Plugin::Pyzor - perform Pyzor check of messages
+
+=head1 SYNOPSIS
+
+  loadplugin     Mail::SpamAssassin::Plugin::Pyzor
+
+=head1 DESCRIPTION
+
+Pyzor is a collaborative, networked system to detect and block spam
+using identifying digests of messages.
+
+See http://pyzor.sourceforge.net/ for more information about Pyzor.
+
+=over 4
+
+=cut
 
 package Mail::SpamAssassin::Plugin::Pyzor;
 

Modified: spamassassin/trunk/lib/Mail/SpamAssassin/Plugin/Razor2.pm
URL: http://svn.apache.org/viewcvs/spamassassin/trunk/lib/Mail/SpamAssassin/Plugin/Razor2.pm?view=diff&r1=149176&r2=149177
==============================================================================
--- spamassassin/trunk/lib/Mail/SpamAssassin/Plugin/Razor2.pm (original)
+++ spamassassin/trunk/lib/Mail/SpamAssassin/Plugin/Razor2.pm Sun Jan 30 14:56:06 2005
@@ -1,22 +1,3 @@
-=head1 NAME
-
-Mail::SpamAssassin::Plugin::Razor2 - perform Razor check of messages
-
-Vipul's Razor is a distributed, collaborative, spam detection and
-filtering network based on user submissions of spam.  Detection is done
-with signatures that efficiently spot mutating spam content and user
-input is validated through reputation assignments.
-
-See http://razor.sourceforge.net/ for more information about Razor.
-
-=head1 SYNOPSIS
-
-  loadplugin     Mail::SpamAssassin::Plugin::Razor2
-
-=over 4
-
-=cut
-
 # <@LICENSE>
 # Copyright 2004 Apache Software Foundation
 #
@@ -32,6 +13,27 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 # </...@LICENSE>
+
+=head1 NAME
+
+Mail::SpamAssassin::Plugin::Razor2 - perform Razor check of messages
+
+=head1 SYNOPSIS
+
+  loadplugin     Mail::SpamAssassin::Plugin::Razor2
+
+=head1 DESCRIPTION
+
+Vipul's Razor is a distributed, collaborative, spam detection and
+filtering network based on user submissions of spam.  Detection is done
+with signatures that efficiently spot mutating spam content and user
+input is validated through reputation assignments.
+
+See http://razor.sourceforge.net/ for more information about Razor.
+
+=over 4
+
+=cut
 
 package Mail::SpamAssassin::Plugin::Razor2;
 

Modified: spamassassin/trunk/lib/Mail/SpamAssassin/Plugin/RelayCountry.pm
URL: http://svn.apache.org/viewcvs/spamassassin/trunk/lib/Mail/SpamAssassin/Plugin/RelayCountry.pm?view=diff&r1=149176&r2=149177
==============================================================================
--- spamassassin/trunk/lib/Mail/SpamAssassin/Plugin/RelayCountry.pm (original)
+++ spamassassin/trunk/lib/Mail/SpamAssassin/Plugin/RelayCountry.pm Sun Jan 30 14:56:06 2005
@@ -1,3 +1,19 @@
+# <@LICENSE>
+# Copyright 2004 Apache Software Foundation
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+# </...@LICENSE>
+
 =head1 NAME
 
 RelayCountry - add message metadata indicating the country code of each relay
@@ -5,6 +21,12 @@
 =head1 SYNOPSIS
 
   loadplugin     Mail::SpamAssassin::Plugin::RelayCountry
+
+=head1 DESCRIPTION
+
+By the RelayCountry plugin attempts to determine the domain country
+codes of each relay used in the delivery path of messages and add that
+information to the message metadata as "X-Relay-Countries".
 
 =head1 REQUIREMENT
 

Modified: spamassassin/trunk/lib/Mail/SpamAssassin/Plugin/SPF.pm
URL: http://svn.apache.org/viewcvs/spamassassin/trunk/lib/Mail/SpamAssassin/Plugin/SPF.pm?view=diff&r1=149176&r2=149177
==============================================================================
--- spamassassin/trunk/lib/Mail/SpamAssassin/Plugin/SPF.pm (original)
+++ spamassassin/trunk/lib/Mail/SpamAssassin/Plugin/SPF.pm Sun Jan 30 14:56:06 2005
@@ -1,16 +1,3 @@
-=head1 NAME
-
-Mail::SpamAssassin::Plugin::SPF - perform SPF verification tests
-
-This plugin checks a message against Sender Policy Framework (SPF)
-records published by the domain owners in DNS to fight email address
-forgery and make it easier to identify spams.
-
-=head1 SYNOPSIS
-
-  loadplugin     Mail::SpamAssassin::Plugin::SPF
-  
-=cut
 # <@LICENSE>
 # Copyright 2004 Apache Software Foundation
 # 
@@ -26,6 +13,22 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 # </...@LICENSE>
+
+=head1 NAME
+
+Mail::SpamAssassin::Plugin::SPF - perform SPF verification tests
+
+=head1 SYNOPSIS
+
+  loadplugin     Mail::SpamAssassin::Plugin::SPF
+
+=head1 DESCRIPTION
+
+This plugin checks a message against Sender Policy Framework (SPF)
+records published by the domain owners in DNS to fight email address
+forgery and make it easier to identify spams.
+
+=cut
 
 package Mail::SpamAssassin::Plugin::SPF;
 

Modified: spamassassin/trunk/lib/Mail/SpamAssassin/Plugin/SpamCop.pm
URL: http://svn.apache.org/viewcvs/spamassassin/trunk/lib/Mail/SpamAssassin/Plugin/SpamCop.pm?view=diff&r1=149176&r2=149177
==============================================================================
--- spamassassin/trunk/lib/Mail/SpamAssassin/Plugin/SpamCop.pm (original)
+++ spamassassin/trunk/lib/Mail/SpamAssassin/Plugin/SpamCop.pm Sun Jan 30 14:56:06 2005
@@ -1,23 +1,3 @@
-=head1 NAME
-
-Mail::SpamAssassin::Plugin::SpamCop - perform SpamCop reporting of messages
-
-SpamCop is a service for reporting spam.  SpamCop determines the origin
-of unwanted email and reports it to the relevant Internet service
-providers.  By reporting spam, you have a positive impact on the
-problem.  Reporting unsolicited email also helps feed spam filtering
-systems, including, but not limited to, SpamCop's own service.
-
-See http://www.spamcop.net/ for more information about SpamCop.
-
-=head1 SYNOPSIS
-
-  loadplugin     Mail::SpamAssassin::Plugin::SpamCop
-
-=over 4
-
-=cut
-
 # <@LICENSE>
 # Copyright 2004 Apache Software Foundation
 #
@@ -33,6 +13,29 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 # </...@LICENSE>
+
+=head1 NAME
+
+Mail::SpamAssassin::Plugin::SpamCop - perform SpamCop reporting of messages
+
+=head1 SYNOPSIS
+
+  loadplugin     Mail::SpamAssassin::Plugin::SpamCop
+
+=head1 DESCRIPTION
+
+SpamCop is a service for reporting spam.  SpamCop determines the origin
+of unwanted email and reports it to the relevant Internet service
+providers.  By reporting spam, you have a positive impact on the
+problem.  Reporting unsolicited email also helps feed spam filtering
+systems, including, but not limited to, the SpamCop blacklist used in
+SpamAssassin as a DNSBL.
+
+See http://www.spamcop.net/ for more information about SpamCop.
+
+=over 4
+
+=cut
 
 package Mail::SpamAssassin::Plugin::SpamCop;
 

Modified: spamassassin/trunk/lib/Mail/SpamAssassin/Plugin/Test.pm
URL: http://svn.apache.org/viewcvs/spamassassin/trunk/lib/Mail/SpamAssassin/Plugin/Test.pm?view=diff&r1=149176&r2=149177
==============================================================================
--- spamassassin/trunk/lib/Mail/SpamAssassin/Plugin/Test.pm (original)
+++ spamassassin/trunk/lib/Mail/SpamAssassin/Plugin/Test.pm Sun Jan 30 14:56:06 2005
@@ -1,9 +1,32 @@
-=head1 
+# <@LICENSE>
+# Copyright 2004 Apache Software Foundation
+# 
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+# 
+#     http://www.apache.org/licenses/LICENSE-2.0
+# 
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+# </...@LICENSE>
 
-To try this out, write these lines to /etc/mail/spamassassin/plugintest.cf:
+=head1 NAME
+
+Test - test plugin
+
+=head1 SYNOPSIS
 
   loadplugin     Mail::SpamAssassin::Plugin::Test
   header         MY_TEST_PLUGIN eval:check_test_plugin()
+
+=head1 DESCRIPTION
+
+To try this plugin, write the above two lines in the synopsis to
+C</etc/mail/spamassassin/plugintest.cf>.
 
 =cut
 

Modified: spamassassin/trunk/lib/Mail/SpamAssassin/Plugin/URIDNSBL.pm
URL: http://svn.apache.org/viewcvs/spamassassin/trunk/lib/Mail/SpamAssassin/Plugin/URIDNSBL.pm?view=diff&r1=149176&r2=149177
==============================================================================
--- spamassassin/trunk/lib/Mail/SpamAssassin/Plugin/URIDNSBL.pm (original)
+++ spamassassin/trunk/lib/Mail/SpamAssassin/Plugin/URIDNSBL.pm Sun Jan 30 14:56:06 2005
@@ -1,16 +1,34 @@
+# <@LICENSE>
+# Copyright 2004 Apache Software Foundation
+# 
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+# 
+#     http://www.apache.org/licenses/LICENSE-2.0
+# 
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+# </...@LICENSE>
+
 =head1 NAME
 
 URIDNSBL - look up URLs against DNS blocklists
 
-This works by analysing message text and HTML for URLs, extracting the
-domain names from those, querying their NS records in DNS, resolving
-the hostnames used therein, and querying various DNS blocklists for
-those IP addresses.  This is quite effective.
-
 =head1 SYNOPSIS
 
   loadplugin    Mail::SpamAssassin::Plugin::URIDNSBL
   uridnsbl	URIBL_SBLXBL    sbl-xbl.spamhaus.org.   TXT
+
+=head1 DESCRIPTION
+
+This works by analysing message text and HTML for URLs, extracting the
+domain names from those, querying their NS records in DNS, resolving
+the hostnames used therein, and querying various DNS blocklists for
+those IP addresses.  This is quite effective.
 
 =head1 CONFIGURATION