owncloud / core

lib/private/connector/sabre/tagsplugin.php

Doc Comments +1 added lines, -4 removed lines

@@ -254,11 +254,8 @@
 	/**
 	 * Updates tags and favorites properties, if applicable.
 	 *
-	 * @param string $path
 	 * @param \Sabre\DAV\INode $node
-	 * @param array $requestedProperties
-	 * @param array $returnedProperties
-	 * @return bool success status
+	 * @return null|boolean success status
 	 */
 	public function updateProperties(array &$properties, array &$result, \Sabre\DAV\INode $node) {
 		if (!($node instanceof \OC_Connector_Sabre_Node)) {

lib/private/db/connection.php

Doc Comments +1 added lines, -1 removed lines

@@ -141,7 +141,7 @@
 	 * columns or sequences.
 	 *
 	 * @param string $seqName Name of the sequence object from which the ID should be returned.
-	 * @return string A string representation of the last inserted ID.
+	 * @return integer A string representation of the last inserted ID.
 	 */
 	public function lastInsertId($seqName = null)
 	{

lib/private/files/cache/scanner.php

Doc Comments +3 added lines

@@ -144,6 +144,9 @@
 		return true;
 	}
 
+	/**
+	 * @param string $path
+	 */
 	public function url_stat($path) {
 		if (isset(self::$data[$path])) {
 			$size = strlen(self::$data[$path]);

lib/private/files/cache/wrapper/cachejail.php

Doc Comments +1 added lines, -1 removed lines

@@ -247,7 +247,7 @@
 	 * use the one with the highest id gives the best result with the background scanner, since that is most
 	 * likely the folder where we stopped scanning previously
 	 *
-	 * @return string|bool the path of the folder or false when no folder matched
+	 * @return boolean the path of the folder or false when no folder matched
 	 */
 	public function getIncomplete() {
 		// not supported

lib/private/files/filesystem.php

Doc Comments +55 added lines

@@ -173,6 +173,7 @@ 
 
 	/**
 	 * @param callable $wrapper
+	 * @param string $wrapperName
 	 */
 	public static function addStorageWrapper($wrapperName, $wrapper) {
 		$mounts = self::getMountManager()->getAll();
@@ -299,6 +300,9 @@ 
 		}
 	}
 
+	/**
+	 * @param string $root
+	 */
 	static public function init($user, $root) {
 		if (self::$defaultInstance) {
 			return false;
@@ -565,11 +569,15 @@ 
 
 	/**
 	 * following functions are equivalent to their php builtin equivalents for arguments/return values.
+	 * @param string $path
 	 */
 	static public function mkdir($path) {
 		return self::$defaultInstance->mkdir($path);
 	}
 
+	/**
+	 * @param string $path
+	 */
 	static public function rmdir($path) {
 		return self::$defaultInstance->rmdir($path);
 	}
@@ -582,10 +590,16 @@ 
 		return self::$defaultInstance->readdir($path);
 	}
 
+	/**
+	 * @param string|null $path
+	 */
 	static public function is_dir($path) {
 		return self::$defaultInstance->is_dir($path);
 	}
 
+	/**
+	 * @param string $path
+	 */
 	static public function is_file($path) {
 		return self::$defaultInstance->is_file($path);
 	}
@@ -598,10 +612,16 @@ 
 		return self::$defaultInstance->filetype($path);
 	}
 
+	/**
+	 * @param string $path
+	 */
 	static public function filesize($path) {
 		return self::$defaultInstance->filesize($path);
 	}
 
+	/**
+	 * @param string $path
+	 */
 	static public function readfile($path) {
 		return self::$defaultInstance->readfile($path);
 	}
@@ -610,6 +630,9 @@ 
 		return self::$defaultInstance->isCreatable($path);
 	}
 
+	/**
+	 * @param string $path
+	 */
 	static public function isReadable($path) {
 		return self::$defaultInstance->isReadable($path);
 	}
@@ -622,6 +645,9 @@ 
 		return self::$defaultInstance->isDeletable($path);
 	}
 
+	/**
+	 * @param string $path
+	 */
 	static public function isSharable($path) {
 		return self::$defaultInstance->isSharable($path);
 	}
@@ -634,33 +660,56 @@ 
 		return self::$defaultInstance->filemtime($path);
 	}
 
+	/**
+	 * @param string $path
+	 * @param integer $mtime
+	 */
 	static public function touch($path, $mtime = null) {
 		return self::$defaultInstance->touch($path, $mtime);
 	}
 
 	/**
+	 * @param string $path
 	 * @return string
 	 */
 	static public function file_get_contents($path) {
 		return self::$defaultInstance->file_get_contents($path);
 	}
 
+	/**
+	 * @param string $path
+	 * @param string $data
+	 */
 	static public function file_put_contents($path, $data) {
 		return self::$defaultInstance->file_put_contents($path, $data);
 	}
 
+	/**
+	 * @param string $path
+	 */
 	static public function unlink($path) {
 		return self::$defaultInstance->unlink($path);
 	}
 
+	/**
+	 * @param string $path1
+	 * @param string $path2
+	 */
 	static public function rename($path1, $path2) {
 		return self::$defaultInstance->rename($path1, $path2);
 	}
 
+	/**
+	 * @param string $path2
+	 */
 	static public function copy($path1, $path2) {
 		return self::$defaultInstance->copy($path1, $path2);
 	}
 
+	/**
+	 * @param string|null $path
+	 * @param string $mode
+	 */
 	static public function fopen($path, $mode) {
 		return self::$defaultInstance->fopen($path, $mode);
 	}
@@ -676,6 +725,9 @@ 
 		return self::$defaultInstance->fromTmpFile($tmpFile, $path);
 	}
 
