phpDoc: added $var name to @param

Author: dg

src/Utils/ArrayList.php

@@ -42,7 +42,7 @@ public function count(): int
 
 	/**
 	 * Replaces or appends a item.
-	 * @param  int|null
+	 * @param  int|null  $index
 	 * @throws Nette\OutOfRangeException
 	 */
 	public function offsetSet($index, $value): void
@@ -61,7 +61,7 @@ public function offsetSet($index, $value): void
 
 	/**
 	 * Returns a item.
-	 * @param  int
+	 * @param  int  $index
 	 * @return mixed
 	 * @throws Nette\OutOfRangeException
 	 */
@@ -76,7 +76,7 @@ public function offsetGet($index)
 
 	/**
 	 * Determines whether a item exists.
-	 * @param  int
+	 * @param  int  $index
 	 */
 	public function offsetExists($index): bool
 	{
@@ -86,7 +86,7 @@ public function offsetExists($index): bool
 
 	/**
 	 * Removes the element at the specified position in this list.
-	 * @param  int
+	 * @param  int  $index
 	 * @throws Nette\OutOfRangeException
 	 */
 	public function offsetUnset($index): void

src/Utils/Callback.php

@@ -21,7 +21,7 @@ final class Callback
 	use Nette\StaticClass;
 
 	/**
-	 * @param  string|object|callable  class, object, callable
+	 * @param  string|object|callable  $callable  class, object, callable
 	 * @deprecated use Closure::fromCallable()
 	 */
 	public static function closure($callable, string $method = null): \Closure

src/Utils/DateTime.php

@@ -40,7 +40,7 @@ class DateTime extends \DateTime implements \JsonSerializable
 
 	/**
 	 * DateTime object factory.
-	 * @param  string|int|\DateTimeInterface
+	 * @param  string|int|\DateTimeInterface  $time
 	 * @return static
 	 */
 	public static function from($time)
@@ -91,7 +91,7 @@ public function modifyClone(string $modify = '')
 
 
 	/**
-	 * @param  int|string
+	 * @param  int|string  $timestamp
 	 * @return static
 	 */
 	public function setTimestamp($timestamp)
@@ -114,9 +114,9 @@ public function getTimestamp()
 
 	/**
 	 * Returns new DateTime object formatted according to the specified format.
-	 * @param  string The format the $time parameter should be in
-	 * @param  string String representing the time
-	 * @param  string|\DateTimeZone desired timezone (default timezone is used if null is passed)
+	 * @param  string  $format  The format the $time parameter should be in
+	 * @param  string  $time
+	 * @param  string|\DateTimeZone  $timezone (default timezone is used if null is passed)
 	 * @return static|false
 	 */
 	public static function createFromFormat($format, $time, $timezone = null)

src/Utils/Html.php

@@ -290,7 +290,7 @@ public function data(string $name, $value = null)
 
 	/**
 	 * Sets element's HTML content.
-	 * @param  IHtmlString|string
+	 * @param  IHtmlString|string  $html
 	 * @return static
 	 */
 	final public function setHtml($html)
@@ -311,7 +311,7 @@ final public function getHtml(): string
 
 	/**
 	 * Sets element's textual content.
-	 * @param  IHtmlString|string
+	 * @param  IHtmlString|string  $text
 	 * @return static
 	 */
 	final public function setText($text)
@@ -335,7 +335,7 @@ final public function getText(): string
 
 	/**
 	 * Adds new element's child.
-	 * @param  IHtmlString|string  Html node or raw HTML string
+	 * @param  IHtmlString|string  $child  Html node or raw HTML string
 	 * @return static
 	 */
 	final public function addHtml($child)
@@ -346,7 +346,7 @@ final public function addHtml($child)
 
 	/**
 	 * Appends plain-text string to element content.
-	 * @param  IHtmlString|string|int|float
+	 * @param  IHtmlString|string|int|float  $text
 	 * @return static
 	 */
 	public function addText($text)
@@ -391,8 +391,8 @@ public function insert(int $index = null, $child, bool $replace = false)
 
 	/**
 	 * Inserts (replaces) child node (\ArrayAccess implementation).
-	 * @param  int|null position or null for appending
-	 * @param  Html|string Html node or raw HTML string
+	 * @param  int|null  $index  position or null for appending
+	 * @param  Html|string  $child  Html node or raw HTML string
 	 */
 	final public function offsetSet($index, $child): void
 	{
@@ -402,7 +402,7 @@ final public function offsetSet($index, $child): void
 
 	/**
 	 * Returns child node (\ArrayAccess implementation).
-	 * @param  int
+	 * @param  int  $index
 	 * @return static|string
 	 */
 	final public function offsetGet($index)
@@ -413,7 +413,7 @@ final public function offsetGet($index)
 
 	/**
 	 * Exists child node? (\ArrayAccess implementation).
-	 * @param  int
+	 * @param  int  $index
 	 */
 	final public function offsetExists($index): bool
 	{
@@ -423,7 +423,7 @@ final public function offsetExists($index): bool
 
 	/**
 	 * Removes child node (\ArrayAccess implementation).
-	 * @param  int
+	 * @param  int  $index
 	 */
 	public function offsetUnset($index): void
 	{

src/Utils/Image.php

@@ -208,7 +208,7 @@ public static function fromBlank(int $width, int $height, array $color = null)
 
 	/**
 	 * Wraps GD image.
-	 * @param  resource
+	 * @param  resource  $image
 	 */
 	public function __construct($image)
 	{
@@ -237,7 +237,7 @@ public function getHeight(): int
 
 	/**
 	 * Sets image resource.
-	 * @param  resource
+	 * @param  resource  $image
 	 * @return static
 	 */
 	protected function setImageResource($image)
@@ -262,8 +262,8 @@ public function getImageResource()
 
 	/**
 	 * Resizes image.
-	 * @param  mixed  width in pixels or percent
-	 * @param  mixed  height in pixels or percent
+	 * @param  int|string  $width in pixels or percent
+	 * @param  int|string  $height in pixels or percent
 	 * @return static
 	 */
 	public function resize($width, $height, int $flags = self::FIT)
@@ -293,8 +293,8 @@ public function resize($width, $height, int $flags = self::FIT)
 
 	/**
 	 * Calculates dimensions of resized image.
-	 * @param  mixed  $newWidth in pixels or percent
-	 * @param  mixed  $newHeight in pixels or percent
+	 * @param  int|string  $newWidth in pixels or percent
+	 * @param  int|string  $newHeight in pixels or percent
 	 */
 	public static function calculateSize(int $srcWidth, int $srcHeight, $newWidth, $newHeight, int $flags = self::FIT): array
 	{
@@ -355,10 +355,10 @@ public static function calculateSize(int $srcWidth, int $srcHeight, $newWidth, $
 
 	/**
 	 * Crops image.
-	 * @param  mixed  x-offset in pixels or percent
-	 * @param  mixed  y-offset in pixels or percent
-	 * @param  mixed  width in pixels or percent
-	 * @param  mixed  height in pixels or percent
+	 * @param  int|string  $left in pixels or percent
+	 * @param  int|string  $top in pixels or percent
+	 * @param  int|string  $width in pixels or percent
+	 * @param  int|string  $height in pixels or percent
 	 * @return static
 	 */
 	public function crop($left, $top, $width, $height)
@@ -372,12 +372,10 @@ public function crop($left, $top, $width, $height)
 
 	/**
 	 * Calculates dimensions of cutout in image.
-	 * @param  int
-	 * @param  int
-	 * @param  mixed  x-offset in pixels or percent
-	 * @param  mixed  y-offset in pixels or percent
-	 * @param  mixed  width in pixels or percent
-	 * @param  mixed  height in pixels or percent
+	 * @param  int|string  $left in pixels or percent
+	 * @param  int|string  $top in pixels or percent
+	 * @param  int|string  $newWidth in pixels or percent
+	 * @param  int|string  $newHeight in pixels or percent
 	 */
 	public static function calculateCutout(int $srcWidth, int $srcHeight, $left, $top, $newWidth, $newHeight): array
 	{
@@ -424,10 +422,9 @@ public function sharpen()
 
 	/**
 	 * Puts another image into this image.
-	 * @param  Image
-	 * @param  mixed  x-coordinate in pixels or percent
-	 * @param  mixed  y-coordinate in pixels or percent
-	 * @param  int  opacity 0..100
+	 * @param  int|string  $left in pixels or percent
+	 * @param  int|string  $top in pixels or percent
+	 * @param  int  $opacity 0..100
 	 * @return static
 	 */
 	public function place(self $image, $left = 0, $top = 0, int $opacity = 100)

src/Utils/ObjectHelpers.php

@@ -126,7 +126,7 @@ public static function getMagicProperties(string $class): array
 
 	/**
 	 * Finds the best suggestion (for 8-bit encoding).
-	 * @param  (\ReflectionFunctionAbstract|\ReflectionParameter|\ReflectionClass|\ReflectionProperty|string)[]
+	 * @param  (\ReflectionFunctionAbstract|\ReflectionParameter|\ReflectionClass|\ReflectionProperty|string)[]  $possibilities
 	 * @internal
 	 */
 	public static function getSuggestion(array $possibilities, string $value): ?string

src/Utils/Strings.php

@@ -288,7 +288,7 @@ public static function compare(string $left, string $right, int $len = null): bo
 
 	/**
 	 * Finds the length of common prefix of strings.
-	 * @param  string[]
+	 * @param  string[]  $strings
 	 */
 	public static function findPrefix(array $strings): string
 	{
@@ -469,9 +469,8 @@ public static function matchAll(string $subject, string $pattern, int $flags = 0
 
 	/**
 	 * Perform a regular expression search and replace.
-	 * @param  string
-	 * @param  string|array
-	 * @param  string|callable
+	 * @param  string|array  $pattern
+	 * @param  string|callable  $replacement
 	 */
 	public static function replace(string $subject, $pattern, $replacement = null, int $limit = -1): string
 	{