Enalean / tuleap

plugins/tracker/include/Tracker/Action/CreateArtifact.class.php

Doc Comments +3 added lines

@@ -76,6 +76,9 @@
         return $this->artifact_factory->createArtifact($this->tracker, $fields_data, $user, $email);
     }
 
+    /**
+     * @param integer $link_artifact_id
+     */
     private function associateImmediatelyIfNeeded(Tracker_Artifact $new_artifact, $link_artifact_id, $doitnow, PFUser $current_user) {
         if ($link_artifact_id && $doitnow) {
             $source_artifact = $this->artifact_factory->getArtifactById($link_artifact_id);

plugins/tracker/include/Tracker/Artifact/ArtifactNotificationSubscriber.class.php

Doc Comments +4 added lines

@@ -94,6 +94,10 @@
         $this->artifact_dao->createUnsubscribeNotification($this->artifact->getId(), $user->getId());
     }
 
+    /**
+     * @param string $feedback_level
+     * @param boolean|null $unsubscribe
+     */
     private function sendResponse(Codendi_Request $request, $feedback_level, $message, $unsubscribe) {
         if ($request->isAjax()) {
             $this->sendAjaxResponse($unsubscribe, $message);

plugins/tracker/include/Tracker/Artifact/Attachment/TemporaryFile.class.php

Doc Comments +3 added lines

@@ -71,6 +71,9 @@
         return $this->mimetype;
     }
 
+    /**
+     * @param string $size
+     */
     public function setSize($size) {
         $this->size = $size;
     }

plugins/tracker/include/Tracker/Artifact/Attachment/TemporaryFileDao.php

Doc Comments +11 added lines

@@ -21,6 +21,10 @@ 
 
 class Tracker_Artifact_Attachment_TemporaryFileManagerDao extends DataAccessObject {
 
+    /**
+     * @param integer $user_id
+     * @param string $tempname
+     */
     public function create($user_id, $name, $description, $mimetype, $timestamp, $tempname) {
         $user_id     = $this->da->escapeInt($user_id);
         $name        = $this->da->quoteSmart($name);
@@ -55,6 +59,10 @@ 
         return $file_id;
     }
 
+    /**
+     * @param integer $offset
+     * @param string $size
+     */
     public function updateFileInfo($file_id, $offset, $last_modified, $size) {
         $file_id       = $this->da->escapeInt($file_id);
         $offset        = $this->da->escapeInt($offset);
@@ -117,6 +125,9 @@ 
         return $this->update($sql);
     }
 
+    /**
+     * @param integer $user_id
+     */
     public function getUserTemporaryFiles($user_id) {
         $user_id = $this->da->escapeInt($user_id);
 

plugins/tracker/include/Tracker/Artifact/Attachment/TemporaryFileManager.class.php

Doc Comments +1 added lines, -1 removed lines

@@ -114,7 +114,7 @@
      * @param int    $offset
      * @param int    $size
      *
-     * @return \Tracker_Artifact_Attachment_PermissionDeniedOnFieldException
+     * @return string|null
      *
      * @throws Tracker_Artifact_Attachment_PermissionDeniedOnFieldException
      * @throws Tracker_Artifact_Attachment_FileNotFoundException

plugins/tracker/include/Tracker/Artifact/Changeset/IncomingMailDao.php

Doc Comments +6 added lines

@@ -20,6 +20,9 @@ 
 
 class Tracker_Artifact_Changeset_IncomingMailDao extends DataAccessObject {
 
+    /**
+     * @param integer $changeset_id
+     */
     public function save($changeset_id, $raw_mail) {
         $changeset_id = $this->da->escapeInt($changeset_id);
         $raw_mail     = $this->da->quoteSmart($raw_mail);
@@ -30,6 +33,9 @@ 
         return $this->update($sql);
     }
 
+    /**
+     * @param integer $artifact_id
+     */
     public function searchByArtifactId($artifact_id) {
         $artifact_id = $this->da->escapeInt($artifact_id);
 

plugins/tracker/include/Tracker/Artifact/Changeset/InitialChangesetCreatorBase.class.php

Doc Comments +3 added lines

@@ -96,6 +96,9 @@
         }
     }
 
+    /**
+     * @param integer $submitted_on
+     */
     private function createChangesetId(
         Tracker_Artifact $artifact,
         PFUser $submitter,

plugins/tracker/include/Tracker/Artifact/Changeset/NewChangesetCreatorBase.class.php

Doc Comments +10 added lines, -1 removed lines

@@ -56,7 +56,7 @@ 
      * @throws Tracker_Exception In the validation
      * @throws Tracker_NoChangeException In the validation
      *
-     * @return Tracker_Artifact_Changeset|Boolean The new changeset if update is done without error, false otherwise
+     * @return Tracker_Artifact_Changeset The new changeset if update is done without error, false otherwise
      */
     public function create(
         Tracker_Artifact $artifact,
@@ -152,6 +152,7 @@ 
 
     /**
      * @throws Tracker_FieldValueNotStoredException
+     * @param Tracker_Artifact_Changeset|null $previous_changeset
      */
     private function storeFieldsValues(Tracker_Artifact $artifact, $previous_changeset, array $fields_data, PFUser $submitter, $changeset_id) {
         $used_fields = $this->formelement_factory->getUsedFields($artifact->getTracker());
@@ -173,6 +174,10 @@ 
         return true;
     }
 
+    /**
+     * @param string $comment
+     * @param string $comment_format
+     */
     private function storeComment(
         Tracker_Artifact $artifact,
         $comment,
@@ -200,6 +205,10 @@ 
         return true;
     }
 
+    /**
+     * @param string $comment
+     * @param string|null $email
+     */
     private function validateNewChangeset(
         Tracker_Artifact $artifact,
         array $fields_data,

plugins/tracker/include/Tracker/Artifact/dao/PriorityDao.class.php

Doc Comments +3 added lines

@@ -188,6 +188,9 @@
         $this->update($sql);
     }
 
+    /**
+     * @param string $curr_id
+     */
     private function updateSuccessor($curr_id, $new_successor_id) {
         $equals_id = "IS NULL";
         if ($curr_id) {