[php-blog-cvs] serendipity/bundled-libs/Net/DNSBL SURBL.php,1.1,1.2

[Sebastian N. <no...@us...>]

Update of /cvsroot/php-blog/serendipity/bundled-libs/Net/DNSBL
In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv8545/bundled-libs/Net/DNSBL

Modified Files:
	SURBL.php 
Log Message:
MFH

Index: SURBL.php
===================================================================
RCS file: /cvsroot/php-blog/serendipity/bundled-libs/Net/DNSBL/SURBL.php,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -d -r1.1 -r1.2
--- SURBL.php	21 Nov 2004 15:32:06 -0000	1.1
+++ SURBL.php	22 Nov 2004 08:12:52 -0000	1.2
@@ -29,7 +29,7 @@
  * @author  Sebastian Nohn <seb...@no...>
  * @package Net_DNSBL
  * @license http://www.php.net/license/3_0.txt
- * @version 0.2
+ * @version 0.3
  */
 require_once 'Cache.php';
 require_once 'HTTP/Request.php';
@@ -39,19 +39,34 @@
 class Net_DNSBL_SURBL extends Net_DNSBL {
 
     /**     
+     * Array of blacklists.
+     *
+     * Contain 1-n blacklists to use for checking the status of a
+     * host.
+     *
      * @var    string[]
      * @access protected
      */
     var $blacklists = array('multi.surbl.org');
 
     /**
+     * File containing whitelisted hosts
+     *
+     * There are some whitelisted hosts (co.uk for example). This
+     * requires the package to not ask the domain name but the host
+     * name (spammer.co.uk instead of co.uk).
+     * 
      * @var    string
+     * @see    $twoLevelCcTld
      * @access protected
      */
     var $doubleCcTldFile = 'http://spamcheck.freeapp.net/two-level-tlds';
 
     /**
+     * Array of whitelisted hosts
+     *
      * @var    array
+     * @see    $twoLevelCcTldFile
      * @access private
      */
     var $twoLevelCcTld = array();
@@ -59,8 +74,9 @@
     /**
      * Check if the last two parts of the FQDN are whitelisted
      *
-     * @param  $fqdn
+     * @param  string Host to check if it is whitelisted
      * @access protected
+     * @return boolean True if the host is whitelisted
      */
     function isDoubleCcTld($fqdn) {
         // 30 Day should be way enough
@@ -100,8 +116,9 @@
      * (3b2) IS_NOT_2LEVEL: we want the last two names
      * (4) return the FQDN to query
      *
-     * @param  string $uri
+     * @param  string URL to check. 
      * @access protected
+     * @return string Host to lookup
      */
     function getHostForLookup($uri, $blacklist) {
         $host       = '';