Minor - Adapting code comments to phpdoc

main/calendar/agenda.inc.php

@@ -1,13 +1,14 @@
 <?php
 /* For licensing terms, see /license.txt */
-
 /**
-    @author: Julio Montoya <gugli100@gmail.com> BeezNest 2011  - Lots of fixes - UI improvements, security fixes,
-	@author: Patrick Cool, patrick.cool@UGent.be
-	@todo this code should be clean as well as the myagenda.inc.php - jmontoya
-
+ *    @author: Julio Montoya <gugli100@gmail.com> BeezNest 2011  - Lots of fixes - UI improvements, security fixes,
+ *	@author: Patrick Cool, patrick.cool@UGent.be
+ *	@todo this code should be clean as well as the myagenda.inc.php - jmontoya
+ * @package chamilo.calendar
 */
-
+/**
+ * Code
+ */
 // the variables for the days and the months
 // Defining the shorts for the days
 $DaysShort = api_get_week_days_short();
@@ -4535,4 +4536,4 @@ function display_ical_import_form() {
 				</div>
 			</div>';
 	echo '</form>';
-}
+}

main/calendar/agenda.php

@@ -1,7 +1,11 @@
 <?php
 /* For licensing terms, see /license.txt */
-
-/*	   INIT SECTION	*/
+/**
+ * @package chamilo.calendar
+ */
+/**
+ * INIT SECTION
+ */
 
 // name of the language file that needs to be included
 $language_file = array('agenda','group');
@@ -365,4 +369,4 @@ echo '</td></tr></table>';
 // The footer is displayed only if we are not in the learnpath
 if ($_GET['origin'] != 'learnpath') {
 	Display::display_footer();
-}
+}

main/exercice/GC.php

@@ -1,27 +1,21 @@
 <?php
 /* For licensing terms, see /license.txt */
 /**
-*	Code library for HotPotatoes integration.
-*	@package chamilo.exercise
-* 	@author Istvan Mandak
-* 	@version $Id: GC.php 20451 2009-05-10 12:02:22Z ivantcholakov $
-*/
+ *	Code library for HotPotatoes integration.
+ *	@package chamilo.exercise
+ * 	@author Istvan Mandak
+ * 	@version $Id: GC.php 20451 2009-05-10 12:02:22Z ivantcholakov $
+ */
 /**
  * Code
  */
-
 // usage:  HotPotGC($_configuration['root_sys'],$flag);
 // working recursively, flag[0,1] print or delete the HotPotatoes temp files (.t.html)
 
 echo "Garbage Collector<BR>";
 HotPotGC($_configuration['root_sys'],1,1);
-
-
 /**
- * functions
- */
-/**
- * Garbage collector
+ * Garbage collector caller function
  */
 function HotPotGC($root_sys,$flag,$userID) {
 	// flag[0,1] - print or delete the HotPotatoes temp files (.t.html)
@@ -29,7 +23,9 @@ function HotPotGC($root_sys,$flag,$userID) {
 	require_once(api_get_path(LIBRARY_PATH)."fileManage.lib.php");
 	HotPotGCt($documentPath,$flag,$userID);
 }
-
+/**
+ * Garbage collector
+ */
 function HotPotGCt($folder,$flag,$userID) { // Garbage Collector
 	$filelist = array();
 	    if ($dir = @opendir($folder)) {

main/user/subscribe_user.php

@@ -1,16 +1,13 @@
 <?php
 /* For licensing terms, see /license.txt*/
-
 /**
-*	This script allows teachers to subscribe existing users
-*	to their course.
-*	@package chamilo.user
+* This script allows teachers to subscribe existing users
+* to their course.
+* @package chamilo.user
 */
 /**
  * Code
  */
-
-/*			INIT SECTION		*/
 // name of the language file that needs to be included
 $language_file = array('registration','admin');