Add file level phpdoc to external libraries we use. Fixes #5443 props darkdragon.

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

wp-includes/atomlib.php

@@ -1,26 +1,67 @@
 <?php
 /*
- * atomlib.php - Atom Syndication Format PHP Library
+ * Atom Syndication Format PHP Library
  *
- * Project: http://code.google.com/p/phpatomlib/
- *
- * Author: Elias Torres <elias@torrez.us>
- * Version: 0.4
+ * @package AtomLib
+ * @link http://code.google.com/p/phpatomlib/
  *
+ * @author: Elias Torres <elias@torrez.us>
+ * @version: 0.4
+ * @since 2.3
  */
 
+/**
+ * Structure that store common Atom Feed Properties
+ *
+ * @package AtomLib
+ */
 class AtomFeed {
+	/**
+	 * Stores Links
+	 * @var array
+	 * @access public
+	 */
     var $links = array();
+    /**
+     * Stores Categories
+     * @var array
+     * @access public
+     */
     var $categories = array();
-
+	/**
+	 * Stores Entries
+	 *
+	 * @var array
+	 * @access public
+	 */
     var $entries = array();
 }
 
+/**
+ * Structure that store Atom Entry Properties
+ *
+ * @package AtomLib
+ */
 class AtomEntry {
+	/**
+	 * Stores Links
+	 * @var array
+	 * @access public
+	 */
     var $links = array();
+    /**
+     * Stores Categories
+     * @var array
+	 * @access public
+     */
     var $categories = array();
 }
 
+/**
+ * AtomLib Atom Parser API
+ *
+ * @package AtomLib
+ */
 class AtomParser {
 
     var $NS = 'http://www.w3.org/2005/Atom';

wp-includes/class-IXR.php

@@ -1,11 +1,17 @@
 <?php
-/*
-   IXR - The Inutio XML-RPC Library - (c) Incutio Ltd 2002-2005
-   Version 1.7 (beta) - Simon Willison, 23rd May 2005
-   Site:   http://scripts.incutio.com/xmlrpc/
-   Manual: http://scripts.incutio.com/xmlrpc/manual.php
-   Made available under the BSD License: http://www.opensource.org/licenses/bsd-license.php
-*/
+/**
+ * IXR - The Inutio XML-RPC Library
+ *
+ * @package IXR
+ * @since 1.5
+ *
+ * @copyright Incutio Ltd 2002-2005
+ * @version 1.7 (beta) 23rd May 2005
+ * @author Simon Willison
+ * @link http://scripts.incutio.com/xmlrpc/ Site
+ * @link http://scripts.incutio.com/xmlrpc/manual.php Manual
+ * @license BSD License http://www.opensource.org/licenses/bsd-license.php
+ */
 
 class IXR_Value {
     var $data;

wp-includes/class-phpass.php

@@ -1,4 +1,12 @@
 <?php
+/**
+ * Portable PHP password hashing framework.
+ * @package phpass
+ * @since 2.4
+ * @version 0.1
+ * @link http://www.openwall.com/phpass/
+ */
+
 #
 # Portable PHP password hashing framework.
 #

wp-includes/class-pop3.php

@@ -1,11 +1,12 @@
 <?php
-
-   /**
+/**
  * mail_fetch/setup.php
  *
-    * Copyright (c) 1999-2006 The SquirrelMail Project Team
+ * @package SquirrelMail
  *
-    * Copyright (c) 1999 CDI (cdi@thewebmasters.net) All Rights Reserved
+ * @copyright (c) 1999-2006 The SquirrelMail Project Team
+ *
+ * @copyright (c) 1999 CDI (cdi@thewebmasters.net) All Rights Reserved
  * Modified by Philippe Mingo 2001 mingo@rotedic.com
  * An RFC 1939 compliant wrapper class for the POP3 protocol.
  *

wp-includes/class-snoopy.php

@@ -1,5 +1,13 @@
 <?php
-
+/**
+ * Snoopy - the PHP net client
+ * @author Monte Ohrt <monte@ispi.net>
+ * @copyright 1999-2000 ispi, all rights reserved
+ * @version 1.01
+ * @license GNU Lesser GPL
+ * @link http://snoopy.sourceforge.net/
+ * @package Snoopy
+ */
 /*************************************************
 
 Snoopy - the PHP net client