nextcloud / server

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 {

lib/private/Avatar.php

Doc Comments +10 added lines, -2 removed lines

@@ -44,6 +44,12 @@ 
 
 class Color {
 	public $r, $g, $b;
+
+	/**
+	 * @param integer $r
+	 * @param integer $g
+	 * @param integer $b
+	 */
 	public function __construct($r, $g, $b) {
 		$this->r = $r;
 		$this->g = $g;
@@ -304,6 +310,7 @@ 
 	 * Calculate steps between two Colors
 	 * @param object Color $steps start color
 	 * @param object Color $ends end color
+	 * @param integer $steps
 	 * @return array [r,g,b] steps for each color to go from $steps to $ends
 	 */
 	private function stepCalc($steps, $ends) {
@@ -315,8 +322,9 @@ 
 	}
 	/**
 	 * Convert a string to an integer evenly
-	 * @param string $hash the text to parse
-	 * @param int $maximum the maximum range
+	 * @param integer $steps
+	 * @param Color $color1
+	 * @param Color $color2
 	 * @return int between 0 and $maximum
 	 */
 	private function mixPalette($steps, $color1, $color2) {

apps/user_ldap/lib/Access.php

Doc Comments +6 added lines, -5 removed lines

@@ -506,7 +506,7 @@ 
 
 	/**
 	 * returns the internal Nextcloud name for the given LDAP DN of the user, false on DN outside of search DN or failure
-	 * @param string $dn the dn of the user object
+	 * @param string $fdn the dn of the user object
 	 * @param string $ldapName optional, the display name of the object
 	 * @return string|false with with the name to use in Nextcloud
 	 */
@@ -805,7 +805,7 @@ 
 	 * the login filter.
 	 *
 	 * @param string $loginName
-	 * @param array $attributes optional, list of attributes to read
+	 * @param string[] $attributes optional, list of attributes to read
 	 * @return array
 	 */
 	public function fetchUsersByLoginName($loginName, $attributes = array('dn')) {
@@ -889,7 +889,7 @@ 
 
 	/**
 	 * @param string $filter
-	 * @param string|string[] $attr
+	 * @param string[] $attr
 	 * @param int $limit
 	 * @param int $offset
 	 * @return array
@@ -937,7 +937,7 @@ 
 
 	/**
 	 * @param string $filter
-	 * @param string|string[] $attr
+	 * @param string[] $attr
 	 * @param int $limit
 	 * @param int $offset
 	 * @return false|int
@@ -1036,7 +1036,7 @@ 
 	/**
 	 * retrieved. Results will according to the order in the array.
 	 *
-	 * @param $filter
+	 * @param string $filter
 	 * @param $base
 	 * @param string[]|string|null $attr
 	 * @param int $limit optional, maximum results to be counted
@@ -1331,6 +1331,7 @@ 
 	* escapes (user provided) parts for LDAP filter
 	* @param string $input, the provided value
 	* @param bool $allowAsterisk whether in * at the beginning should be preserved
+	* @param string $input
 	* @return string the escaped string
 	*/
 	public function escapeFilterPart($input, $allowAsterisk = false) {