Enalean / tuleap

plugins/cardwall/include/SwimlineTrackerRenderer.class.php

Doc Comments -1 removed lines

@@ -30,7 +30,6 @@
     public $swimline_id = self::FAKE_SWIMLINE_ID_FOR_TRACKER_RENDERER;
 
     /**
-     * @param string $title
      * @param array  $cells
      */
     public function __construct(array $cells) {

plugins/cardwall/tests/ColumnTest.php

Doc Comments +10 added lines

@@ -74,14 +74,24 @@
         $this->assertNotIn($column);
     }
 
+    /**
+     * @param Cardwall_Column $column
+     */
     private function assertIn($column) {
          $this->assertTrue($this->config->isInColumn($this->artifact, $this->field_provider, $column));
     }
     
+    /**
+     * @param Cardwall_Column $column
+     */
     private function assertNotIn($column) {
          $this->assertFalse($this->config->isInColumn($this->artifact, $this->field_provider, $column));
     }
 
+    /**
+     * @param integer $id
+     * @param string $label
+     */
     public function newCardwall_Column($id, $label) {
         $bgcolor = $fgcolor = 0;
         return new Cardwall_Column($id, $label, $bgcolor, $fgcolor);

plugins/docman/bin/DocmanExport/Docman_XMLExportVisitor.class.php

Doc Comments +9 added lines

@@ -117,6 +117,9 @@ 
         }
     }
     
