phpDoc: added $var name to @param

src/Forms/Container.php

@@ -128,7 +128,7 @@ public function isValid(): bool
 
 	/**
 	 * Performs the server side validation.
-	 * @param  IControl[]
+	 * @param  IControl[]  $controls
 	 */
 	public function validate(array $controls = null): void
 	{
@@ -224,7 +224,7 @@ public function getForm(bool $throw = true): ?Form
 
 	/**
 	 * Adds single-line text input control to the form.
-	 * @param  string|object $label
+	 * @param  string|object  $label
 	 */
 	public function addText(string $name, $label = null, int $cols = null, int $maxLength = null): Controls\TextInput
 	{
@@ -235,7 +235,7 @@ public function addText(string $name, $label = null, int $cols = null, int $maxL
 
 	/**
 	 * Adds single-line text input control used for sensitive input such as passwords.
-	 * @param  string|object $label
+	 * @param  string|object  $label
 	 */
 	public function addPassword(string $name, $label = null, int $cols = null, int $maxLength = null): Controls\TextInput
 	{
@@ -247,7 +247,7 @@ public function addPassword(string $name, $label = null, int $cols = null, int $
 
 	/**
 	 * Adds multi-line text input control to the form.
-	 * @param  string|object $label
+	 * @param  string|object  $label
 	 */
 	public function addTextArea(string $name, $label = null, int $cols = null, int $rows = null): Controls\TextArea
 	{
@@ -258,7 +258,7 @@ public function addTextArea(string $name, $label = null, int $cols = null, int $
 
 	/**
 	 * Adds input for email.
-	 * @param  string|object $label
+	 * @param  string|object  $label
 	 */
 	public function addEmail(string $name, $label = null): Controls\TextInput
 	{
@@ -270,7 +270,7 @@ public function addEmail(string $name, $label = null): Controls\TextInput
 
 	/**
 	 * Adds input for integer.
-	 * @param  string|object $label
+	 * @param  string|object  $label
 	 */
 	public function addInteger(string $name, $label = null): Controls\TextInput
 	{
@@ -283,7 +283,7 @@ public function addInteger(string $name, $label = null): Controls\TextInput
 
 	/**
 	 * Adds control that allows the user to upload files.
-	 * @param  string|object $label
+	 * @param  string|object  $label
 	 */
 	public function addUpload(string $name, $label = null): Controls\UploadControl
 	{
@@ -297,7 +297,7 @@ public function addUpload(string $name, $label = null): Controls\UploadControl
 
 	/**
 	 * Adds control that allows the user to upload multiple files.
-	 * @param  string|object $label
+	 * @param  string|object  $label
 	 */
 	public function addMultiUpload(string $name, $label = null): Controls\UploadControl
 	{
@@ -317,7 +317,7 @@ public function addHidden(string $name, string $default = null): Controls\Hidden
 
 	/**
 	 * Adds check box control to the form.
-	 * @param  string|object $caption
+	 * @param  string|object  $caption
 	 */
 	public function addCheckbox(string $name, $caption = null): Controls\Checkbox
 	{
@@ -327,7 +327,7 @@ public function addCheckbox(string $name, $caption = null): Controls\Checkbox
 
 	/**
 	 * Adds set of radio button controls to the form.
-	 * @param  string|object $label
+	 * @param  string|object  $label
 	 */
 	public function addRadioList(string $name, $label = null, array $items = null): Controls\RadioList
 	{
@@ -337,7 +337,7 @@ public function addRadioList(string $name, $label = null, array $items = null):
 
 	/**
 	 * Adds set of checkbox controls to the form.
-	 * @param  string|object $label
+	 * @param  string|object  $label
 	 */
 	public function addCheckboxList(string $name, $label = null, array $items = null): Controls\CheckboxList
 	{
@@ -347,7 +347,7 @@ public function addCheckboxList(string $name, $label = null, array $items = null
 
 	/**
 	 * Adds select box control that allows single item selection.
-	 * @param  string|object $label
+	 * @param  string|object  $label
 	 */
 	public function addSelect(string $name, $label = null, array $items = null, int $size = null): Controls\SelectBox
 	{
@@ -358,7 +358,7 @@ public function addSelect(string $name, $label = null, array $items = null, int
 
 	/**
 	 * Adds select box control that allows multiple item selection.
-	 * @param  string|object $label
+	 * @param  string|object  $label
 	 */
 	public function addMultiSelect(string $name, $label = null, array $items = null, int $size = null): Controls\MultiSelectBox
 	{
@@ -369,7 +369,7 @@ public function addMultiSelect(string $name, $label = null, array $items = null,
 
 	/**
 	 * Adds button used to submit form.
-	 * @param  string|object $caption
+	 * @param  string|object  $caption
 	 */
 	public function addSubmit(string $name, $caption = null): Controls\SubmitButton
 	{
@@ -379,7 +379,7 @@ public function addSubmit(string $name, $caption = null): Controls\SubmitButton
 
 	/**
 	 * Adds push buttons with no default behavior.
-	 * @param  string|object $caption
+	 * @param  string|object  $caption
 	 */
 	public function addButton(string $name, $caption = null): Controls\Button
 	{
@@ -389,8 +389,8 @@ public function addButton(string $name, $caption = null): Controls\Button
 
 	/**
 	 * Adds graphical button used to submit form.
-	 * @param  string $src  URI of the image
-	 * @param  string $alt  alternate text for the image
+	 * @param  string  $src  URI of the image
+	 * @param  string  $alt  alternate text for the image
 	 */
 	public function addImage(string $name, string $src = null, string $alt = null): Controls\ImageButton
 	{
@@ -400,7 +400,7 @@ public function addImage(string $name, string $src = null, string $alt = null):
 
 	/**
 	 * Adds naming container to the form.
-	 * @param  string|int
+	 * @param  string|int  $name
 	 */
 	public function addContainer($name): self
 	{

src/Forms/Controls/BaseControl.php

@@ -79,7 +79,7 @@ abstract class BaseControl extends Nette\ComponentModel\Component implements ICo
 
 
 	/**
-	 * @param  string|object
+	 * @param  string|object  $caption
 	 */
 	public function __construct($caption = null)
 	{
@@ -102,7 +102,7 @@ public function __construct($caption = null)
 
 	/**
 	 * Sets textual caption or label.
-	 * @param object|string
+	 * @param object|string  $caption
 	 * @return static
 	 */
 	public function setCaption($caption)
@@ -274,7 +274,7 @@ public function getControl()
 
 	/**
 	 * Generates label's HTML element.
-	 * @param  string|object
+	 * @param  string|object  $caption
 	 * @return Html|string
 	 */
 	public function getLabel($caption = null)
@@ -320,7 +320,7 @@ public function getLabelPrototype(): Html
 
 	/**
 	 * Changes control's HTML id.
-	 * @param  mixed  new ID, or false or null
+	 * @param  string|bool|null  $id
 	 * @return static
 	 */
 	public function setHtmlId($id)
@@ -413,8 +413,8 @@ public function translate($value, int $count = null)
 
 	/**
 	 * Adds a validation rule.
-	 * @param  mixed
-	 * @param  string|object
+	 * @param  callable|string  $validator
+	 * @param  string|object  $errorMessage
 	 * @return static
 	 */
 	public function addRule($validator, $errorMessage = null, $arg = null)
@@ -452,7 +452,7 @@ public function getRules(): Rules
 
 	/**
 	 * Makes control mandatory.
-	 * @param  mixed  state or error message
+	 * @param  boo|string|object  $value
 	 * @return static
 	 */
 	public function setRequired($value = true)
@@ -486,7 +486,7 @@ public function validate(): void
 
 	/**
 	 * Adds error message to the list.
-	 * @param  string|object
+	 * @param  string|object  $message
 	 */
 	public function addError($message, bool $translate = true): void
 	{

src/Forms/Controls/Button.php

@@ -19,7 +19,7 @@ class Button extends BaseControl
 {
 
 	/**
-	 * @param  string|object
+	 * @param  string|object  $caption
 	 */
 	public function __construct($caption = null)
 	{
@@ -49,7 +49,7 @@ public function getLabel($caption = null): void
 
 	/**
 	 * Generates control's HTML element.
-	 * @param  string|object
+	 * @param  string|object  $caption
 	 */
 	public function getControl($caption = null): Nette\Utils\Html
 	{

src/Forms/Controls/Checkbox.php

@@ -23,7 +23,7 @@ class Checkbox extends BaseControl
 
 
 	/**
-	 * @param  string|object
+	 * @param  string|object  $label
 	 */
 	public function __construct($label = null)
 	{

src/Forms/Controls/CheckboxList.php

@@ -33,7 +33,7 @@ class CheckboxList extends MultiChoiceControl
 
 
 	/**
-	 * @param  string|object
+	 * @param  string|object  $label
 	 */
 	public function __construct($label = null, array $items = null)
 	{
@@ -74,7 +74,7 @@ public function getControl(): Html
 
 	/**
 	 * Generates label's HTML element.
-	 * @param  string|object
+	 * @param  string|object  $caption
 	 */
 	public function getLabel($caption = null): Html
 	{

src/Forms/Controls/ChoiceControl.php

@@ -57,7 +57,7 @@ public function loadHttpData(): void
 
 	/**
 	 * Sets selected item (by key).
-	 * @param  string|int
+	 * @param  string|int  $value
 	 * @return static
 	 * @internal
 	 */
@@ -134,7 +134,7 @@ public function getSelectedItem()
 
 	/**
 	 * Disables or enables control or items.
-	 * @param  bool|array
+	 * @param  bool|array  $value
 	 * @return static
 	 */
 	public function setDisabled($value = true)

src/Forms/Controls/CsrfProtection.php

@@ -25,7 +25,7 @@ class CsrfProtection extends HiddenField
 
 
 	/**
-	 * @param string|object
+	 * @param string|object  $errorMessage
 	 */
 	public function __construct($errorMessage)
 	{

src/Forms/Controls/HiddenField.php

@@ -68,7 +68,7 @@ public function getControl(): Nette\Utils\Html
 
 	/**
 	 * Bypasses label generation.
-	 * @param  string|object
+	 * @param  string|object  $caption
 	 */
 	public function getLabel($caption = null): void
 	{
@@ -77,7 +77,7 @@ public function getLabel($caption = null): void
 
 	/**
 	 * Adds error message to the list.
-	 * @param  string|object
+	 * @param  string|object  $message
 	 */
 	public function addError($message, bool $translate = true): void
 	{

src/Forms/Controls/ImageButton.php

@@ -17,8 +17,8 @@ class ImageButton extends SubmitButton
 {
 
 	/**
-	 * @param  string  URI of the image
-	 * @param  string  alternate text for the image
+	 * @param  string  $src  URI of the image
+	 * @param  string  $alt  alternate text for the image
 	 */
 	public function __construct(string $src = null, string $alt = null)
 	{

src/Forms/Controls/MultiChoiceControl.php

@@ -139,7 +139,7 @@ public function getSelectedItems(): array
 
 	/**
 	 * Disables or enables control or items.
-	 * @param  bool|array
+	 * @param  bool|bool[]  $value
 	 * @return static
 	 */
 	public function setDisabled($value = true)

src/Forms/Controls/RadioList.php

@@ -36,7 +36,7 @@ class RadioList extends ChoiceControl
 
 
 	/**
-	 * @param  string|object
+	 * @param  string|object  $label
 	 */
 	public function __construct($label = null, array $items = null)
 	{
@@ -81,7 +81,7 @@ public function getControl(): Html
 
 	/**
 	 * Generates label's HTML element.
-	 * @param  string|object
+	 * @param  string|object  $caption
 	 */
 	public function getLabel($caption = null): Html
 	{

src/Forms/Controls/SelectBox.php

@@ -41,7 +41,7 @@ public function __construct($label = null, array $items = null)
 
 	/**
 	 * Sets first prompt item in select box.
-	 * @param  string|object
+	 * @param  string|object  $prompt
 	 * @return static
 	 */
 	public function setPrompt($prompt)

src/Forms/Controls/SubmitButton.php

@@ -30,7 +30,7 @@ class SubmitButton extends Button implements Nette\Forms\ISubmitterControl
 
 
 	/**
-	 * @param  string|object
+	 * @param  string|object  $caption
 	 */
 	public function __construct($caption = null)
 	{
@@ -102,7 +102,7 @@ public function click(): void
 
 	/**
 	 * Generates control's HTML element.
-	 * @param  string|object
+	 * @param  string|object  $caption
 	 */
 	public function getControl($caption = null): Nette\Utils\Html
 	{

src/Forms/Controls/TextArea.php

@@ -19,7 +19,7 @@ class TextArea extends TextBase
 {
 
 	/**
-	 * @param  string|object
+	 * @param  string|object  $label
 	 */
 	public function __construct($label = null)
 	{

src/Forms/Controls/TextInput.php

@@ -20,7 +20,7 @@ class TextInput extends TextBase
 {
 
 	/**
-	 * @param  string|object
+	 * @param  string|object  $label
 	 */
 	public function __construct($label = null, int $maxLength = null)
 	{