phpDoc: added $var name to @param

Author: dg

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)