Minor - Adapting code comments to phpdoc

main/inc/lib/classmanager.lib.php

@@ -11,13 +11,13 @@ require_once (api_get_path(LIBRARY_PATH).'course.lib.php');
 /**
  * This library contains some functions for class-management.
  * @author Bart Mollet
- * @package dokeos.library
+ * @package chamilo.library
  */
 class ClassManager
 {
 	/**
 	 * Get class information
-	 * @note This function can't be named get_class() because that's a standard
+	 * note: This function can't be named get_class() because that's a standard
 	 * php-function.
 	 */
 	function get_class_info($class_id)

main/inc/lib/database.lib.php

@@ -629,9 +629,9 @@ class Database {
 
     /**
      * Gets the ID of the last item inserted into the database
+     * This should be updated to use ADODB at some point
      * @param resource $connection (optional)	The database server connection, for detailed description see the method query().
      * @return int								The last ID as returned by the DB function
-     * @comment This should be updated to use ADODB at some point
      */
     public static function insert_id($connection = null) {
         return self::use_default_connection($connection) ? mysql_insert_id() : mysql_insert_id($connection);
@@ -653,7 +653,7 @@ class Database {
      * @param	resource	The database resource to get data from
      * @param	integer		The row number
      * @param	string		Optional field name or number
-     * @result	mixed		One cell of the result, or FALSE on error
+     * @return	mixed		One cell of the result, or FALSE on error
      */
     public static function result($resource, $row, $field = '') {
         return self::num_rows($resource) > 0 ? (!empty($field) ? mysql_result($resource, $row, $field) : mysql_result($resource, $row)) : null;

main/inc/lib/getid3/module.audio-video.flv.php

@@ -38,11 +38,14 @@
 // +----------------------------------------------------------------------+
 //
 // $Id: module.audio-video.flv.php,v 1.7 2006/11/10 11:20:12 ah Exp $
-
-
-
-class getid3_flv extends getid3_handler
-{
+/**
+ * @package chamilo.include.flv
+ */
+/**
+ * Class
+ * @package chamilo.include.flv
+ */
+class getid3_flv extends getid3_handler {
 
     const TAG_AUDIO    =  8;
     const TAG_VIDEO    =  9;
@@ -571,4 +574,4 @@ class AMFReader
 	}
 }
 
-?>
+?>

main/inc/lib/search/DokeosQuery.php

@@ -1,6 +1,6 @@
 <?php
 /* For licensing terms, see /dokeos_license.txt */
-/*
+/**
  * Script defining generic functions against a search engine api. Just only if one day the search engine changes
  * @package chamilo.include.search
  */

main/inc/lib/search/get_terms.php

@@ -1,9 +1,12 @@
 <?php
-
+/* For licensing terms, see /dokeos_license.txt */
 /**
- * @file
  * This script retrieves a list of terms that have xapian documents
  * related with the term passed
+ * @package chamilo.include.search
+ */
+/**
+ * Code
  */
 $terms_list = array();