cantico / absences

programs/utilit/dynamic_right.class.php

Doc Comments +1 added lines, -1 removed lines

@@ -121,7 +121,7 @@
 	/**
 	 *
 	 * @param absences_Entry $entry
-	 * @return absences_EntryElem
+	 * @return absences_DynamicRight
 	 */
 	public function setEntry(absences_Entry $entry)
 	{

programs/utilit/entry.class.php

Doc Comments +5 added lines, -3 removed lines

@@ -499,7 +499,7 @@ 
 	 * Save entry to database
 	 * without validity checking
 	 *
-	 * @return bool
+	 * @return boolean|null
 	 */
 	public function save()
 	{
@@ -865,7 +865,7 @@ 
 	/**
 	 * Add quantity to startdate only on working periods
 	 *
-	 * @param BAB_DateTime $startdate
+	 * @param BAB_DateTime $startDate
 	 * @param float $quantity  days
 	 *
 	 * @return BAB_DateTime
@@ -1975,6 +1975,8 @@ 
 
 
 	/**
+	 * @param integer $rfrom
+	 * @param integer $ide
 	 * @return string
 	 */
 	public function getEditUrl($rfrom, $ide = null)
@@ -2503,7 +2505,7 @@ 
     }
     
     /**
-     * @return array
+     * @return string[]
      */
     protected function getWhere()
     {

programs/utilit/exportentry.class.php

Doc Comments +1 added lines, -1 removed lines

@@ -519,7 +519,7 @@
     
 
     /**
-     * @return absences_Agent[]
+     * @return absences_AgentIterator
      */
     private function getUsersWithoutRequests()
     {

programs/vacuser.php

Doc Comments +17 added lines

@@ -1792,6 +1792,10 @@ 
 	
 	
 	
+	/**
+	 * @param string $old_date_begin
+	 * @param string $old_date_end
+	 */
 	private static function getPeriodSpanOnEdit($old_date_begin, $old_date_end, BAB_DateTime $date_begin, BAB_DateTime $date_end)
 	{
 	    $old_date_begin_obj = BAB_DateTime::fromIsoDateTime($old_date_begin);
@@ -1818,6 +1822,8 @@ 
 	 * @param int $id_request
 	 * @param BAB_DateTime | null $old_date_begin_obj
 	 * @param BAB_DateTime | null $old_date_end_obj
+	 * @param null|BAB_DateTime $old_date_begin_obj
+	 * @param null|BAB_DateTime $old_date_end_obj
 	 */
 	private static function saveInCalendar($id_request, $id, $old_date_begin_obj, $old_date_end_obj)
 	{
@@ -2049,6 +2055,10 @@ 
 	
 	
 	
+	/**
+	 * @param absences_Entry $entry
+	 * @param boolean $modify
+	 */
 	protected static function addPrevisionalMovement($entry, $modify)
 	{
 	    if ($modify)
@@ -2062,6 +2072,10 @@ 
 	}
 	
 	
+	/**
+	 * @param absences_Entry $entry
+	 * @param boolean $modify
+	 */
 	protected static function addNoApprovalMovement($entry, $modify)
 	{
 	    if ($modify)
@@ -2807,6 +2821,9 @@ 
 
 
 
+/**
+ * @param integer $row
+ */
 function absences_personalRights_addRightInTable(Widget_TableView $table, $row, absences_Right $right, absences_AgentRight $agentRight)
 {
     $W = bab_Widgets();

programs/utilit/workperiod_recover_request.class.php

Doc Comments +2 added lines

@@ -390,6 +390,8 @@
 	
 	
 	/**
+	 * @param integer $rfrom
+	 * @param integer $ide
 	 * @return string
 	 */
 	public function getEditUrl($rfrom, $ide = null)

programs/utilit/agent_right.class.php

Doc Comments +5 added lines, -1 removed lines

@@ -315,6 +315,9 @@ 
 	
 	
 	
+	/**
+	 * @param integer $exists
+	 */
 	public function saveHistory($exists, $quantity)
 	{
 	    global $babDB;
@@ -1346,6 +1349,7 @@ 
 	 *
 	 * @param string $message	generated message
 	 * @param string $comment	Author comment
+	 * @param integer $id_author
 	 */
 	public function addMovement($message, $comment = '', $id_author = null)
 	{
@@ -2138,7 +2142,7 @@ 
 	/**
 	 * 
 	 *
-	 * @return mixed
+	 * @return absences_AgentRight|null
 	 */
 	public function next()
 	{

programs/utilit/vacfixedincl.php

Doc Comments +3 added lines, -1 removed lines

@@ -268,7 +268,7 @@ 
 /**
  * Update all fixed rights for one user
  * @param	int		$id_user
- * @param	array 	$messages
+ * @param	string 	$messages
  */
 function absences_updateFixedRightsOnUser($id_user, &$messages) {
 
@@ -309,6 +309,8 @@ 
 
 /**
  * Tester si la demande du droit a date fixe existe
+ * @param integer $id_user
+ * @param integer $id_right
  * @return bool
  */
 function absences_isFixedCreated($id_user, $id_right)

programs/utilit/vacincl.php

Doc Comments +45 added lines, -2 removed lines

@@ -55,6 +55,9 @@ 
 
 class absences_notifyOnRequestChangeCls
 {
+	/**
+	 * @param string $msg
+	 */
 	function __construct(absences_Entry $entry, $msg)
 	{
 		$this->message = $msg;
@@ -122,6 +125,9 @@ 
 {
 	private $res;
 
+	/**
+	 * @param string $msg
+	 */
 	public function __construct(Array $row, $msg)
 	{
 		global $babDB;
@@ -409,6 +415,9 @@ 
 	public $display_pagination = false;
 
 
+	/**
+	 * @param integer $max
+	 */
 	protected function paginate($total, $max)
 	{
 		$this->t_first_page = absences_translate('First page');
@@ -590,6 +599,9 @@ 
 	public $ide = null;
 
 
+	/**
+	 * @param boolean $display_username
+	 */
 	public function __construct($id_user, $display_username)
 	{
 		require_once dirname(__FILE__).'/request.class.php';
@@ -1270,6 +1282,9 @@ 
 		}
 			
 			
+		/**
+		 * @param string $name
+		 */
 		private function createQuantityProperty($right, $name)
 		{
 				
@@ -1327,6 +1342,9 @@ 
 }
 
 
+/**
+ * @param integer $id_approb
+ */
 function absences_getWfName($id_approb)
 {
 	require_once $GLOBALS['babInstallPath'].'utilit/wfincl.php';
@@ -1508,7 +1526,7 @@ 
  * return null : retour a la liste des agents
  * 
  * 
- * @return bool | null
+ * @return null|boolean | null
  */
 function absences_updateVacationPersonnel($id_user)
 {
@@ -1573,6 +1591,12 @@ 
 class absences_notifyOnVacationChangeCls
 {
 
+	/**
+	 * @param integer $quantity
+	 * @param string $date_begin
+	 * @param string $date_end
+	 * @param string $msg
+	 */
 	public function __construct($quantity, $date_begin,  $date_end, $msg)
 	{
 		$this->message = $msg;
@@ -2232,6 +2256,7 @@ 
 
 /**
  * Clear calendar data for user
+ * @param integer $id_user
  */
 function absences_clearUserCalendar($id_user = NULL) {
 	if (NULL === $id_user) {
@@ -2248,6 +2273,9 @@ 
 
 /**
  * si type2 est prioritaire, return true
+ * @param string $type1
+ * @param string $type2
+ * @param boolean $vacation_is_free
  */
 function absences_compare($type1, $type2, $vacation_is_free) {
 
@@ -2444,6 +2472,9 @@ 
 
 
 
+/**
+ * @param string $query
+ */
 function absences_group_insert($query, $exec = false) {
 	static $values = array();
 	if ($query) {
@@ -2579,6 +2610,9 @@ 
 	return bab_longDate($timestamp, true);
 }
 
+/**
+ * @param null|integer $timestamp
+ */
 function absences_shortDate($timestamp) {
 	if (empty($timestamp)) {
 		return '';
@@ -2590,6 +2624,9 @@ 
 
 class absences_RequestDelete
 {
+    /**
+     * @param integer $folder
+     */
     public static function direct(absences_Request $request, $folder)
     {
         if ($folder)
@@ -2620,6 +2657,9 @@ 
         return $allDeleted;
     }
     
+    /**
+     * @param integer $folder
+     */
     public static function withApproval(absences_Request $request, $folder)
     {
         if ($folder)
@@ -2654,7 +2694,7 @@ 
  * @param int $id_request
  * @param int $folder
  * @param int $rfrom            1 if the delete request is created by a manager from back office (need to be secured)
- * @return bool
+ * @return boolean|null
  */
 function absences_delete_request($id_request, $folder = 0, $rfrom = 0)
 {
@@ -3202,6 +3242,9 @@ 
 	}
 
 
+	/**
+	 * @param string $name
+	 */
 	public function param($name, $default = '')
 	{
 		if (isset($_REQUEST[$name]))