silverstripe / silverstripe-dms

code/model/DMSDocument_versions.php

Doc Comments +2 added lines, -2 removed lines

@@ -197,8 +197,8 @@ 
      * Creates a new filename for the current Document's file when replacing the
      * current file with a new file.
      *
-     * @param DMSDocument $filename The original filename
      *
+     * @param integer $versionCounter
      * @return string The new filename
      */
     protected function generateVersionedFilename(DMSDocument $doc, $versionCounter)
@@ -242,7 +242,7 @@ 
     /**
      * Return the size of the file associated with the document.
      *
-     * @return string
+     * @return integer
      */
     public function getAbsoluteSize()
     {

code/tools/ShortCodeRelationFinder.php

Doc Comments +4 added lines

@@ -32,6 +32,9 @@ 
         return $found;
     }
 
+    /**
+     * @param integer $number
+     */
     public function findPageCount($number)
     {
         $list = $this->getList($number);
@@ -63,6 +66,7 @@ 
      * Returns a filtered list of fields which could contain shortcodes.
      *
      * @param String
+     * @param string $class
      * @return Array Map of class names to an array of field names on these classes.
      */
     public function getShortcodeFields($class)

tests/DMSEmbargoTest.php

Doc Comments +3 added lines

@@ -20,6 +20,9 @@
         self::$is_running_test = $this->originalIsRunningTest;
     }
 
+    /**
+     * @param integer $id
+     */
     public function createFakeHTTPRequest($id)
     {
         $r = new SS_HTTPRequest('GET', 'index/'.$id);

code/cms/DMSDocumentAddExistingField.php

Doc Comments +4 added lines

@@ -4,6 +4,10 @@
 {
     public $useFieldContext = true;
 
+    /**
+     * @param string $name
+     * @param string $title
+     */
     public function __construct($name, $title = null)
     {
         $this->name = $name;

code/DMS.php

Doc Comments +6 added lines, -2 removed lines

@@ -57,6 +57,9 @@ 
         return BASE_PATH . DIRECTORY_SEPARATOR . self::$dmsFolder;
     }
 
+    /**
+     * @return string
+     */
     public static function transform_file_to_file_path($file)
     {
         //confirm we have a file
@@ -77,7 +80,7 @@ 
     /**
      * Takes a File object or a String (path to a file) and copies it into the DMS. The original file remains unchanged.
      * When storing a document, sets the fields on the File has "tag" metadata.
-     * @param $file File object, or String that is path to a file to store,
+     * @param string $file File object, or String that is path to a file to store,
      *              e.g. "assets/documents/industry/supplied-v1-0.pdf"
      * @return DMSDocument
      */
@@ -149,7 +152,7 @@ 
 
     /**
      * Creates a storage folder for the given path
-     * @param $path Path to create a folder for
+     * @param string $path Path to create a folder for
      */
     public static function create_storage_folder($path)
     {
@@ -160,6 +163,7 @@ 
 
     /**
      * Calculates the storage path from a database DMSDocument ID
+     * @param integer $id
      */
     public static function get_storage_folder($id)
     {

tests/Stub/StubRelatedDocumentExtension.php

Doc Comments +1 added lines, -1 removed lines

@@ -17,7 +17,7 @@
     /**
      * For method {@link DMSDocumentSet::getDocuments}
      *
-     * @param  ArrayList $relatedDocuments
+     * @param  ArrayList $documents
      * @return ArrayList
      */
     public function updateDocuments($documents)

code/cms/DMSUploadField.php

Doc Comments +5 added lines, -1 removed lines

@@ -28,6 +28,7 @@ 
      * Override the default behaviour of the UploadField and take the uploaded file (uploaded to assets) and
      * add it into the DMS storage, deleting the old/uploaded file.
      * @param File
+     * @param File $file
      */
     protected function attachFile($file)
     {
@@ -54,6 +55,9 @@ 
         return $doc;
     }
 
+    /**
+     * @param string $validator
+     */
     public function validate($validator)
     {
         return true;
@@ -63,7 +67,7 @@ 
      * Action to handle upload of a single file
      *
      * @param SS_HTTPRequest $request
-     * @return string json
+     * @return SS_HTTPResponse json
      */
     public function upload(SS_HTTPRequest $request)
     {

code/tasks/MigrateToDocumentSetsTask.php

Doc Comments +3 added lines

@@ -40,6 +40,9 @@
      */
     protected $results = array();
 
+    /**
+     * @param SS_HTTPRequest $request
+     */
     public function run($request)
     {
         $this->request = $request;

code/model/DMSDocument.php

Doc Comments +6 added lines, -2 removed lines

@@ -103,6 +103,9 @@ 
         'permissions' => 'Permissions'
     );
 
+    /**
+     * @param DataObject $member
+     */
     public function canView($member = null)
     {
         if (!$member || !(is_a($member, 'Member')) || is_numeric($member)) {
@@ -1185,7 +1188,7 @@ 
     /**
      * Return the size of the file associated with the document.
      *
-     * @return string
+     * @return integer|null
      */
     public function getAbsoluteSize()
     {
@@ -1204,7 +1207,8 @@ 
 
 
     /**
-     * @return FieldList
+     * @param integer $relationListCount
+     * @return FieldGroup
      */
     protected function getFieldsForFile($relationListCount)
     {