From 9f535715a9f1b4e1ddbd08e717899419123625ac Mon Sep 17 00:00:00 2001
From: Yannick Warnier <yannick.warnier@beeznest.com>
Date: Sat, 23 Jul 2011 10:23:10 -0500
Subject: [PATCH] Minor - Adapting code comments to phpdoc

---
 main/exercice/GC.php                          | 107 ++++++++----------
 main/exercice/Hpdownload.php                  |   7 +-
 main/exercice/addlimits.php                   |   8 +-
 main/exercice/admin.php                       |   7 +-
 main/exercice/adminhp.php                     |  70 ++++++------
 main/exercice/exercice.php                    |   6 +-
 main/exercice/exercise.class.php              |   5 +-
 main/exercice/exercise.lib.php                |  33 +++---
 main/exercice/exercise_admin.php              |  17 +--
 main/exercice/exercise_history.php            |  13 ++-
 main/exercice/exercise_show.php               |   6 +-
 main/exercice/exercise_submit.php             |   6 +-
 main/exercice/exercise_submit_modal.php       |   5 +-
 main/exercice/export/exercise_import.php      |   9 +-
 main/exercice/export/qti/qti_export.php       |  20 ++--
 main/exercice/export/qti2/qti2_classes.php    |  38 +++++--
 main/exercice/export/qti2/qti2_export.php     |  29 ++---
 main/exercice/export/scorm/scorm_classes.php  |  21 ++--
 main/exercice/export/scorm/scorm_export.php   |  16 ++-
 main/exercice/feedback.php                    |   6 +-
 main/exercice/hotpotatoes.php                 |   8 +-
 main/exercice/hotspot.inc.php                 |   5 +-
 main/exercice/hotspot_actionscript.as.php     |   7 +-
 .../hotspot_actionscript_admin.as.php         |   8 +-
 main/exercice/hotspot_admin.inc.php           |  17 +--
 main/exercice/hotspot_answers.as.php          |  15 ++-
 main/exercice/hotspot_lang_conversion.php     |   8 +-
 main/exercice/hotspot_save.inc.php            |  13 ++-
 main/exercice/hotspot_savescore.inc.php       |  10 +-
 main/exercice/hotspot_updatescore.inc.php     |  25 ++--
 main/exercice/mark_free_answer.php            |  12 +-
 ...le_answer_combination_true_false.class.php |   9 +-
 main/exercice/qti2.php                        |   6 +-
 main/exercice/question.class.php              |   7 +-
 main/exercice/question_admin.inc.php          |   8 +-
 main/exercice/question_create.php             |  10 +-
 main/exercice/savescores.php                  |   7 +-
 main/exercice/showinframes.php                |  17 +--
 main/exercice/testheaderpage.php              |   7 +-
 main/exercice/upload_exercise.php             |   6 +-
 40 files changed, 344 insertions(+), 290 deletions(-)
 mode change 100644 => 100755 main/exercice/export/qti/qti_export.php
 mode change 100644 => 100755 main/exercice/export/scorm/scorm_export.php

diff --git a/main/exercice/GC.php b/main/exercice/GC.php
index 10685a718d..6e9ed9d7b3 100755
--- a/main/exercice/GC.php
+++ b/main/exercice/GC.php
@@ -1,84 +1,67 @@
 <?php
-/*
-    DOKEOS - elearning and course management software
-
-    For a full list of contributors, see documentation/credits.html
-
-    This program is free software; you can redistribute it and/or
-    modify it under the terms of the GNU General Public License
-    as published by the Free Software Foundation; either version 2
-    of the License, or (at your option) any later version.
-    See "documentation/licence.html" more details.
-
-    Contact:
-		Dokeos
-		Rue des Palais 44 Paleizenstraat
-		B-1030 Brussels - Belgium
-		Tel. +32 (2) 211 34 56
-*/
-
-
+/* For licensing terms, see /license.txt */
 /**
 *	Code library for HotPotatoes integration.
-*	@package dokeos.exercise
+*	@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)
 
-		// 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);
-
+echo "Garbage Collector<BR>";
+HotPotGC($_configuration['root_sys'],1,1);
 
-		// functions
 
-		function HotPotGC($root_sys,$flag,$userID)
-		{
-			// flag[0,1] - print or delete the HotPotatoes temp files (.t.html)
-			$documentPath = $root_sys."courses";
-			require_once(api_get_path(LIBRARY_PATH)."fileManage.lib.php");
-			HotPotGCt($documentPath,$flag,$userID);
-		}
+/**
+ * functions
+ */
+/**
+ * Garbage collector
+ */
+function HotPotGC($root_sys,$flag,$userID) {
+	// flag[0,1] - print or delete the HotPotatoes temp files (.t.html)
+	$documentPath = $root_sys."courses";
+	require_once(api_get_path(LIBRARY_PATH)."fileManage.lib.php");
+	HotPotGCt($documentPath,$flag,$userID);
+}
 
