nextcloud / server

lib/private/User/Session.php

Doc Comments +4 added lines, -1 removed lines

@@ -339,7 +339,7 @@ 
 	 * @param IUser $user
 	 * @param array $loginDetails
 	 * @param bool $regenerateSessionId
-	 * @return true returns true if login successful or an exception otherwise
+	 * @return boolean returns true if login successful or an exception otherwise
 	 * @throws LoginException
 	 */
 	public function completeLogin(IUser $user, array $loginDetails, $regenerateSessionId = true) {
@@ -446,6 +446,9 @@ 
 		return $this->config->getSystemValue('token_auth_enforced', false);
 	}
 
+	/**
+	 * @param string $username
+	 */
 	protected function isTwoFactorEnforced($username) {
 		Util::emitHook(
 			'\OCA\Files_Sharing\API\Server2Server',

apps/files_external/lib/Lib/Storage/AmazonS3.php

Doc Comments +10 added lines, -1 removed lines

@@ -85,6 +85,9 @@ 
 		return $path === '.';
 	}
 
+	/**
+	 * @param string $path
+	 */
 	private function cleanKey($path) {
 		if ($this->isRoot($path)) {
 			return '/';
@@ -108,7 +111,7 @@ 
 	}
 
 	/**
-	 * @param $key
+	 * @param string $key
 	 * @return Result|boolean
 	 */
 	private function headObject($key) {
@@ -234,6 +237,9 @@ 
 		}
 	}
 
+	/**
+	 * @param string $path
+	 */
 	private function batchDelete($path = null) {
 		$params = array(
 			'Bucket' => $this->bucket
@@ -579,6 +585,9 @@ 
 		return $this->id;
 	}
 
+	/**
+	 * @param string $path
+	 */
 	public function writeBack($tmpFile, $path) {
 		try {
 			$source = fopen($tmpFile, 'r');

lib/private/Comments/Manager.php

Doc Comments +1 added lines, -1 removed lines

@@ -213,7 +213,7 @@
 	/**
 	 * removes an entry from the comments run time cache
 	 *
-	 * @param mixed $id the comment's id
+	 * @param string $id the comment's id
 	 */
 	protected function uncache($id) {
 		$id = (string)$id;

lib/private/Share20/Manager.php

Doc Comments +5 added lines, -2 removed lines

@@ -575,7 +575,7 @@ 
 	 * Share a path
 	 *
 	 * @param \OCP\Share\IShare $share
-	 * @return Share The share object
+	 * @return Share\IShare The share object
 	 * @throws \Exception
 	 *
 	 * TODO: handle link share permissions or check them
@@ -1161,7 +1161,7 @@ 
 	 * Get the share by token possible with password
 	 *
 	 * @param string $token
-	 * @return Share
+	 * @return Share\IShare
 	 *
 	 * @throws ShareNotFound
 	 */
@@ -1223,6 +1223,9 @@ 
 		return $share;
 	}
 
+	/**
+	 * @param Share\IShare $share
+	 */
 	protected function checkExpireDate($share) {
 		if ($share->getExpirationDate() !== null &&
 			$share->getExpirationDate() <= new \DateTime()) {

apps/files/lib/Activity/Provider.php

Doc Comments +6 added lines

@@ -112,6 +112,9 @@ 
 		return $this->parseLongVersion($event, $previousEvent);
 	}
 
+	/**
+	 * @param string $icon
+	 */
 	protected function setIcon(IEvent $event, $icon) {
 		if ($this->activityManager->getRequirePNG()) {
 			$event->setIcon($this->url->getAbsoluteURL($this->url->imagePath('files', $icon . '.png')));
@@ -252,6 +255,9 @@ 
 		return $event;
 	}
 
+	/**
+	 * @param string $subject
+	 */
 	protected function setSubjects(IEvent $event, $subject, array $parameters) {
 		$placeholders = $replacements = [];
 		foreach ($parameters as $placeholder => $parameter) {

apps/files_external/lib/Lib/Storage/Swift.php

Doc Comments +4 added lines, -1 removed lines

@@ -83,7 +83,7 @@ 
 
 	/**
 	 * @param string $path
-	 * @return mixed|string
+	 * @return string
 	 */
 	private function normalizePath(string $path) {
 		$path = trim($path, '/');
@@ -570,6 +570,9 @@ 
 		return $this->container;
 	}
 
+	/**
+	 * @param string $path
+	 */
 	public function writeBack($tmpFile, $path) {
 		$fileData = fopen($tmpFile, 'r');
 		$this->objectStore->writeObject($path, $fileData);

lib/private/legacy/app.php

Doc Comments +1 added lines, -1 removed lines

@@ -269,7 +269,7 @@
 	 * check if an app is of a specific type
 	 *
 	 * @param string $app
-	 * @param array $types
+	 * @param string[] $types
 	 * @return bool
 	 */
 	public static function isType(string $app, array $types): bool {

lib/private/AppFramework/Utility/ControllerMethodReflector.php

Doc Comments +1 added lines, -1 removed lines

@@ -40,7 +40,7 @@
 	private $parameters = [];
 
 	/**
-	 * @param object $object an object or classname
+	 * @param \OCP\AppFramework\Controller $object an object or classname
 	 * @param string $method the method which we want to inspect
 	 */
 	public function reflect($object, string $method){

lib/private/Session/Internal.php

Doc Comments +1 added lines, -1 removed lines

@@ -166,7 +166,7 @@
 	 * @param array $parameters
 	 * @param bool $silence whether to suppress warnings
 	 * @throws \ErrorException via trapError
-	 * @return mixed
+	 * @return string
 	 */
 	private function invoke(string $functionName, array $parameters = [], bool $silence = false) {
 		try {