+	/**
+	 * @param string $path
+	 */
 	static public function getMimeType($path) {
 		return self::$defaultInstance->getMimeType($path);
 	}
@@ -688,6 +740,9 @@ 
 		return self::$defaultInstance->free_space($path);
 	}
 
+	/**
+	 * @param string $query
+	 */
 	static public function search($query) {
 		return self::$defaultInstance->search($query);
 	}

lib/private/files/storage/dav.php

Doc Comments +1 added lines, -1 removed lines

@@ -562,7 +562,7 @@
 	 * This will either throw StorageInvalidException, StorageNotAvailableException
 	 * or do nothing.
 	 *
-	 * @param \Sabre\Dav\Exception $e sabre exception
+	 * @param \Exception $e sabre exception
 	 *
 	 * @throws StorageInvalidException if the storage is invalid, for example
 	 * when the authentication expired or is invalid

lib/private/files/view.php

Doc Comments +9 added lines, -2 removed lines

@@ -134,7 +134,7 @@ 
 	 * and doesn't take the chroot into account )
 	 *
 	 * @param string $path
-	 * @return \OCP\Files\Mount\IMountPoint
+	 * @return Mount\MountPoint|null
 	 */
 	public function getMount($path) {
 		return Filesystem::getMountManager()->find($this->getAbsolutePath($path));
@@ -366,6 +366,10 @@ 
 		return $this->basicOperation('file_get_contents', $path, array('read'));
 	}
 
+	/**
+	 * @param string|null $path
+	 * @param boolean $run
+	 */
 	protected function emit_file_hooks_pre($exists, $path, &$run) {
 		if (!$exists) {
 			\OC_Hook::emit(Filesystem::CLASSNAME, Filesystem::signal_create, array(
@@ -384,6 +388,9 @@ 
 		));
 	}
 
+	/**
+	 * @param string|null $path
+	 */
 	protected function emit_file_hooks_post($exists, $path) {
 		if (!$exists) {
 			\OC_Hook::emit(Filesystem::CLASSNAME, Filesystem::signal_post_create, array(
@@ -591,7 +598,7 @@ 
 	 * @param string $path2 target path
 	 * @param bool $preserveMtime whether to preserve mtime on the copy
 	 *
-	 * @return bool|mixed
+	 * @return string
 	 */
 	public function copy($path1, $path2, $preserveMtime = false) {
 		$postFix1 = (substr($path1, -1, 1) === '/') ? '/' : '';

lib/private/helper.php

Doc Comments +6 added lines, -3 removed lines

@@ -103,7 +103,7 @@ 
 	 * @param string $route
 	 * @param array $parameters
 	 * @return
-	 * @internal param array $args with param=>value, will be appended to the returned url
+	 string @internal param array $args with param=>value, will be appended to the returned url
 	 * @return string the url
 	 *
 	 * Returns a url to the given app and file.
@@ -277,6 +277,9 @@ 
 		return self::linkToRoute( 'core_ajax_preview', array('x' => 36, 'y' => 36, 'file' => $path ));
 	}
 
+	/**
+	 * @param string $path
+	 */
 	public static function publicPreviewIcon( $path, $token ) {
 		return self::linkToRoute( 'core_ajax_public_preview', array('x' => 36, 'y' => 36, 'file' => $path, 't' => $token));
 	}
@@ -360,7 +363,7 @@ 
 	/**
 	 * Make a computer file size
 	 * @param string $str file size in human readable format
-	 * @return int a file size in bytes
+	 * @return double a file size in bytes
 	 *
 	 * Makes 2kB to 2048.
 	 *
@@ -913,7 +916,7 @@ 
 	 *
 	 * @param string $path
 	 * @param \OCP\Files\FileInfo $rootInfo (optional)
-	 * @return array
+	 * @return string
 	 */
 	public static function getStorageInfo($path, $rootInfo = null) {
 		// return storage info without adding mount points

lib/private/l10n.php

Doc Comments +1 added lines, -1 removed lines

@@ -80,7 +80,7 @@
 	}
 
 	/**
-	 * @param $transFile
+	 * @param string $transFile
 	 * @param bool $mergeTranslations
 	 * @return bool
 	 */