-		function HotPotGCt($folder,$flag,$userID)
-		{ // Garbage Collector
-			$filelist = array();
+function HotPotGCt($folder,$flag,$userID) { // Garbage Collector
+	$filelist = array();
 	    if ($dir = @opendir($folder)) {
         while (($file = readdir($dir)) !== false) {
             if ( $file != ".") {
             	if ($file != "..")
-      				{
+      		{
             	 $full_name = $folder."/".$file;
-        			  if (is_dir($full_name))
-									{
-										HotPotGCt($folder."/".$file,$flag);
-									}
-								else
-								 {
-                		$filelist[] = $file;
+        	  if (is_dir($full_name))
+							{
+								HotPotGCt($folder."/".$file,$flag);
+							}
+						else
+						 {
+                $filelist[] = $file;
                  }
                }
             }
         }
       	closedir($dir);
     	}
-			while (list ($key, $val) = each ($filelist))
-			{
-				 if (stristr($val,$userID.".t.html"))
-				 { if ($flag == 1)
-				 		{
-								my_delete($folder."/".$val);
-						}
-					 else
-					  {
-					  	echo $folder."/".$val."<br />";
-					  }
-				 }
-			}
-		}
-
-
-?>
+	while (list ($key, $val) = each ($filelist))
+	{
+		 if (stristr($val,$userID.".t.html"))
+		 { if ($flag == 1)
+		 		{
+						my_delete($folder."/".$val);
+				}
+			 else
+			  {
+			  	echo $folder."/".$val."<br />";
+			  }
+		 }
+	}
+}
diff --git a/main/exercice/Hpdownload.php b/main/exercice/Hpdownload.php
index 053a2b67bf..c645981b62 100755
--- a/main/exercice/Hpdownload.php
+++ b/main/exercice/Hpdownload.php
@@ -1,13 +1,14 @@
 <?php
 /* For licensing terms, see /license.txt */
-
 /**
 *	This script shows the list of exercises for administrators and students.
 *	@package chamilo.exercise
 * 	@author Istvan Mandak
 * 	@version $Id: Hpdownload.php 22201 2009-07-17 19:57:03Z cfasanando $
 */
-
+/**
+ * Code
+ */
 session_cache_limiter('public');
 
 require_once '../inc/global.inc.php';
@@ -149,4 +150,4 @@ if ($content_type == 'text/html') {
 $fp=fopen($full_file_name,'rb');
 fpassthru($fp);
 fclose($fp);
-?>
\ No newline at end of file
+?>
diff --git a/main/exercice/addlimits.php b/main/exercice/addlimits.php
index 740c23b466..eda1041e13 100755
--- a/main/exercice/addlimits.php
+++ b/main/exercice/addlimits.php
@@ -6,9 +6,9 @@
 * 	@author
 * 	@version $Id: admin.php 10680 2007-01-11 21:26:23Z pcool $
 */
-/*
-	including the global file
-*/
+/**
+ *	including the global file
+ */
 require_once '../inc/global.inc.php';
 
 /*
@@ -199,4 +199,4 @@ if (isset($_POST['ok'])) {
 		Database::query($query); 
 	}
 }
-?>
\ No newline at end of file
+?>
diff --git a/main/exercice/admin.php b/main/exercice/admin.php
index c6076e5386..a3a8846d95 100755
--- a/main/exercice/admin.php
+++ b/main/exercice/admin.php
@@ -1,6 +1,5 @@
 <?php
 /* For licensing terms, see /license.txt */
-
 /**
 *	Exercise administration
 * 	This script allows to manage (create, modify) an exercise and its questions
@@ -44,7 +43,9 @@
 *	@package chamilo.exercise
 * 	@author Olivier Brouckaert
 */
-
+/**
+ * Code
+ */
 require_once 'exercise.class.php';
 require_once 'question.class.php';
 require_once 'answer.class.php';
@@ -479,4 +480,4 @@ api_session_register('objExercise');
 api_session_register('objQuestion');
 api_session_register('objAnswer');
 
-Display::display_footer();
\ No newline at end of file
+Display::display_footer();
diff --git a/main/exercice/adminhp.php b/main/exercice/adminhp.php
index 15bc8a4979..558d596ec5 100755
--- a/main/exercice/adminhp.php
+++ b/main/exercice/adminhp.php
@@ -1,33 +1,28 @@
 <?php
 /* For licensing terms, see /license.txt */
-
 /**
 *	HotPotatoes administration.
 *	@package chamilo.exercise
 * 	@author Istvan Mandak
 * 	@version $Id: adminhp.php 20089 2009-04-24 21:12:54Z cvargas1 $
 */
-
-
-
-include('exercise.class.php');
-include('question.class.php');
-include('answer.class.php');
-
-include('exercise.lib.php');
-
+/**
+ * Code
+ */
+include 'exercise.class.php';
+include 'question.class.php';
+include 'answer.class.php';
+include 'exercise.lib.php';
 // name of the language file that needs to be included
 $language_file='exercice';
 
 include('../inc/global.inc.php');
 $this_section=SECTION_COURSES;
 
-if(isset($_REQUEST["cancel"]))
-{
-	if($_REQUEST["cancel"]==get_lang('Cancel'))
-	{
-				header("Location: exercice.php");
-	}
+if (isset($_REQUEST["cancel"])) {
+    if ($_REQUEST["cancel"]==get_lang('Cancel')) {
+        header("Location: exercice.php");
+    }
 }
 
 //$is_courseAdmin = $_SESSION['is_courseAdmin'];
@@ -66,20 +61,19 @@ $TBL_REPONSES				= Database::get_course_table(TABLE_QUIZ_ANSWER);
 $TBL_DOCUMENT				= Database::get_course_table(TABLE_DOCUMENT);
 $dbTable					= $TBL_DOCUMENT;
 
-if(!$is_allowedToEdit)
-{
-	api_not_allowed(true);
+if (!$is_allowedToEdit) {
+    api_not_allowed(true);
 }
 
-if (isset($_SESSION['gradebook'])){
-	$gradebook=	$_SESSION['gradebook'];
+if (isset($_SESSION['gradebook'])) {
+    $gradebook=	$_SESSION['gradebook'];
 }
 
 if (!empty($gradebook) && $gradebook=='view') {
-	$interbreadcrumb[]= array (
-			'url' => '../gradebook/'.$_SESSION['gradebook_dest'],
-			'name' => get_lang('ToolGradebook')
-		);
+    $interbreadcrumb[]= array (
+        'url' => '../gradebook/'.$_SESSION['gradebook_dest'],
+        'name' => get_lang('ToolGradebook')
+    );
 }
 
 $interbreadcrumb[]=array("url" => "exercice.php","name" => get_lang('Exercices'));
@@ -98,14 +92,12 @@ require_once(api_get_path(SYS_CODE_PATH).'/exercice/hotpotatoes.lib.php');
 </h4>
 
 <?php
-if(isset($newName))
-{
-		if($newName!="")
-		{
-			//alter database record for that test
-			SetComment($hotpotatoesName,$newName);
-			echo "<script language='Javascript' type='text/javascript'> window.location='exercice.php'; </script>";
-		}
+if (isset($newName)) {
+    if ($newName!="") {
+        //alter database record for that test
+        SetComment($hotpotatoesName,$newName);
+        echo "<script language='Javascript' type='text/javascript'> window.location='exercice.php'; </script>";
+    }
 }
 
 echo "<form action=\"".api_get_self()."\" method='post' name='form1'>";
@@ -115,10 +107,12 @@ echo "<input type=\"text\" name=\"newName\" value=\"";
 
 $lstrComment = "";
 $lstrComment = GetComment($hotpotatoesName);
-if($lstrComment=="")
-	$lstrComment = GetQuizName($hotpotatoesName,$documentPath);
-if($lstrComment=="")
-	$lstrComment = basename($hotpotatoesName,$documentPath);
+if ($lstrComment=="") {
+    $lstrComment = GetQuizName($hotpotatoesName,$documentPath);
+}
+if ($lstrComment=="") {
+    $lstrComment = basename($hotpotatoesName,$documentPath);
+}
 
 echo $lstrComment;
 echo "\" size=40>&nbsp;";
@@ -126,4 +120,4 @@ echo "<button type=\"submit\" class=\"save\" name=\"submit\" value=\"".get_lang(
 echo "<button type=\"button\" class=\"cancel\" name=\"cancel\" value=\"".get_lang('Cancel')."\" onclick=\"javascript:document.form1.newName.value='';\">".get_lang('Cancel')."</button>";
 echo "</form>";
 
-Display::display_footer();
\ No newline at end of file
+Display::display_footer();
diff --git a/main/exercice/exercice.php b/main/exercice/exercice.php
index 823775ad41..2ca8b10dff 100755
--- a/main/exercice/exercice.php
+++ b/main/exercice/exercice.php
@@ -8,7 +8,9 @@
 *	@author Wolfgang Schneider, code/html cleanup
 *	@author Julio Montoya <gugli100@gmail.com>, lots of cleanup + several improvements
 */
-
+/**
+ * Code
+ */
 // name of the language file that needs to be included
 $language_file = array('exercice','tracking');
 
@@ -1127,4 +1129,4 @@ if ($show == 'result') {
 
 if ($origin != 'learnpath') { //so we are not in learnpath tool
 	Display :: display_footer();
-}
\ No newline at end of file
+}
diff --git a/main/exercice/exercise.class.php b/main/exercice/exercise.class.php
index 29e74fdb21..7e81b17b53 100755
--- a/main/exercice/exercise.class.php
+++ b/main/exercice/exercise.class.php
@@ -1,6 +1,5 @@
 <?php
 /* For licensing terms, see /license.txt */
-
 /**
 *	Exercise class: This class allows to instantiate an object of type Exercise
 *	@package chamilo.exercise
@@ -8,7 +7,9 @@
 * 	@author Julio Montoya Cleaning exercises
 * 	@version $Id: exercise.class.php 22046 2009-07-14 01:45:19Z ivantcholakov $
 */
-
+/**
+ * Code
+ */
 define('ALL_ON_ONE_PAGE',                   1);
 define('ONE_PER_PAGE',                      2);
 //0=>Feedback , 1=>DirectFeedback, 2=>NoFeedback
diff --git a/main/exercice/exercise.lib.php b/main/exercice/exercise.lib.php
index 4b4c09f8e4..69c3cff5f5 100755
--- a/main/exercice/exercise.lib.php
+++ b/main/exercice/exercise.lib.php
@@ -1,16 +1,17 @@
 <?php
 /* For licensing terms, see /license.txt */
-
 /**
- *	Exercise library
- *  @todo convert this lib into a static class
+ * Exercise library
+ * @todo convert this lib into a static class
  *  
- * 	shows a question and its answers
- *	@package chamilo.exercise
- * 	@author Olivier Brouckaert <oli.brouckaert@skynet.be>
- * 	@version $Id: exercise.lib.php 22247 2009-07-20 15:57:25Z ivantcholakov $
+ * shows a question and its answers
+ * @package chamilo.exercise
+ * @author Olivier Brouckaert <oli.brouckaert@skynet.be>
+ * @version $Id: exercise.lib.php 22247 2009-07-20 15:57:25Z ivantcholakov $
+ */
+/**
+ * Code
  */
-
 // The initialization class for the online editor is needed here.
 require_once dirname(__FILE__).'/../inc/lib/fckeditor/fckeditor.php';
 
@@ -1187,7 +1188,7 @@ function show_score($score, $weight, $show_percentage = true, $use_platform_sett
 /**
  * Converts a numeric value in a percentage example 0.66666 to 66.67 %
  * @param $value
- * @return unknown_type
+ * @return float Converted number
  */
 function convert_to_percentage($value) {
     $return = '-';
@@ -1427,10 +1428,10 @@ function get_best_attempt_by_user($user_id, $exercise_id, $course_code, $session
 
 /**
  * Get average score (NO Exercises in LPs )
- * @param 	int		exercise id
+ * @param 	int	exercise id
  * @param 	string	course code
- * @param 	int		session id
- * @return 
+ * @param 	int	session id
+ * @return 	float	Average score
  */
 function get_average_score($exercise_id, $course_code, $session_id) { 
     $user_results = get_all_exercise_results($exercise_id, $course_code, $session_id);
@@ -1450,10 +1451,10 @@ function get_average_score($exercise_id, $course_code, $session_id) {
 
 /**
  * Get average score by score (NO Exercises in LPs )
- * @param 	int		exercise id
+ * @param 	int	exercise id
  * @param 	string	course code
- * @param 	int		session id
- * @return 
+ * @param 	int	session id
+ * @return 	float	Average score
  */
 function get_average_score_by_course($course_code, $session_id) { 
     $user_results = get_all_exercise_results_by_course($course_code, $session_id, false);        
@@ -1478,7 +1479,7 @@ function get_average_score_by_course($course_code, $session_id) {
  * @param 	int		exercise id
  * @param 	string	course code
  * @param 	int		session id
- * @return 
+ * @return	float	Best average score
  */
 function get_best_average_score_by_exercise($exercise_id, $course_code, $session_id, $user_count) { 
     $user_results = get_best_exercise_results_by_user($exercise_id, $course_code, $session_id);
diff --git a/main/exercice/exercise_admin.php b/main/exercice/exercise_admin.php
index 5b423699a0..922775a5bd 100755
--- a/main/exercice/exercise_admin.php
+++ b/main/exercice/exercise_admin.php
@@ -1,14 +1,15 @@
 <?php
 /* For licensing terms, see /license.txt */
-
 /**
-*	Exercise administration
-*	This script allows to manage an exercise. It is included from the script admin.php
-*	@package chamilo.exercise
-* 	@author Olivier Brouckaert
-* 	@version $Id$
+* Exercise administration
+* This script allows to manage an exercise. It is included from 
+* the script admin.php
+* @package chamilo.exercise
+* @author Olivier Brouckaert
 */
-
+/**
+ * Code
+ */
 // name of the language file that needs to be included
 $language_file='exercice';
 
@@ -227,4 +228,4 @@ if ($form->validate()) {
 	}
 	$form->display();
 }
-Display::display_footer();
\ No newline at end of file
+Display::display_footer();
diff --git a/main/exercice/exercise_history.php b/main/exercice/exercise_history.php
index b58c4b9d26..28e9517a76 100755
--- a/main/exercice/exercise_history.php
+++ b/main/exercice/exercise_history.php
@@ -1,6 +1,5 @@
 <?php
 /* For licensing terms, see /license.txt */
-
 /**
 *	Exercise list: This script shows the list of exercises for administrators and students.
 *	@package chamilo.exercise
@@ -8,8 +7,12 @@
 *	@author Denes Nagy, HotPotatoes integration
 *	@author Wolfgang Schneider, code/html cleanup
 */
-
-// name of the language file that needs to be included
+/**
+ * Code
+ */
+/**
+ * name of the language file that needs to be included
+ */
 $language_file='exercice';
 
 require_once '../inc/global.inc.php';
@@ -18,7 +21,9 @@ api_protect_course_script(true);
 
 $show=(isset($_GET['show']) && $_GET['show'] == 'result')?'result':'test'; // moved down to fix bug: http://www.dokeos.com/forum/viewtopic.php?p=18609#18609
 
-/*	Libraries */
+/**
+ * Libraries
+ */
 
 require_once api_get_path(LIBRARY_PATH).'document.lib.php';
 //include(api_get_path(LIBRARY_PATH).'mail.lib.inc.php');
diff --git a/main/exercice/exercise_show.php b/main/exercice/exercise_show.php
index 1365b275d2..66a03da420 100755
--- a/main/exercice/exercise_show.php
+++ b/main/exercice/exercise_show.php
@@ -10,7 +10,9 @@
  * 	@todo remove the debug code and use the general debug library
  * 	@todo small letters for table variables
  * */
-
+/**
+ * Code
+ */
 // name of the language file that needs to be included
 $language_file = array('exercice');
 
@@ -707,4 +709,4 @@ api_session_unregister('questionList');
 unset ($questionList);
 
 api_session_unregister('exerciseResult');
-unset ($exerciseResult);
\ No newline at end of file
+unset ($exerciseResult);
diff --git a/main/exercice/exercise_submit.php b/main/exercice/exercise_submit.php
index c4151eda79..74179160f5 100644
--- a/main/exercice/exercise_submit.php
+++ b/main/exercice/exercise_submit.php
@@ -19,7 +19,9 @@
 * 	@author Olivier Brouckaert
 * 	@author Julio Montoya multiple fill in blank option added (2008) and Cleaning exercises (2010), Adding hotspot delineation support (2011)
 */
-
+/**
+ * Code
+ */
 require_once 'exercise.class.php';
 require_once 'question.class.php';
 require_once 'answer.class.php';
@@ -693,4 +695,4 @@ if ($origin != 'learnpath') {
     Display :: display_footer();
 } else {
     echo '</body></html>';
-}
\ No newline at end of file
+}
diff --git a/main/exercice/exercise_submit_modal.php b/main/exercice/exercise_submit_modal.php
index e096f3e90a..dd9977127b 100755
--- a/main/exercice/exercise_submit_modal.php
+++ b/main/exercice/exercise_submit_modal.php
@@ -4,6 +4,9 @@
 *	@package chamilo.exercise
 * 	@author Julio Montoya <gugli100@gmail.com>
 */
+/**
+ * Code
+ */
 $language_file=array('exercice');
 require_once '../inc/global.inc.php';
 api_protect_course_script(false);
@@ -571,4 +574,4 @@ if ($links!='') {
 			self.parent.window.location.href = "exercise_submit.php?exerciseId='.$exerciseId.'&questionNum='.$questionNum.'&exerciseType='.$exerciseType.'&origin='.$origin.'";	  		 	
    			//self.parent.tb_remove();	  	
  	 	</script>';	
-}
\ No newline at end of file
+}
diff --git a/main/exercice/export/exercise_import.php b/main/exercice/export/exercise_import.php
index 97b57d330e..c7eafab801 100755
--- a/main/exercice/export/exercise_import.php
+++ b/main/exercice/export/exercise_import.php
@@ -1,12 +1,13 @@
 <?php // $Id:  $
+/* For licensing terms, see /license.txt */
 /**
  * @copyright (c) 2001-2006 Universite catholique de Louvain (UCL)
- *
- * @license http://www.gnu.org/copyleft/gpl.html (GPL) GENERAL PUBLIC LICENSE
- *
- * @package dokeos.exercise
+ * @package chamilo.exercise
  * @author claro team <cvs@claroline.net>
  */
+/**
+ * Code
+ */
 
 require '../../inc/global.inc.php';
 
diff --git a/main/exercice/export/qti/qti_export.php b/main/exercice/export/qti/qti_export.php
old mode 100644
new mode 100755
index b9efd183b4..de7a3de584
--- a/main/exercice/export/qti/qti_export.php
+++ b/main/exercice/export/qti/qti_export.php
@@ -1,18 +1,16 @@
 <?php // $Id: $
-if ( count( get_included_files() ) == 1 ) die( '---' );
+/* For licensing terms, see /license.txt */
 /**
- * @copyright (c) 2007 Dokeos
- * @copyright (c) 2001-2006 Universite catholique de Louvain (UCL)
- *
- * @license http://www.gnu.org/copyleft/gpl.html (GPL) GENERAL PUBLIC LICENSE
- *
  * @author Claro Team <cvs@claroline.net>
  * @author Amand Tihon <amand@alrj.org>
  * @author Sebastien Piraux <pir@cerdecam.be>
- * @author Yannick Warnier <yannick.warnier@dokeos.com>
- *
+ * @author Yannick Warnier <yannick.warnier@beeznest.com>
+ * @package chamilo.exercise.qti
  */
-
+/**
+ * Code
+ */
+if ( count( get_included_files() ) == 1 ) die( '---' );
 include dirname(__FILE__) . '/qti_classes.php';
 /*--------------------------------------------------------
       Classes
@@ -30,6 +28,7 @@ include dirname(__FILE__) . '/qti_classes.php';
  *   - anonymous_attempts
  *
  * @author Amand Tihon <amand@alrj.org>
+ * @package chamilo.exercise.qti
  */
 class ImsSection
 {
@@ -176,6 +175,7 @@ class ImsSection
  * Every start_*() and corresponding end_*(), as well as export_*() methods return a string.
  *
  * @warning Attached files are NOT exported.
+ * @package chamilo.exercise.qti
  * @author Amand Tihon <amand@alrj.org>
  */
 class ImsItem
@@ -348,4 +348,4 @@ function export_question($questionId, $standalone=True)
 
 }
 
-?>
\ No newline at end of file
+?>
diff --git a/main/exercice/export/qti2/qti2_classes.php b/main/exercice/export/qti2/qti2_classes.php
index 009d4ac2b8..11fb0880fa 100755
--- a/main/exercice/export/qti2/qti2_classes.php
+++ b/main/exercice/export/qti2/qti2_classes.php
@@ -1,14 +1,14 @@
 <?php // $Id: $
-if ( count( get_included_files() ) == 1 ) die( '---' );
+/* For licensing terms, see /license.txt */
 /**
- * @copyright (c) 2007 Dokeos
- * @copyright (c) 2001-2006 Universite catholique de Louvain (UCL)
- *
- * @license http://www.gnu.org/copyleft/gpl.html (GPL) GENERAL PUBLIC LICENSE
- *
  * @author Claro Team <cvs@claroline.net>
  * @author Yannick Warnier <yannick.warnier@dokeos.com> - updated ImsAnswerHotspot to match QTI norms
+ * @package chamilo.exercise
  */
+/**
+ * Code
+ */
+if ( count( get_included_files() ) == 1 ) die( '---' );
 // answer types
 define('UNIQUE_ANSWER',		1);
 define('MCUA',				1);
@@ -41,7 +41,10 @@ require_once(api_get_path(SYS_CODE_PATH).'/exercice/fill_blanks.class.php');
 //include_once $path . '/../../lib/answer_truefalse.class.php';
 //include_once $path . '/../../lib/answer_fib.class.php';
 //include_once $path . '/../../lib/answer_matching.class.php';
-
+/**
+ *
+ * @package chamilo.exercise
+ */
 class Ims2Question extends Question
 {
     /**
@@ -87,7 +90,10 @@ class Ims2Question extends Question
     	return true;
     }
 }
-
+/**
+ * Class
+ * @package chamilo.exercise
+ */
 class ImsAnswerMultipleChoice extends Answer
 {
     /**
@@ -160,6 +166,10 @@ class ImsAnswerMultipleChoice extends Answer
     }
 }
 
+/**
+ * Class
+ * @package chamilo.exercise
+ */
 class ImsAnswerFillInBlanks extends Answer
 {
     /**
@@ -288,6 +298,10 @@ class ImsAnswerFillInBlanks extends Answer
     }
 }
 
+/**
+ * Class
+ * @package chamilo.exercise
+ */
 class ImsAnswerMatching extends Answer
 {
     /**
@@ -377,6 +391,10 @@ class ImsAnswerMatching extends Answer
 
 }
 
+/**
+ * Class
+ * @package chamilo.exercise
+ */
 class ImsAnswerHotspot extends Answer
 {
     /**
@@ -467,6 +485,10 @@ class ImsAnswerHotspot extends Answer
     }
 }
 
+/**
+ * Class
+ * @package chamilo.exercise
+ */
 class ImsAnswerFree extends Answer
 {
     /**
diff --git a/main/exercice/export/qti2/qti2_export.php b/main/exercice/export/qti2/qti2_export.php
index 1804980875..68d9dc3058 100755
--- a/main/exercice/export/qti2/qti2_export.php
+++ b/main/exercice/export/qti2/qti2_export.php
@@ -1,20 +1,18 @@
 <?php // $Id: $
-if ( count( get_included_files() ) == 1 ) die( '---' );
+/* For licensing terms, see /license.txt */
 /**
- * @copyright (c) 2007 Dokeos
- * @copyright (c) 2001-2006 Universite catholique de Louvain (UCL)
- *
- * @license http://www.gnu.org/copyleft/gpl.html (GPL) GENERAL PUBLIC LICENSE
- *
  * @author Claro Team <cvs@claroline.net>
- * @author Yannick Warnier <yannick.warnier@dokeos.com>
+ * @author Yannick Warnier <yannick.warnier@beeznest.com>
+ * @package chamilo.exercise
  */
-
+/**
+ * Code
+ */
+if ( count( get_included_files() ) == 1 ) die( '---' );
 require dirname(__FILE__) . '/qti2_classes.php';
-
-/*--------------------------------------------------------
-      Classes
-  --------------------------------------------------------*/
+/**
+ * Classes
+*/
 // answer types
 define(UNIQUE_ANSWER,	1);
 define(MULTIPLE_ANSWER,	2);
@@ -30,7 +28,8 @@ define(HOT_SPOT_ORDER, 	7);
  *
  * Every start_*() and corresponding end_*(), as well as export_*() methods return a string.
  *
- * @warning Attached files are NOT exported.
+ * @note Attached files are NOT exported.
+ * @package chamilo.exercise
  */
 class ImsAssessmentItem
 {
@@ -158,6 +157,7 @@ class ImsAssessmentItem
  *   - anonymous_attempts
  *
  * @author Amand Tihon <amand@alrj.org>
+ * @package chamilo.exercise
  */
 class ImsSection
 {
@@ -304,6 +304,7 @@ class ImsSection
  *
  * @warning Attached files are NOT exported.
  * @author Amand Tihon <amand@alrj.org>
+ * @package chamilo.exercise
  */
 class ImsItem
 {
@@ -475,4 +476,4 @@ function export_question($questionId, $standalone=true)
     $ims = new ImsAssessmentItem($question);
 
     return $ims->export($standalone);
-}
\ No newline at end of file
+}
diff --git a/main/exercice/export/scorm/scorm_classes.php b/main/exercice/export/scorm/scorm_classes.php
index 56dd622e36..5b5570b0a4 100755
--- a/main/exercice/export/scorm/scorm_classes.php
+++ b/main/exercice/export/scorm/scorm_classes.php
@@ -1,14 +1,14 @@
 <?php // $Id: scorm_classes.php,v 1.2 2006/07/06 18:50:49 moosh Exp $
-if ( count( get_included_files() ) == 1 ) die( '---' );
+/* For licensing terms, see /license.txt */
 /**
- * @copyright (c) 2007 Dokeos
- * @copyright (c) 2001-2006 Universite catholique de Louvain (UCL)
- *
- * @license http://www.gnu.org/copyleft/gpl.html (GPL) GENERAL PUBLIC LICENSE
- *
  * @author Claro Team <cvs@claroline.net>
- * @author Yannick Warnier <yannick.warnier@dokeos.com>
+ * @author Yannick Warnier <yannick.warnier@beeznest.com>
+ * @package chamilo.exercise.scorm
+ */
+/**
+ * Code
  */
+if ( count( get_included_files() ) == 1 ) die( '---' );
 require_once(api_get_path(SYS_CODE_PATH).'exercice/exercise.class.php');
 require_once(api_get_path(SYS_CODE_PATH).'exercice/question.class.php');
 require_once(api_get_path(SYS_CODE_PATH).'exercice/answer.class.php');
@@ -46,6 +46,7 @@ define('MULTIPLE_ANSWER_COMBINATION', 	9);
  * part (the process).
  * The two bits are separate to allow for a one-big-javascript and a one-big-html
  * files to be built. Each export function thus returns an array of HTML+JS
+ * @package chamilo.exercise.scorm
  */
 class ScormQuestion extends Question
 {
@@ -168,6 +169,7 @@ class ScormQuestion extends Question
 /**
  * This class handles the export to SCORM of a multiple choice question
  * (be it single answer or multiple answers)
+ * @package chamilo.exercise.scorm
  */
 class ScormAnswerMultipleChoice extends Answer
 {
@@ -278,6 +280,7 @@ class ScormAnswerMultipleChoice extends Answer
 
 /**
  * This class handles the SCORM export of true/false questions
+ * @package chamilo.exercise.scorm
  */
 class ScormAnswerTrueFalse extends Answer
 {
@@ -335,6 +338,7 @@ class ScormAnswerTrueFalse extends Answer
 
 /**
  * This class handles the SCORM export of fill-in-the-blanks questions
+ * @package chamilo.exercise.scorm
  */
 class ScormAnswerFillInBlanks extends Answer
 {
@@ -407,6 +411,7 @@ class ScormAnswerFillInBlanks extends Answer
 
 /**
  * This class handles the SCORM export of matching questions
+ * @package chamilo.exercise.scorm
  */
 class ScormAnswerMatching extends Answer
 {
@@ -515,6 +520,7 @@ class ScormAnswerMatching extends Answer
 
 /**
  * This class handles the SCORM export of free-answer questions
+ * @package chamilo.exercise.scorm
  */
 class ScormAnswerFree extends Answer
 {
@@ -551,6 +557,7 @@ class ScormAnswerFree extends Answer
 }
 /**
  * This class handles the SCORM export of hotpot questions
+ * @package chamilo.exercise.scorm
  */
 class ScormAnswerHotspot extends Answer
 {
diff --git a/main/exercice/export/scorm/scorm_export.php b/main/exercice/export/scorm/scorm_export.php
old mode 100644
new mode 100755
index 7fb9930f50..38da577eca
--- a/main/exercice/export/scorm/scorm_export.php
+++ b/main/exercice/export/scorm/scorm_export.php
@@ -1,14 +1,12 @@
 <?php // $Id: $
-if ( count( get_included_files() ) == 1 ) die( '---' );
+/* For licensing terms, see /license.txt */
 /**
- * @copyright (c) 2007 Dokeos
- * @copyright (c) 2001-2006 Universite catholique de Louvain (UCL)
- *
- * @license http://www.gnu.org/copyleft/gpl.html (GPL) GENERAL PUBLIC LICENSE
- *
- * @author Claro Team <cvs@claroline.net>
- * @author Yannick Warnier <yannick.warnier@dokeos.com>
+ * @package chamilo.exercise.scorm
  */
+/**
+ * Code
+ */
+if ( count( get_included_files() ) == 1 ) die( '---' );
 
 require dirname(__FILE__) . '/scorm_classes.php';
 
@@ -647,4 +645,4 @@ function export_question($questionId, $standalone=true, $js_id)
     //echo "<pre>".print_r($scorm,1)."</pre>";exit;
     return $assessmentItem->export();
 }
-?>
\ No newline at end of file
+?>
diff --git a/main/exercice/feedback.php b/main/exercice/feedback.php
index cce98d133a..6d15d96707 100755
--- a/main/exercice/feedback.php
+++ b/main/exercice/feedback.php
@@ -1,13 +1,15 @@
 <?php
 /* For licensing terms, see /license.txt */
 // Note by Ivan Tcholakov, 14-JUL-2009: I can't see where this file is used. Is it obsolete?
-
 /**
 *	Feedback
-*	@package dokeos.exercise
+*	@package chamilo.exercise
 * 	@author
 * 	@version $Id: admin.php 10680 2007-01-11 21:26:23Z pcool $
 */
+/**
+ * Code
+ */
 include('exercise.class.php');
 include('question.class.php');
 include('answer.class.php');
diff --git a/main/exercice/hotpotatoes.php b/main/exercice/hotpotatoes.php
index a38e33e9b2..db5da48c7a 100755
--- a/main/exercice/hotpotatoes.php
+++ b/main/exercice/hotpotatoes.php
@@ -1,13 +1,13 @@
 <?php
 /* For licensing terms, see /license.txt */
-
 /**
  * Code for HotPotatoes integration.
  * @package chamilo.exercise
  * @author Istvan Mandak (original author)
  */
-
-
+/**
+ * Code
+ */
 // Name of the language file that needs to be included.
 $language_file ='exercice';
 
@@ -230,4 +230,4 @@ if ((api_is_allowed_to_edit(null, true)) && (($finish == 0) || ($finish == 2)))
     echo '</div></div>';
 }
 // Display the footer.
-Display::display_footer();
\ No newline at end of file
+Display::display_footer();
diff --git a/main/exercice/hotspot.inc.php b/main/exercice/hotspot.inc.php
index f8d55ffbbf..3f952bfe1a 100755
--- a/main/exercice/hotspot.inc.php
+++ b/main/exercice/hotspot.inc.php
@@ -1,11 +1,12 @@
 <?php
 /* For licensing terms, see /license.txt */
-
 /**
  *	Hotspot languae conversion
  *	@package chamilo.exercise
  */
-
+/**
+ * Code
+ */
 session_cache_limiter('none');
 
 $language_file = 'hotspot';
diff --git a/main/exercice/hotspot_actionscript.as.php b/main/exercice/hotspot_actionscript.as.php
index 4142e51de2..940ef8b23f 100755
--- a/main/exercice/hotspot_actionscript.as.php
+++ b/main/exercice/hotspot_actionscript.as.php
@@ -2,10 +2,13 @@
 /* For licensing terms, see /license.txt */
 /**
 *	This file generates the ActionScript variables code used by the HotSpot .swf
-*	@package dokeos.exercise
+*	@package chamilo.exercise
 * 	@author Toon Keppens
 * 	@version $Id: admin.php 10680 2007-01-11 21:26:23Z pcool $
 */
+/**
+ * Code
+ */
 session_cache_limiter("none");
 include('exercise.class.php');
 include('question.class.php');
@@ -87,4 +90,4 @@ for ($i; $i <= 12; $i++) {
 	$output .= "&hotspot_".$i."=false";
 }
 // Output
-echo $output."&nmbrTries=".$nmbrTries."&done=done";
\ No newline at end of file
+echo $output."&nmbrTries=".$nmbrTries."&done=done";
diff --git a/main/exercice/hotspot_actionscript_admin.as.php b/main/exercice/hotspot_actionscript_admin.as.php
index d1831e9b47..7102bbbba2 100755
--- a/main/exercice/hotspot_actionscript_admin.as.php
+++ b/main/exercice/hotspot_actionscript_admin.as.php
@@ -2,11 +2,13 @@
 /* For licensing terms, see /license.txt */
 /**
 *	This file generates the ActionScript variables code used by the HotSpot .swf
-*	@package dokeos.exercise
+*	@package chamilo.exercise
 * 	@author Toon Keppens
 * 	@version $Id: admin.php 10680 2007-01-11 21:26:23Z pcool $
 */
-
+/**
+ * Code
+ */
 include('exercise.class.php');
 include('question.class.php');
 include('answer.class.php');
@@ -91,4 +93,4 @@ for ($i; $i <= 12; $i++) {
 }
 
 // Output
-echo $output."&nmbrTries=".$nmbrTries."&done=done";
\ No newline at end of file
+echo $output."&nmbrTries=".$nmbrTries."&done=done";
diff --git a/main/exercice/hotspot_admin.inc.php b/main/exercice/hotspot_admin.inc.php
index a4349e559d..963debbf8e 100755
--- a/main/exercice/hotspot_admin.inc.php
+++ b/main/exercice/hotspot_admin.inc.php
@@ -1,12 +1,15 @@
 <?php
 /* For licensing terms, see /license.txt */
 /**
-*	This script allows to manage answers. It is included from the script admin.php
-*	@package chamilo.exercise
-* 	@author Toon Keppens
-*/
-
-// ALLOWED_TO_INCLUDE is defined in admin.php
+ * This script allows to manage answers. It is included from the 
+ * script admin.php
+ * @package chamilo.exercise
+ * @author Toon Keppens
+ */
+/**
+ * Code
+ * ALLOWED_TO_INCLUDE is defined in admin.php
+ */
 if (!defined('ALLOWED_TO_INCLUDE')) {
 	exit();
 }
@@ -988,4 +991,4 @@ if ($modifyAnswers) {
 </form>
 <?php
     if($debug>0){echo str_repeat('&nbsp;',0).'$modifyAnswers was set - end'."<br />\n";}
-}
\ No newline at end of file
+}
diff --git a/main/exercice/hotspot_answers.as.php b/main/exercice/hotspot_answers.as.php
index 8b2fd7a79a..97c34dd10e 100755
--- a/main/exercice/hotspot_answers.as.php
+++ b/main/exercice/hotspot_answers.as.php
@@ -1,11 +1,14 @@
 <?php
 /* For licensing terms, see /license.txt */
 /**
-*	This file generates the ActionScript variables code used by the HotSpot .swf
-*	@package chamilo.exercise
-* 	@author Toon Keppens, Julio Montoya adding hotspot "medical" support
-*/
-
+ * This file generates the ActionScript variables code used by the 
+ * HotSpot .swf
+ * @package chamilo.exercise
+ * @author Toon Keppens, Julio Montoya adding hotspot "medical" support
+ */
+/**
+ * Code
+ */
 include('exercise.class.php');
 include('question.class.php');
 include('answer.class.php');
@@ -103,4 +106,4 @@ if(isset($_SESSION['exerciseResultCoordinates']) && $from_db==0) {
 $output .= "&p_hotspot_answers=".api_substr($output2,0,-1)."&done=done";
 $explode = explode('&', $output);
 
-echo $output;
\ No newline at end of file
+echo $output;
diff --git a/main/exercice/hotspot_lang_conversion.php b/main/exercice/hotspot_lang_conversion.php
index 15ed575d77..0f74885767 100755
--- a/main/exercice/hotspot_lang_conversion.php
+++ b/main/exercice/hotspot_lang_conversion.php
@@ -1,14 +1,14 @@
 <?php //$id:$
 /* For licensing terms, see /license.txt */
-//error_log(__FILE__);
 /**
 *	Hotspot language conversion
 *	@package chamilo.exercise
 * 	@author
 * 	@version $Id: admin.php 10680 2007-01-11 21:26:23Z pcool $
 */
-
-
+/**
+ * Code
+ */
 include_once('../inc/global.inc.php');
 
 $hotspot_lang_file = api_get_path(SYS_LANG_PATH);
@@ -54,4 +54,4 @@ foreach($temp as $value)
 {
 	echo $value . ' ';
 }
-?>
\ No newline at end of file
+?>
diff --git a/main/exercice/hotspot_save.inc.php b/main/exercice/hotspot_save.inc.php
index c88fc739fc..83c3c5eede 100755
--- a/main/exercice/hotspot_save.inc.php
+++ b/main/exercice/hotspot_save.inc.php
@@ -1,13 +1,14 @@
 <?php //$id:$
 /* For licensing terms, see /license.txt */
-//error_log(__FILE__);
 /**
 *
-*	@package dokeos.exercise
-* 	@author Toon Keppens
-* 	@version $Id: admin.php 10680 2007-01-11 21:26:23Z pcool $
+* @package chamilo.exercise
+* @author Toon Keppens
+* @version $Id: admin.php 10680 2007-01-11 21:26:23Z pcool $
 */
-
+/**
+ * Code
+ */
 include('exercise.class.php');
 include('question.class.php');
 include('answer.class.php');
@@ -39,4 +40,4 @@ if ($_GET['type'] == "poly" || $_GET['type'] == "delineation" || $_GET['type'] =
 }
 $sql = "UPDATE $TBL_ANSWER SET hotspot_coordinates = '".Database::escape_string($hotspot_coordinates)."',hotspot_type = '".Database::escape_string($hotspot_type)."' WHERE id = '".Database::escape_string($answerId)."' AND question_id ='".Database::escape_string($questionId)."' LIMIT 1 ;";
 $result = Database::query($sql);
-echo "done=done";
\ No newline at end of file
+echo "done=done";
diff --git a/main/exercice/hotspot_savescore.inc.php b/main/exercice/hotspot_savescore.inc.php
index b55ba0313e..88e6949b48 100755
--- a/main/exercice/hotspot_savescore.inc.php
+++ b/main/exercice/hotspot_savescore.inc.php
@@ -1,14 +1,14 @@
 <?php //$id:$
 /* For licensing terms, see /dokeos_license.txt */
-
-//error_log(__FILE__);
 /**
 *	This file saves every click in the hotspot tool into track_e_hotspots
-*	@package dokeos.exercise
+*	@package chamilo.exercise
 * 	@author Toon Keppens
 * 	@version $Id: admin.php 10680 2007-01-11 21:26:23Z pcool $
 */
-
+/**
+ * Code
+ */
 include('exercise.class.php');
 include('question.class.php');
 include('answer.class.php');
@@ -55,4 +55,4 @@ $sql = "INSERT INTO $TBL_TRACK_E_HOTSPOT (user_id , course_id , quiz_id , questi
 $result = Database::query($sql);
 // Save insert id into session if users changes answer.
 $insert_id = Database::insert_id();
-$_SESSION['exerciseResult'][$questionId]['ids'][$answerOrderId] = $insert_id;
\ No newline at end of file
+$_SESSION['exerciseResult'][$questionId]['ids'][$answerOrderId] = $insert_id;
diff --git a/main/exercice/hotspot_updatescore.inc.php b/main/exercice/hotspot_updatescore.inc.php
index 39ecf46b07..540b9ddbc6 100755
--- a/main/exercice/hotspot_updatescore.inc.php
+++ b/main/exercice/hotspot_updatescore.inc.php
@@ -1,18 +1,18 @@
 <?php //$id:$
 /* For licensing terms, see /dokeos_license.txt */
-
-//error_log(__FILE__);
 /**
 *	This file saves every click in the hotspot tool into track_e_hotspots
-*	@package dokeos.exercise
+*	@package chamilo.exercise
 * 	@author Toon Keppens
 * 	@version $Id: admin.php 10680 2007-01-11 21:26:23Z pcool $
 */
-
-include('exercise.class.php');
-include('question.class.php');
-include('answer.class.php');
-include('../inc/global.inc.php');
+/**
+ * Code
+ */
+include 'exercise.class.php';
+include 'question.class.php';
+include 'answer.class.php';
+include '../inc/global.inc.php';
 
 
 $courseCode   = $_GET['coursecode'];
@@ -21,8 +21,7 @@ $coordinates  = $_GET['coord'];
 $objExcercise = $_SESSION['objExercise'];
 $hotspotId	  = $_GET['hotspotId'];
 $exerciseId   = $objExcercise->selectId();
-if ($_GET['answerId'] == "0") // click is NOT on a hotspot
-{
+if ($_GET['answerId'] == "0") { // click is NOT on a hotspot
 	$hit = 0;
 	$answerId = $hotspotId;
 
@@ -32,9 +31,7 @@ if ($_GET['answerId'] == "0") // click is NOT on a hotspot
 	// Save clicking order
 	//$answerOrderId = count($_SESSION['exerciseResult'][$questionId]['order'])+1;
 	//$_SESSION['exerciseResult'][$questionId]['order'][$answerOrderId] = $answerId;
-}
-else // user clicked ON a hotspot
-{
+} else { // user clicked ON a hotspot
 	$hit = 1;
 	$answerId = $hotspotId;
 
@@ -60,4 +57,4 @@ $TBL_TRACK_E_HOTSPOT   = Database::get_statistic_table(STATISTIC_TRACK_E_HOTSPOT
 // update db
 $update_id = $_SESSION['exerciseResult'][$questionId]['ids'][$answerId];
 $sql = "UPDATE $TBL_TRACK_E_HOTSPOT SET coordinate = '".Database::escape_string($coordinates)."' WHERE id ='".Database::escape_string($update_id)."' LIMIT 1 ;;";
-$result = Database::query($sql);
\ No newline at end of file
+$result = Database::query($sql);
diff --git a/main/exercice/mark_free_answer.php b/main/exercice/mark_free_answer.php
index 315fdb3f07..1ebd7e06ba 100755
--- a/main/exercice/mark_free_answer.php
+++ b/main/exercice/mark_free_answer.php
@@ -1,19 +1,17 @@
 <?php
 /* For licensing terms, see /license.txt */
-
 /**
 *	Free answer marking script
 * 	This script allows a course tutor to mark a student's free answer.
-*	@package dokeos.exercise
+*	@package chamilo.exercise
 * 	@author Yannick Warnier <yannick.warnier@dokeos.com>
 * 	@version $Id: admin.php 10680 2007-01-11 21:26:23Z pcool $
 *
 * 	@todo respect coding guidelines
 */
-
-/*
-		INIT SECTION
-*/
+/**
+ * Code
+ */
 // name of the language file that needs to be included
 $language_file='exercice';
 
@@ -191,4 +189,4 @@ if($action == 'mark'){
 		"<input type='submit' name='submit' value='".get_lang('Ok')."'>\n"
 		."</form>";
 }
-Display::display_footer();
\ No newline at end of file
+Display::display_footer();
diff --git a/main/exercice/multiple_answer_combination_true_false.class.php b/main/exercice/multiple_answer_combination_true_false.class.php
index 867efb8b41..0c7f2815dc 100644
--- a/main/exercice/multiple_answer_combination_true_false.class.php
+++ b/main/exercice/multiple_answer_combination_true_false.class.php
@@ -1,13 +1,14 @@
 <?php // $Id: document.php 16494 2008-10-10 22:07:36Z yannoo $
 /* For licensing terms, see /chamilo_license.txt */
-
 /**
 *	File containing the MultipleAnswer class.
-*	@package dokeos.exercise
+*	@package chamilo.exercise
 * 	@author Eric Marguin
 * 	@version $Id: admin.php 10680 2007-01-11 21:26:23Z pcool $
 */
-
+/**
+ * Code
+ */
 if(!class_exists('MultipleAnswerCombinationTrueFalse')):
 
 /**
@@ -37,4 +38,4 @@ class MultipleAnswerCombinationTrueFalse extends MultipleAnswerCombination {
         $this->options = array('1'=>get_lang('True'),'0' =>get_lang('False'), '2' =>get_lang('DontKnow'));
 	}
 }
-endif;
\ No newline at end of file
+endif;
diff --git a/main/exercice/qti2.php b/main/exercice/qti2.php
index e713da6cd0..bdff74deb7 100755
--- a/main/exercice/qti2.php
+++ b/main/exercice/qti2.php
@@ -6,7 +6,9 @@
 * 	@author Ronny Velasquez
 * 	@version $Id: qti2.php  2010-03-12 12:14:25Z $
 */
-
+/**
+ * Code
+ */
 // name of the language file that needs to be included
 $language_file = 'exercice';
 
@@ -98,4 +100,4 @@ ch_qti2_display_form();
 
 // display the footer
 Display::display_footer();
-?>
\ No newline at end of file
+?>
diff --git a/main/exercice/question.class.php b/main/exercice/question.class.php
index f8a9d9f257..af442a2e5d 100755
--- a/main/exercice/question.class.php
+++ b/main/exercice/question.class.php
@@ -1,13 +1,14 @@
 <?php
 /* For licensing terms, see /license.txt */
-
 /**
 *	File containing the Question class.
 *	@package chamilo.exercise
 * 	@author Olivier Brouckaert
 *   @author Julio Montoya <gugli100@gmail.com> lot of bug fixes
 */
-
+/**
+ * Code
+ */
 if(!class_exists('Question')):
 
 // answer types
@@ -1306,4 +1307,4 @@ abstract class Question
         return $question_id;
     }
 }
-endif;
\ No newline at end of file
+endif;
diff --git a/main/exercice/question_admin.inc.php b/main/exercice/question_admin.inc.php
index e4c67454c8..78bf75ad19 100755
--- a/main/exercice/question_admin.inc.php
+++ b/main/exercice/question_admin.inc.php
@@ -1,6 +1,5 @@
 <?php
 /* For licensing terms, see /license.txt */
-
 /**
 *	Statement (?) administration
 *	This script allows to manage the statements of questions.
@@ -9,8 +8,9 @@
 * 	@author Olivier Brouckaert
 * 	@version $Id: question_admin.inc.php 22126 2009-07-15 22:38:39Z juliomontoya $
 */
-
-/*		INIT SECTION    */
+/**
+ * Code
+ */
 require_once api_get_path(LIBRARY_PATH).'formvalidator/FormValidator.class.php';
 
 // ALLOWED_TO_INCLUDE is defined in admin.php
@@ -103,4 +103,4 @@ if(is_object($objQuestion)) {
 		// display the form
 		$form->display();
 	}
-}
\ No newline at end of file
+}
diff --git a/main/exercice/question_create.php b/main/exercice/question_create.php
index 865520385e..25d1d14847 100755
--- a/main/exercice/question_create.php
+++ b/main/exercice/question_create.php
@@ -1,6 +1,12 @@
 <?php
 /* For licensing terms, see /license.txt */
-
+/**
+ * Exercise
+ * @package chamilo.exercise
+ */
+/**
+ * Code
+ */
 // name of the language file that needs to be included
 $language_file='exercice';
 
@@ -139,4 +145,4 @@ function check_question_type($parameter) {
 	} else {
 		return false;
 	}
-}
\ No newline at end of file
+}
diff --git a/main/exercice/savescores.php b/main/exercice/savescores.php
index d829fea5b1..db4fbe78b3 100755
--- a/main/exercice/savescores.php
+++ b/main/exercice/savescores.php
@@ -1,13 +1,14 @@
 <?php
 /* For licensing terms, see /license.txt */
-
 /**
 *	Saving the scores.
 *	@package chamilo.exercise
 * 	@author
 * 	@version $Id: savescores.php 15602 2008-06-18 08:52:24Z pcool $
 */
-
+/**
+ * Code
+ */
 // name of the language file that needs to be included
 $language_file = 'learnpath';
 
@@ -113,4 +114,4 @@ if ($origin != 'learnpath') {
 </html>
 <?php
 }
-?>
\ No newline at end of file
+?>
diff --git a/main/exercice/showinframes.php b/main/exercice/showinframes.php
index 74e441203a..0d2ead5697 100755
--- a/main/exercice/showinframes.php
+++ b/main/exercice/showinframes.php
@@ -1,14 +1,13 @@
 <?php
 /* For licensing terms, see /license.txt */
-
 /**
  *	Code library for HotPotatoes integration.
  *	@package chamilo.exercise
  * 	@author Istvan Mandak
  */
-
-/*	Included libraries */
-
+/**
+ * Included libraries
+ */
 require '../inc/global.inc.php';
 require_once api_get_path(LIBRARY_PATH).'fileManage.lib.php';
 $time = time();
@@ -16,7 +15,9 @@ require_once api_get_path(SYS_CODE_PATH).'exercice/hotpotatoes.lib.php';
 
 header('Content-Type: text/html; charset='.api_get_system_encoding());
 
-// Initialization
+/**
+ * Initialization
+ */
 $doc_url = str_replace(array('../', '\\', '\\0', '..'), array('', '', '', ''), urldecode($_GET['file']));
 $cid = api_get_course_id();
 $document_path = api_get_path(SYS_COURSE_PATH).$_course['path'].'/document';
@@ -26,7 +27,9 @@ $learnpath_id = $_REQUEST['learnpath_id'];
 $learnpath_item_id = $_REQUEST['learnpath_item_id'];
 $time = $_REQUEST['time'];
 
-// Read content
+/**
+ * Read content
+ */
 $full_file_path = $document_path.$doc_url;
 my_delete($full_file_path.$_user['user_id'].'.t.html');
 $content = ReadFileCont($full_file_path.$_user['user_id'].'.t.html');
@@ -156,4 +159,4 @@ if ($origin!='learnpath') {
 }
 ?>
 
-</html>
\ No newline at end of file
+</html>
diff --git a/main/exercice/testheaderpage.php b/main/exercice/testheaderpage.php
index 0b9a49ac25..7182589bce 100755
--- a/main/exercice/testheaderpage.php
+++ b/main/exercice/testheaderpage.php
@@ -2,9 +2,12 @@
 /* For licensing terms, see /license.txt */
 /**
 *	Code library for HotPotatoes integration.
-*	@package dokeos.exercise
+*	@package chamilo.exercise
 * 	@author Istvan Mandak
 */
+/**
+ * Code
+ */
 // name of the language file that needs to be included
 $language_file='exercice';
 
@@ -34,4 +37,4 @@ if (!empty($gradebook) && $gradebook=='view') {
 }
 $interbreadcrumb[]= array ("url"=>"./exercice.php", "name"=> get_lang('Exercices'));
 Display::display_header($nameTools,"Exercise");
-echo "<a name='TOP'></a>";
\ No newline at end of file
+echo "<a name='TOP'></a>";
diff --git a/main/exercice/upload_exercise.php b/main/exercice/upload_exercise.php
index 166923dcf2..9b00a242b5 100755
--- a/main/exercice/upload_exercise.php
+++ b/main/exercice/upload_exercise.php
@@ -6,7 +6,9 @@
  *  Encoding fixes Julio Montoya 
  * 	@package chamilo.exercise
  */
-// Language files that should be included
+/**
+ * Language files that should be included
+ */
 $language_file[] = 'learnpath';
 $language_file[] = 'exercice';
 // setting the help
@@ -294,4 +296,4 @@ function lp_upload_quiz_action_handling() {
             echo '<script>window.location.href = "admin.php?'.api_get_cidReq().'&exerciseId='.$quiz_id.'&session_id='.api_get_session_id().'"</script>';
         }
     }
-}
\ No newline at end of file
+}