Browse Source

Fix api docblock CS errors for View/

ADmad 11 years ago
parent
commit
82da080a05

+ 4 - 4
src/View/AjaxView.php

@@ -36,10 +36,10 @@ class AjaxView extends View {
 /**
  * Constructor
  *
- * @param Request $request
- * @param Response $response
- * @param EventManager $eventManager
- * @param array $viewOptions
+ * @param \Cake\Network\Request $request The request object.
+ * @param \Cake\Network\Response $response The response object.
+ * @param \Cake\Event\EventManager $eventManager Event manager object.
+ * @param array $viewOptions View options.
  */
 	public function __construct(Request $request = null, Response $response = null,
 		EventManager $eventManager = null, array $viewOptions = []) {

+ 2 - 1
src/View/CellTrait.php

@@ -51,7 +51,8 @@ trait CellTrait {
  *    `cell('TagCloud::smallList', ['a1' => 'v1', 'a2' => 'v2'])` maps to `View\Cell\TagCloud::smallList(v1, v2)`
  * @param array $options Options for Cell's constructor
  * @return \Cake\View\Cell The cell instance
- * @throws \Cake\View\Error\MissingCellException If Cell class was not found
+ * @throws \Cake\View\Error\MissingCellException If Cell class was not found.
+ * @throws \BadMethodCallException If Cell class does not specified cell action.
  */
 	public function cell($cell, $data = [], $options = []) {
 		$parts = explode('::', $cell);

+ 2 - 2
src/View/Form/ArrayContext.php

@@ -76,8 +76,8 @@ class ArrayContext implements ContextInterface {
 /**
  * Constructor.
  *
- * @param \Cake\Network\Request
- * @param array
+ * @param \Cake\Network\Request $request The request object.
+ * @param array $context Context info.
  */
 	public function __construct(Request $request, array $context) {
 		$this->_request = $request;

+ 2 - 2
src/View/Form/EntityContext.php

@@ -84,8 +84,8 @@ class EntityContext implements ContextInterface {
 /**
  * Constructor.
  *
- * @param \Cake\Network\Request
- * @param array
+ * @param \Cake\Network\Request $request The request object.
+ * @param array $context Context info.
  */
 	public function __construct(Request $request, array $context) {
 		$this->_request = $request;

+ 2 - 2
src/View/Form/NullContext.php

@@ -35,8 +35,8 @@ class NullContext implements ContextInterface {
 /**
  * Constructor.
  *
- * @param \Cake\Network\Request
- * @param array
+ * @param \Cake\Network\Request $request The request object.
+ * @param array $context Context info.
  */
 	public function __construct(Request $request, array $context) {
 		$this->_request = $request;

+ 1 - 1
src/View/Helper.php

@@ -239,7 +239,7 @@ class Helper implements EventListener {
  * Generate URL for given asset file. Depending on options passed provides full URL with domain name.
  * Also calls Helper::assetTimestamp() to add timestamp to local files
  *
- * @param string|array Path string or URL array
+ * @param string|array $path Path string or URL array
  * @param array $options Options array. Possible keys:
  *   `fullBase` Return full URL with domain name
  *   `pathPrefix` Path prefix for relative URLs

+ 18 - 18
src/View/Helper/FormHelper.php

@@ -231,7 +231,7 @@ class FormHelper extends Helper {
 /**
  * Returns if a field is required to be filled based on validation properties from the validating object.
  *
- * @param \Cake\Validation\ValidationSet $validationRules
+ * @param \Cake\Validation\ValidationSet $validationRules Validation rules set.
  * @return bool true if field is required to be filled, false otherwise
  */
 	protected function _isRequiredField($validationRules) {
@@ -962,8 +962,8 @@ class FormHelper extends Helper {
 /**
  * Generates input options array
  *
- * @param string $fieldName the name of the field to parse options for
- * @param array $options
+ * @param string $fieldName The name of the field to parse options for.
+ * @param array $options Options list.
  * @return array Options
  */
 	protected function _parseOptions($fieldName, $options) {
@@ -1024,8 +1024,8 @@ class FormHelper extends Helper {
  * Selects the variable containing the options for a select field if present,
  * and sets the value to the 'options' key in the options array.
  *
- * @param string $fieldName the name of the field to find options for
- * @param array $options
+ * @param string $fieldName The name of the field to find options for.
+ * @param array $options Options list.
  * @return array
  */
 	protected function _optionsOptions($fieldName, $options) {
@@ -1051,10 +1051,10 @@ class FormHelper extends Helper {
 /**
  * Magically set option type and corresponding options
  *
- * @param string $fieldName the name of the field to generate options for
- * @param array $options
- * @param bool $allowOverride whether or not it is allowed for this method to
- * overwrite the 'type' key in options
+ * @param string $fieldName The name of the field to generate options for.
+ * @param array $options Options list.
+ * @param bool $allowOverride Whether or not it is allowed for this method to
+ * overwrite the 'type' key in options.
  * @return array
  */
 	protected function _magicOptions($fieldName, $options, $allowOverride) {
@@ -1110,8 +1110,8 @@ class FormHelper extends Helper {
 /**
  * Generate label for input
  *
- * @param string $fieldName
- * @param array $options
+ * @param string $fieldName The name of the field to generate label for.
+ * @param array $options Options list.
  * @return bool|string false or Generated label element
  */
 	protected function _getLabel($fieldName, $options) {
@@ -1151,9 +1151,9 @@ class FormHelper extends Helper {
  * $options can contain a hash of id overrides. These overrides will be
  * used instead of the generated values if present.
  *
- * @param string $fieldName
- * @param string $label
- * @param array $options Options for the label element. 'NONE' option is deprecated and will be removed in 3.0
+ * @param string $fieldName The name of the field to generate label for.
+ * @param string $label Label text.
+ * @param array $options Options for the label element.
  * @return string Generated label element
  */
 	protected function _inputLabel($fieldName, $label, $options) {
@@ -1685,8 +1685,8 @@ class FormHelper extends Helper {
  * Can be used in place of a select box with the multiple attribute.
  *
  * @param string $fieldName Name attribute of the SELECT
- * @param array $options|\Traversable Array of the OPTION elements (as 'value'=>'Text' pairs) to be used in the
- *   checkboxes element.
+ * @param array|\Traversable $options Array of the OPTION elements
+ *   (as 'value'=>'Text' pairs) to be used in the checkboxes element.
  * @param array $attributes The HTML attributes of the select element.
  * @return string Formatted SELECT element
  * @see \Cake\View\Helper\FormHelper::select() for supported option formats.
@@ -2248,8 +2248,8 @@ class FormHelper extends Helper {
  * Allows you to add or replace widget instances with custom code.
  *
  * @param string $name The name of the widget. e.g. 'text'.
- * @param array|\Cake\View\Widget\WidgetInterface Either a string class name or an object
- *    implementing the WidgetInterface.
+ * @param array|\Cake\View\Widget\WidgetInterface $spec Either a string class
+ *   name or an object implementing the WidgetInterface.
  * @return void
  */
 	public function addWidget($name, $spec) {

+ 1 - 2
src/View/Helper/NumberHelper.php

@@ -85,7 +85,6 @@ class NumberHelper extends Helper {
 /**
  * Formats a number with a level of precision.
  *
- *
  * @param float $number A floating point number.
  * @param int $precision The precision of the returned number.
  * @return float Formatted float.
@@ -173,7 +172,7 @@ class NumberHelper extends Helper {
  * @param string $currency Shortcut to default options. Valid values are 'USD', 'EUR', 'GBP', otherwise
  *   set at least 'before' and 'after' options.
  * 'USD' is the default currency, use Number::defaultCurrency() to change this default.
- * @param array $options
+ * @param array $options Options list.
  * @return string Number formatted as a currency.
  * @see Cake\Utility\Number::currency()
  * @link http://book.cakephp.org/2.0/en/core-libraries/helpers/number.html#NumberHelper::currency

+ 1 - 1
src/View/Helper/PaginatorHelper.php

@@ -73,7 +73,7 @@ class PaginatorHelper extends Helper {
  * Before render callback. Overridden to merge passed args with URL options.
  *
  * @param \Cake\Event\Event $event The event instance.
- * @param string $viewFile
+ * @param string $viewFile The view file being rendered.
  * @return void
  */
 	public function beforeRender($event, $viewFile) {

+ 11 - 19
src/View/Helper/TimeHelper.php

@@ -47,7 +47,7 @@ class TimeHelper extends Helper {
  *
  * @param int|string|\DateTime $dateString UNIX timestamp, strtotime() valid string or DateTime object
  * @param string|\DateTimeZone $timezone User's timezone string or DateTimeZone object
- * @param string $format The format to use. If null, `CakeTime::$niceFormat` is used
+ * @param string $locale Locale string.
  * @return string Formatted date string
  * @link http://book.cakephp.org/2.0/en/core-libraries/helpers/time.html#formatting
  */
@@ -155,11 +155,10 @@ class TimeHelper extends Helper {
 /**
  * Returns the quarter
  *
- * @see \Cake\Utility\Time::toQuarter()
- *
  * @param int|string|\DateTime $dateString UNIX timestamp, strtotime() valid string or DateTime object
  * @param bool $range if true returns a range in Y-m-d format
  * @return mixed 1, 2, 3, or 4 quarter of year or array if $range true
+ * @see \Cake\Utility\Time::toQuarter()
  * @link http://book.cakephp.org/2.0/en/core-libraries/helpers/time.html#formatting
  */
 	public function toQuarter($dateString, $range = false) {
@@ -169,11 +168,10 @@ class TimeHelper extends Helper {
 /**
  * Returns a UNIX timestamp from a textual datetime description. Wrapper for PHP function strtotime().
  *
- * @see \Cake\Utility\Time::toUnix()
- *
  * @param int|string|\DateTime $dateString UNIX timestamp, strtotime() valid string or DateTime object
  * @param string|\DateTimeZone $timezone User's timezone string or DateTimeZone object
  * @return int Unix timestamp
+ * @see \Cake\Utility\Time::toUnix()
  * @link http://book.cakephp.org/2.0/en/core-libraries/helpers/time.html#formatting
  */
 	public function toUnix($dateString, $timezone = null) {
@@ -183,11 +181,10 @@ class TimeHelper extends Helper {
 /**
  * Returns a date formatted for Atom RSS feeds.
  *
- * @see \Cake\Utility\Time::toAtom()
- *
  * @param int|string|\DateTime $dateString UNIX timestamp, strtotime() valid string or DateTime object
  * @param string|\DateTimeZone $timezone User's timezone string or DateTimeZone object
  * @return string Formatted date string
+ * @see \Cake\Utility\Time::toAtom()
  * @link http://book.cakephp.org/2.0/en/core-libraries/helpers/time.html#formatting
  */
 	public function toAtom($dateString, $timezone = null) {
@@ -211,8 +208,6 @@ class TimeHelper extends Helper {
 /**
  * Formats date for RSS feeds
  *
- * @see \Cake\Utility\Time::timeAgoInWords()
- *
  * ## Additional options
  *
  * - `element` - The element to wrap the formatted time in.
@@ -224,6 +219,7 @@ class TimeHelper extends Helper {
  * @param int|string|\DateTime $dateTime UNIX timestamp, strtotime() valid string or DateTime object
  * @param array $options Default format if timestamp is used in $dateString
  * @return string Relative time string.
+ * @see \Cake\Utility\Time::timeAgoInWords()
  * @link http://book.cakephp.org/2.0/en/core-libraries/helpers/time.html#formatting
  */
 	public function timeAgoInWords($dateTime, array $options = array()) {
@@ -259,13 +255,13 @@ class TimeHelper extends Helper {
 
 /**
  * Returns true if specified datetime was within the interval specified, else false.
- * @see \Cake\Utility\Time::wasWithinLast()
  *
  * @param string|int $timeInterval the numeric value with space then time type.
  *    Example of valid types: 6 hours, 2 days, 1 minute.
  * @param int|string|\DateTime $dateString UNIX timestamp, strtotime() valid string or DateTime object
  * @param string|\DateTimeZone $timezone User's timezone string or DateTimeZone object
  * @return bool
+ * @see \Cake\Utility\Time::wasWithinLast()
  * @link http://book.cakephp.org/2.0/en/core-libraries/helpers/time.html#testing-time
  */
 	public function wasWithinLast($timeInterval, $dateString, $timezone = null) {
@@ -275,13 +271,12 @@ class TimeHelper extends Helper {
 /**
  * Returns true if specified datetime is within the interval specified, else false.
  *
- * @see \Cake\Utility\Time::isWithinLast()
- *
  * @param string|int $timeInterval the numeric value with space then time type.
  *    Example of valid types: 6 hours, 2 days, 1 minute.
  * @param int|string|\DateTime $dateString UNIX timestamp, strtotime() valid string or DateTime object
  * @param string|\DateTimeZone $timezone User's timezone string or DateTimeZone object
  * @return bool
+ * @see \Cake\Utility\Time::isWithinLast()
  * @link http://book.cakephp.org/2.0/en/core-libraries/helpers/time.html#testing-time
  */
 	public function isWithinNext($timeInterval, $dateString, $timezone = null) {
@@ -291,10 +286,9 @@ class TimeHelper extends Helper {
 /**
  * Returns gmt as a UNIX timestamp.
  *
- * @see \Cake\Utility\Time::gmt()
- *
  * @param int|string|\DateTime $string UNIX timestamp, strtotime() valid string or DateTime object
  * @return int UNIX timestamp
+ * @see \Cake\Utility\Time::gmt()
  * @link http://book.cakephp.org/2.0/en/core-libraries/helpers/time.html#formatting
  */
 	public function gmt($string = null) {
@@ -306,13 +300,12 @@ class TimeHelper extends Helper {
  * This function also accepts a time string and a format string as first and second parameters.
  * In that case this function behaves as a wrapper for Time::i18nFormat()
  *
- * @see \Cake\Utility\Time::i18nFormat()
- *
  * @param int|string|\DateTime $date UNIX timestamp, strtotime() valid string or DateTime object (or a date format string)
  * @param int|string $format date format string (or a UNIX timestamp, strtotime() valid string or DateTime object)
  * @param bool|string $invalid Default value to display on invalid dates
  * @param string|\DateTimeZone $timezone User's timezone string or DateTimeZone object
  * @return string Formatted and translated date string
+ * @see \Cake\Utility\Time::i18nFormat()
  * @link http://book.cakephp.org/2.0/en/core-libraries/helpers/time.html#formatting
  */
 	public function format($date, $format = null, $invalid = false, $timezone = null) {
@@ -323,15 +316,14 @@ class TimeHelper extends Helper {
  * Returns a formatted date string, given either a UNIX timestamp or a valid strtotime() date string.
  * It takes into account the default date format for the current language if a LC_TIME file is used.
  *
- * @see \Cake\Utility\Time::i18nFormat()
- *
  * @param int|string|\DateTime $date UNIX timestamp, strtotime() valid string or DateTime object
  * @param string $format strftime format string.
  * @param bool|string $invalid Default value to display on invalid dates
  * @param string|\DateTimeZone $timezone User's timezone string or DateTimeZone object
  * @return string Formatted and translated date string
- * @link http://book.cakephp.org/2.0/en/core-libraries/helpers/time.html#formatting
  * @throws \InvalidArgumentException When the date cannot be parsed
+ * @see \Cake\Utility\Time::i18nFormat()
+ * @link http://book.cakephp.org/2.0/en/core-libraries/helpers/time.html#formatting
  */
 	public function i18nFormat($date, $format = null, $invalid = false, $timezone = null) {
 		try {

+ 2 - 1
src/View/HelperRegistry.php

@@ -38,7 +38,7 @@ class HelperRegistry extends ObjectRegistry {
 /**
  * Constructor
  *
- * @param View $view
+ * @param \Cake\View\View $view View object.
  */
 	public function __construct(View $view) {
 		$this->_View = $view;
@@ -111,6 +111,7 @@ class HelperRegistry extends ObjectRegistry {
  *
  * @param string $class The classname that is missing.
  * @param string $plugin The plugin the helper is missing in.
+ * @return void
  * @throws \Cake\View\Error\MissingHelperException
  */
 	protected function _throwMissingClassError($class, $plugin) {

+ 1 - 1
src/View/StringTemplate.php

@@ -57,7 +57,7 @@ class StringTemplate {
 /**
  * Constructor.
  *
- * @param array $templates A set of templates to add.
+ * @param array $config A set of templates to add.
  */
 	public function __construct(array $config = []) {
 		$this->config($config);

+ 1 - 1
src/View/Widget/Basic.php

@@ -54,7 +54,7 @@ class Basic implements WidgetInterface {
  * Any other keys provided in $data will be converted into HTML attributes.
  *
  * @param array $data The data to build an input with.
- * @param \Cake\View\Form\ContextInterface The current form context.
+ * @param \Cake\View\Form\ContextInterface $context The current form context.
  * @return string
  */
 	public function render(array $data, ContextInterface $context) {

+ 2 - 2
src/View/Widget/Button.php

@@ -36,7 +36,7 @@ class Button implements WidgetInterface {
 /**
  * Constructor.
  *
- * @param \Cake\View\StringTemplate $templates
+ * @param \Cake\View\StringTemplate $templates Templates list.
  */
 	public function __construct($templates) {
 		$this->_templates = $templates;
@@ -55,7 +55,7 @@ class Button implements WidgetInterface {
  * Any other keys provided in $data will be converted into HTML attributes.
  *
  * @param array $data The data to build a button with.
- * @param \Cake\View\Form\ContextInterface The current form context.
+ * @param \Cake\View\Form\ContextInterface $context The current form context.
  * @return string
  */
 	public function render(array $data, ContextInterface $context) {

+ 2 - 2
src/View/Widget/Checkbox.php

@@ -32,7 +32,7 @@ class Checkbox implements WidgetInterface {
 /**
  * Constructor
  *
- * @param \Cake\View\StringTemplate $templates
+ * @param \Cake\View\StringTemplate $templates Templates list.
  */
 	public function __construct($templates) {
 		$this->_templates = $templates;
@@ -52,7 +52,7 @@ class Checkbox implements WidgetInterface {
  * Any other attributes passed in will be treated as HTML attributes.
  *
  * @param array $data The data to create a checkbox with.
- * @param \Cake\View\Form\ContextInterface The current form context.
+ * @param \Cake\View\Form\ContextInterface $context The current form context.
  * @return string Generated HTML string.
  */
 	public function render(array $data, ContextInterface $context) {

+ 7 - 7
src/View/Widget/DateTime.php

@@ -59,8 +59,8 @@ class DateTime implements WidgetInterface {
 /**
  * Constructor
  *
- * @param \Cake\View\StringTemplate $templates
- * @param \Cake\View\Widget\SelectBox $selectBox
+ * @param \Cake\View\StringTemplate $templates Templates list.
+ * @param \Cake\View\Widget\SelectBox $selectBox Selectbox widget instance.
  */
 	public function __construct($templates, $selectBox) {
 		$this->_select = $selectBox;
@@ -114,7 +114,7 @@ class DateTime implements WidgetInterface {
  *   should be rounded to match the select options.
  *
  * @param array $data Data to render with.
- * @param \Cake\View\Form\ContextInterface The current form context.
+ * @param \Cake\View\Form\ContextInterface $context The current form context.
  * @return string A generated select box.
  * @throws \RuntimeException When option data is invalid.
  */
@@ -177,7 +177,7 @@ class DateTime implements WidgetInterface {
 /**
  * Deconstructs the passed date value into all time units
  *
- * @param string|int|array|DateTime $value
+ * @param string|int|array|DateTime $value Value to deconstruct.
  * @param array $options Options for conversion.
  * @return array
  */
@@ -260,7 +260,7 @@ class DateTime implements WidgetInterface {
 /**
  * Generates a year select
  *
- * @param array $options
+ * @param array $options Options list.
  * @param \Cake\View\Form\ContextInterface $context The current form context.
  * @return string
  */
@@ -458,7 +458,7 @@ class DateTime implements WidgetInterface {
 /**
  * Returns a translated list of month names
  *
- * @param bool $leadingZero
+ * @param bool $leadingZero Whether to generate month keys with leading zero.
  * @return array
  */
 	protected function _getMonthNames($leadingZero = false) {
@@ -499,7 +499,7 @@ class DateTime implements WidgetInterface {
  *
  * @param int $start Start of the range of numbers to generate
  * @param int $end End of the range of numbers to generate
- * @param array $options
+ * @param array $options Options list.
  * @return array
  */
 	protected function _generateNumbers($start, $end, $options = []) {

+ 2 - 2
src/View/Widget/File.php

@@ -28,7 +28,7 @@ class File implements WidgetInterface {
 /**
  * Constructor
  *
- * @param \Cake\View\StringTemplate $templates
+ * @param \Cake\View\StringTemplate $templates Templates list.
  */
 	public function __construct($templates) {
 		$this->_templates = $templates;
@@ -47,7 +47,7 @@ class File implements WidgetInterface {
  * ignored.
  *
  * @param array $data The data to build a file input with.
- * @param \Cake\View\Form\ContextInterface The current form context.
+ * @param \Cake\View\Form\ContextInterface $context The current form context.
  * @return string HTML elements.
  */
 	public function render(array $data, ContextInterface $context) {

+ 3 - 3
src/View/Widget/Label.php

@@ -40,7 +40,7 @@ class Label implements WidgetInterface {
  * - `label` Used to generate the label for a radio button.
  *   Can use the following variables `attrs`, `text` and `input`.
  *
- * @param \Cake\View\StringTemplate $templates
+ * @param \Cake\View\StringTemplate $templates Templates list.
  */
 	public function __construct($templates) {
 		$this->_templates = $templates;
@@ -57,8 +57,8 @@ class Label implements WidgetInterface {
  *
  * All other attributes will be converted into HTML attributes.
  *
- * @param array $data
- * @param \Cake\View\Form\ContextInterface The current form context.
+ * @param array $data Data array.
+ * @param \Cake\View\Form\ContextInterface $context The current form context.
  * @return string
  */
 	public function render(array $data, ContextInterface $context) {

+ 6 - 6
src/View/Widget/MultiCheckbox.php

@@ -51,8 +51,8 @@ class MultiCheckbox implements WidgetInterface {
  *   a checkbox and its label. Accepts the `input`, and `label`
  *   variables.
  *
- * @param \Cake\View\StringTemplate $templates
- * @param \Cake\View\Widget\Label $label
+ * @param \Cake\View\StringTemplate $templates Templates list.
+ * @param \Cake\View\Widget\Label $label Label widget instance.
  */
 	public function __construct($templates, $label) {
 		$this->_templates = $templates;
@@ -98,7 +98,7 @@ class MultiCheckbox implements WidgetInterface {
  * If either is not set options will not be generated correctly.
  *
  * @param array $data The data to generate a checkbox set with.
- * @param \Cake\View\Form\ContextInterface The current form context.
+ * @param \Cake\View\Form\ContextInterface $context The current form context.
  * @return string
  */
 	public function render(array $data, ContextInterface $context) {
@@ -143,7 +143,7 @@ class MultiCheckbox implements WidgetInterface {
  * Render a single checkbox & wrapper.
  *
  * @param array $checkbox An array containing checkbox key/value option pairs
- * @param \Cake\View\Form\ContextInterface Context object.
+ * @param \Cake\View\Form\ContextInterface $context Context object.
  * @return string
  */
 	protected function _renderInput($checkbox, $context) {
@@ -177,7 +177,7 @@ class MultiCheckbox implements WidgetInterface {
  * Helper method for deciding what options are selected.
  *
  * @param string $key The key to test.
- * @param array|string|null The selected values.
+ * @param array|string|null $selected The selected values.
  * @return bool
  */
 	protected function _isSelected($key, $selected) {
@@ -196,7 +196,7 @@ class MultiCheckbox implements WidgetInterface {
  * Helper method for deciding what options are disabled.
  *
  * @param string $key The key to test.
- * @param array|null The disabled values.
+ * @param array|null $disabled The disabled values.
  * @return bool
  */
 	protected function _isDisabled($key, $disabled) {

+ 6 - 6
src/View/Widget/Radio.php

@@ -54,8 +54,8 @@ class Radio implements WidgetInterface {
  *   the radio + input element. Can use the `input` and `label`
  *   variables.
  *
- * @param \Cake\View\StringTemplate $templates
- * @param \Cake\View\Widget\Label $label
+ * @param \Cake\View\StringTemplate $templates Templates list.
+ * @param \Cake\View\Widget\Label $label Label widget instance.
  */
 	public function __construct($templates, $label) {
 		$this->_templates = $templates;
@@ -79,7 +79,7 @@ class Radio implements WidgetInterface {
  * - `idPrefix` Prefix for generated ID attributes.
  *
  * @param array $data The data to build radio buttons with.
- * @param \Cake\View\Form\ContextInterface The current form context.
+ * @param \Cake\View\Form\ContextInterface $context The current form context.
  * @return string
  */
 	public function render(array $data, ContextInterface $context) {
@@ -117,8 +117,8 @@ class Radio implements WidgetInterface {
 /**
  * Disabled attribute detection.
  *
- * @param array $radio
- * @param array|null|true $disabled
+ * @param array $radio Radio info.
+ * @param array|null|true $disabled The disabled values.
  * @return bool
  */
 	protected function _isDisabled($radio, $disabled) {
@@ -138,7 +138,7 @@ class Radio implements WidgetInterface {
  * @param string|int $val The value of the radio input.
  * @param string|array $text The label text, or complex radio type.
  * @param array $data Additional options for input generation.
- * @param \Cake\View\Form\ContextInterface The form context
+ * @param \Cake\View\Form\ContextInterface $context The form context
  * @return string
  */
 	protected function _renderInput($val, $text, $data, $context) {

+ 4 - 4
src/View/Widget/SelectBox.php

@@ -36,7 +36,7 @@ class SelectBox implements WidgetInterface {
 /**
  * Constructor
  *
- * @param \Cake\View\StringTemplate $templates
+ * @param \Cake\View\StringTemplate $templates Templates list.
  */
 	public function __construct($templates) {
 		$this->_templates = $templates;
@@ -112,7 +112,7 @@ class SelectBox implements WidgetInterface {
  * nest complex types as required.
  *
  * @param array $data Data to render with.
- * @param \Cake\View\Form\ContextInterface The current form context.
+ * @param \Cake\View\Form\ContextInterface $context The current form context.
  * @return string A generated select box.
  * @throws \RuntimeException when the name attribute is empty.
  */
@@ -258,7 +258,7 @@ class SelectBox implements WidgetInterface {
  * Helper method for deciding what options are selected.
  *
  * @param string $key The key to test.
- * @param array|string|null The selected values.
+ * @param array|string|null $selected The selected values.
  * @return bool
  */
 	protected function _isSelected($key, $selected) {
@@ -277,7 +277,7 @@ class SelectBox implements WidgetInterface {
  * Helper method for deciding what options are disabled.
  *
  * @param string $key The key to test.
- * @param array|null The disabled values.
+ * @param array|null $disabled The disabled values.
  * @return bool
  */
 	protected function _isDisabled($key, $disabled) {

+ 2 - 2
src/View/Widget/Textarea.php

@@ -28,7 +28,7 @@ class Textarea implements WidgetInterface {
 /**
  * Constructor
  *
- * @param \Cake\View\StringTemplate $templates
+ * @param \Cake\View\StringTemplate $templates Templates list.
  */
 	public function __construct($templates) {
 		$this->_templates = $templates;
@@ -46,7 +46,7 @@ class Textarea implements WidgetInterface {
  * All other keys will be converted into HTML attributes.
  *
  * @param array $data The data to build a textarea with.
- * @param \Cake\View\Form\ContextInterface The current form context.
+ * @param \Cake\View\Form\ContextInterface $context The current form context.
  * @return string HTML elements.
  */
 	public function render(array $data, ContextInterface $context) {

+ 1 - 1
src/View/Widget/WidgetInterface.php

@@ -25,7 +25,7 @@ interface WidgetInterface {
  * Converts the $data into one or many HTML elements.
  *
  * @param array $data The data to render.
- * @param \Cake\View\Form\ContextInterface The current form context.
+ * @param \Cake\View\Form\ContextInterface $context The current form context.
  * @return string Generated HTML for the widget element.
  */
 	public function render(array $data, ContextInterface $context);

+ 1 - 1
src/View/XmlView.php

@@ -76,7 +76,7 @@ class XmlView extends View {
  * @param Cake\Network\Request $request Request instance
  * @param Cake\Network\Response $response Response instance
  * @param Cake\Event\EventManager $eventManager Event Manager
- * @param array $viewOptions
+ * @param array $viewOptions View options.
  */
 	public function __construct(Request $request = null, Response $response = null,
 		EventManager $eventManager = null, array $viewOptions = []) {