+    /**
+     * @param DOMElement $mdNode
+     */
     protected function getNodeForMetadataValues($mdValues, $mdNode) {
         foreach($mdValues as $val) {
             if($val->getId() != 100) {
@@ -223,6 +226,9 @@ 
         return $this->userCache[$userId];
     }
     
+    /**
+     * @param integer $statusId
+     */
     protected function getNormalizedStatus($statusId) {
         switch($statusId) {
             case PLUGIN_DOCMAN_ITEM_STATUS_NONE:
@@ -242,6 +248,9 @@ 
         }
     }
     
+    /**
+     * @param string $label
+     */
     protected function appendChild(DOMElement $node, $label, $value) {
         if($value != '') {
             $subNode = $this->doc->createElement($label);

plugins/docman/bin/DocmanExport/XMLExport.class.php

Doc Comments +3 added lines

@@ -61,6 +61,9 @@
         return $doc;
     }
 
+    /**
+     * @param DOMDocument $doc
+     */
     public function appendDocman($doc) {
         $docmanExport = new Docman_XMLExport($this->logger);
         $docmanExport->setGroupId($this->groupId);

plugins/docman/bin/DocmanImport/ImportFromDocmanV1.class.php

Doc Comments +3 added lines

@@ -94,6 +94,9 @@
         );
     }
 
+    /**
+     * @param integer $folder_id
+     */
     private function importDump(Project $project, $folder_id) {
         $xml_import = new XMLDocmanImport(
             'import:',

plugins/docman/bin/DocmanImport/Trees.class.php

Doc Comments +1 added lines

@@ -117,6 +117,7 @@
     
     /**
      * Set recursively the given tag to all nodes of the tree
+     * @param string $tag
      */
     private static function tagTree(&$tree, $tag) {
         $tree['tag'] = $tag;

plugins/docman/bin/DocmanImport/XMLDocmanImport.class.php

Doc Comments +52 added lines, -2 removed lines

@@ -98,10 +98,17 @@ 
     /**
      * XMLDocmanImport constructor
      *
-     * @param int    $groupId  Group ID
      * @param string $wsdl     WSDL location
      * @param string $login    Login
      * @param string $password Password
+     * @param string $command
+     * @param string $project
+     * @param integer $projectId
+     * @param boolean $force
+     * @param boolean $reorder
+     * @param string $importMessageMetadata
+     * @param boolean $autoRetry
+     * @param boolean $log
      */
     public function __construct($command, $project, $projectId, $wsdl, $login, $password, $force, $reorder, $importMessageMetadata, $autoRetry, $log) {
 
@@ -150,6 +157,8 @@ 
     /**
      * Search the next file name that can be used
      * If the file "name" exists in the folder, the next name to use is "name (2)", then "name (3)", etc.
+     * @param string $folder
+     * @param string $fileName
      */
     private function searchNextFreeFileName($folder, $fileName) {
 
@@ -245,6 +254,8 @@ 
 
     /**
      * Import an item to the specified parent folder
+     * @param string $xmlDoc
+     * @param string $path
      */
     public function importPath($xmlDoc, $parentId, $path) {
 
@@ -679,6 +690,7 @@ 
 
     /**
      * Converts a string to a type code
+     * @param string $type
      */
     private static function typeStringToCode($type) {
         switch ($type) {
@@ -692,6 +704,7 @@ 
 
     /**
      * Displays an error and terminates execution of the script
+     * @param string $error
      */
     protected function exitError($error) {
         exit (PHP_EOL."Fatal error: ".PHP_EOL.$error.PHP_EOL);
@@ -754,6 +767,7 @@ 
 
     /**
      * Parse a date given as an ISO8601 date or a timestamp
+     * @param string $s
      * @return The corresponding timestamp
      */
     private function parseDate($s) {
@@ -956,6 +970,9 @@ 
 
     }
 
+    /**
+     * @param Exception $e
+     */
     protected function askWhatToDo($e) {
         self::printException($e);
 
@@ -994,6 +1011,8 @@ 
 
     /**
      * Creates a folder
+     * @param integer $parentId
+     * @param string $ordering
      */
     private function createFolder($parentId, $title, $description, $ordering, $status, array $permissions, array $metadata, $owner, $createDate, $updateDate) {
         $this->initRetryCounter();
@@ -1014,6 +1033,8 @@ 
 
     /**
      * Creates an empty document
+     * @param integer $parentId
+     * @param string $ordering
      */
     private function createEmpty($parentId, $title, $description, $ordering, $status, $obsolescenceDate, array $permissions, array $metadata, $owner, $createDate, $updateDate) {
         $this->initRetryCounter();
@@ -1034,6 +1055,9 @@ 
 
     /**
      * Creates a wiki page
+     * @param integer $parentId
+     * @param string $ordering
+     * @param string $pagename
      */
     private function createWiki($parentId, $title, $description, $ordering, $status, $obsolescenceDate, array $permissions, array $metadata, $pagename, $owner, $createDate, $updateDate) {
         $this->initRetryCounter();
@@ -1054,6 +1078,9 @@ 
 
     /**
      * Creates a link
+     * @param integer $parentId
+     * @param string $ordering
+     * @param string $url
      */
     private function createLink($parentId, $title, $description, $ordering, $status, $obsolescenceDate, array $permissions, array $metadata, $url, $owner, $createDate, $updateDate) {
         $this->initRetryCounter();
@@ -1074,6 +1101,10 @@ 
 
     /**
      * Creates an embedded file
+     * @param integer $parentId
+     * @param string $ordering
+     * @param string $file
+     * @param string $author
      */
     private function createEmbeddedFile($parentId, $title, $description, $ordering, $status, $obsolescenceDate, array $permissions, array $metadata, $file, $author, $date, $owner, $createDate, $updateDate) {
         $this->initRetryCounter();
@@ -1096,6 +1127,12 @@ 
 
     /**
      * Creates a file
+     * @param integer $parentId
+     * @param string $ordering
+     * @param string $file
+     * @param string $fileName
+     * @param string $fileType
+     * @param string $author
      */
     private function createFile($parentId, $title, $description, $ordering, $status, $obsolescenceDate, array $permissions, array $metadata, $file, $fileName, $fileType, $author, $date, $owner, $createDate, $updateDate) {
         $infoStr = "Creating file              '$title' ($file, $fileName, $fileType)";
@@ -1157,7 +1194,8 @@ 
     /**
      * Compares the local and the distant checksums
      *
-     * @return true if they are the same
+     * @param string $filename
+     * @return boolean if they are the same
      */
     private function checkChecksum($item_id, $filename) {
 
@@ -1178,6 +1216,12 @@ 
 
     /**
      * Create a new file version
+     * @param string $label
+     * @param string $changeLog
+     * @param string $file
+     * @param string $fileName
+     * @param string $fileType
+     * @param string $author
      */
     protected function createFileVersion($itemId, $label, $changeLog, $file, $fileName, $fileType, $author, $date) {
         $infoStr = "                      Version '$label' ($file, $fileName, $fileType)";
@@ -1232,6 +1276,12 @@ 
         }
     }
 
+    /**
+     * @param string $label
+     * @param string $changeLog
+     * @param string $file
+     * @param string $author
+     */
     protected function createEmbeddedFileVersion($itemId, $label, $changeLog, $file, $author, $date) {
         $this->initRetryCounter();
         do {

plugins/docman/bin/DocmanImport/XMLDocmanUpdate.class.php

Doc Comments +3 added lines, -1 removed lines

@@ -294,7 +294,7 @@ 
     /**
      * Compares the version checksums in order to decide what to do.
      * For each version of the item, the checksum of the local file and the remote file are compared
-     * @return true  if we just have to send the new versions to the server
+     * @return boolean  if we just have to send the new versions to the server
      *         false if some versions have been created server-side (so we will need to delete and recreate the whole item)
      */
     private function checkVersionChecksums($itemId, $node) {
@@ -510,6 +510,7 @@ 
     
     /**
      * Updates a wiki document
+     * @param string $pageName
      */
     private function updateWiki($itemId, $itemInfo, $pageName) {
         // Assign variables
@@ -542,6 +543,7 @@ 
     
     /**
      * Updates a link
+     * @param string $url
      */
     private function updateLink($itemId, $itemInfo, $url) {
         // Assign variables

plugins/docman/include/ApprovalTable/ApprovalTable.class.php

Doc Comments +4 added lines

@@ -172,6 +172,10 @@
 
     // Reviewers management
     // Should be managed with SplObjectStorage in Php 5
+
+    /**
+     * @param Docman_ApprovalReviewer $reviewer
+     */
     function addReviewer($reviewer) {
         $this->reviewers[$reviewer->getId()] = $reviewer;
     }