Updated phpdoc for external libs. See #7038 props jacobsantos.

git-svn-id: http://svn.automattic.com/wordpress/trunk@8082 1a063a9b-81f0-0310-95a4-ce76da25c4cd

wp-includes/class-phpass.php

@@ -7,20 +7,12 @@
  * @link http://www.openwall.com/phpass/
  */
 
-#
-# Portable PHP password hashing framework.
-#
-# Version 0.1 / genuine.
 #
 # Written by Solar Designer <solar at openwall.com> in 2004-2006 and placed in
 # the public domain.
 #
 # There's absolutely no warranty.
 #
-# The homepage URL for this framework is:
-#
-#	http://www.openwall.com/phpass/
-#
 # Please be sure to update the Version line if you edit this file in any way.
 # It is suggested that you leave the main version number intact, but indicate
 # your project name (after the slash) and add your own revision information.
@@ -32,6 +24,15 @@
 # Obviously, since this code is in the public domain, the above are not
 # requirements (there can be none), but merely suggestions.
 #
+
+/**
+ * Portable PHP password hashing framework.
+ *
+ * @package phpass
+ * @version 0.1 / genuine
+ * @link http://www.openwall.com/phpass/
+ * @since 2.5
+ */
 class PasswordHash {
 	var $itoa64;
 	var $iteration_count_log2;

wp-includes/class-phpmailer.php

@@ -1,15 +1,14 @@
 <?php
-////////////////////////////////////////////////////
+/**
-// PHPMailer - PHP email class
+ * PHPMailer - PHP email class
-//
+ *
-// Class for sending email using either
+ * Class for sending email using either sendmail, PHP mail(), or SMTP. Methods
-// sendmail, PHP mail(), or SMTP.  Methods are
+ * are based upon the standard AspEmail(tm) classes.
-// based upon the standard AspEmail(tm) classes.
+ *
-//
+ * @copyright 2001 - 2003 Brent R. Matzelle
-// Copyright (C) 2001 - 2003  Brent R. Matzelle
+ * @license LGPL
-//
+ * @package PHPMailer
-// License: LGPL, see LICENSE
+ */
-////////////////////////////////////////////////////
 
 /**
  * PHPMailer - PHP email transport class

wp-includes/class-pop3.php

@@ -17,6 +17,11 @@
  * $Id$
  */
 
+/**
+ * POP3
+ *
+ * @package SquirrelMail
+ */
 class POP3 {
     var $ERROR      = '';       //  Error string.
 

wp-includes/class-smtp.php

@@ -1,23 +1,23 @@
 <?php
-////////////////////////////////////////////////////
+/**
-// SMTP - PHP SMTP class
+ * SMTP - PHP SMTP class
-//
+ *
-// Version 1.02
+ * Define an SMTP class that can be used to connect and communicate with any
-//
+ * SMTP server. It implements all the SMTP functions defined in RFC821 except
-// Define an SMTP class that can be used to connect
+ * TURN.
-// and communicate with any SMTP server. It implements
+ *
-// all the SMTP functions defined in RFC821 except TURN.
+ * @version 1.02
-//
+ * @author Chris Ryan
-// Author: Chris Ryan
+ * @license LGPL
-//
+ * @package PHPMailer
-// License: LGPL, see LICENSE
+ */
-////////////////////////////////////////////////////
 
 /**
  * SMTP is rfc 821 compliant and implements all the rfc 821 SMTP
  * commands except TURN which will always return a not implemented
  * error. SMTP also provides some utility methods for sending mail
  * to an SMTP server.
+ *
  * @package PHPMailer
  * @author Chris Ryan
  */

wp-includes/class-snoopy.php

@@ -8,13 +8,15 @@
  * @link http://snoopy.sourceforge.net/
  * @package Snoopy
  */
-/*************************************************
-
-Snoopy - the PHP net client
-Author: Monte Ohrt <monte@ispi.net>
-Copyright (c): 1999-2000 ispi, all rights reserved
-Version: 1.01
 
+if ( !in_array('Snoopy', get_declared_classes() ) ) :
+/**
+ * Snoopy - the PHP net client
+ *
+ * @author Monte Ohrt <monte@ispi.net>
+ * @copyright (c): 1999-2000 ispi, all rights reserved
+ * @version 1.01
+ *
  * This library is free software; you can redistribute it and/or
  * modify it under the terms of the GNU Lesser General Public
  * License as published by the Free Software Foundation; either
@@ -28,22 +30,19 @@ Version: 1.01
  * You should have received a copy of the GNU Lesser General Public
  * License along with this library; if not, write to the Free Software
  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
-
+ *
-You may contact the author of Snoopy by e-mail at:
+ * You may contact the author of Snoopy by e-mail at:
-monte@ispi.net
+ * monte@ispi.net
-
+ *
-Or, write to:
+ * Or, write to:
-Monte Ohrt
+ * Monte Ohrt
-CTO, ispi
+ * CTO, ispi
-237 S. 70th suite 220
+ * 237 S. 70th suite 220
-Lincoln, NE 68510
+ * Lincoln, NE 68510
-
+ *
-The latest version of Snoopy can be obtained from:
+ * @link http://snoopy.sourceforge.net/ The latest version of Snoopy can be
-http://snoopy.sourceforge.net/
+ *		obtained
-
+ */
-*************************************************/
-
-if ( !in_array('Snoopy', get_declared_classes() ) ) :
 class Snoopy
 {
 	/**** Public variables ****/