Update to Drupal 8.2.5. For more information, see https://www.drupal.org/project/drupal/releases/8.2.5

core/lib/Drupal.php

@@ -81,7 +81,7 @@ class Drupal {
   /**
    * The current system version.
    */
-  const VERSION = '8.2.4';
+  const VERSION = '8.2.5';
 
   /**
    * Core API compatibility.
@@ -556,8 +556,7 @@ class Drupal {
    * Renders a link with a given link text and Url object.
    *
    * This method is a convenience wrapper for the link generator service's
-   * generate() method. For detailed documentation, see
-   * \Drupal\Core\Routing\LinkGeneratorInterface::generate().
+   * generate() method.
    *
    * @param string $text
    *   The link text for the anchor tag.

core/lib/Drupal/Core/Render/Element/Date.php

@@ -11,6 +11,7 @@ use Drupal\Core\Render\Element;
  * Properties:
  * - #default_value: An array with the keys: 'year', 'month', and 'day'.
  *   Defaults to the current date if no value is supplied.
+ * - #size: The size of the input element in characters.
  *
  * @code
  * $form['expiration'] = array(

core/lib/Drupal/Core/Render/Element/Email.php

@@ -10,6 +10,7 @@ use Drupal\Core\Render\Element;
  *
  * Properties:
  * - #default_value: An RFC-compliant email address.
+ * - #size: The size of the input element in characters.
  *
  * Example usage:
  * @code

core/lib/Drupal/Core/Render/Element/Number.php

@@ -16,6 +16,7 @@ use Drupal\Component\Utility\Number as NumberUtility;
  * - #step: Ensures that the number is an even multiple of step, offset by #min
  *   if specified. A #min of 1 and a #step of 2 would allow values of 1, 3, 5,
  *   etc.
+ * - #size: The size of the input element in characters.
  *
  * Usage example:
  * @code

core/lib/Drupal/Core/Render/Element/Password.php

@@ -8,6 +8,9 @@ use Drupal\Core\Render\Element;
 /**
  * Provides a form element for entering a password, with hidden text.
  *
+ * Properties:
+ * - #size: The size of the input element in characters.
+ *
  * Usage example:
  * @code
  * $form['pass'] = array(

core/lib/Drupal/Core/Render/Element/PasswordConfirm.php

@@ -10,6 +10,9 @@ use Drupal\Core\Form\FormStateInterface;
  * Formats as a pair of password fields, which do not validate unless the two
  * entered passwords match.
  *
+ * Properties:
+ * - #size: The size of the input element in characters.
+ *
  * Usage example:
  * @code
  * $form['pass'] = array(

core/lib/Drupal/Core/Render/Element/Select.php

@@ -14,8 +14,31 @@ use Drupal\Core\Render\Element;
  *   list. If a value is an array, it will be rendered similarly, but as an
  *   optgroup. The key of the sub-array will be used as the label for the
  *   optgroup. Nesting optgroups is not allowed.
- * - #empty_option: The label that will be displayed to denote no selection.
- * - #empty_value: The value of the option that is used to denote no selection.
+ * - #empty_option: (optional) The label to show for the first default option.
+ *   By default, the label is automatically set to "- Select -" for a required
+ *   field and "- None -" for an optional field.
+ * - #empty_value: (optional) The value for the first default option, which is
+ *   used to determine whether the user submitted a value or not.
+ *   - If #required is TRUE, this defaults to '' (an empty string).
+ *   - If #required is not TRUE and this value isn't set, then no extra option
+ *     is added to the select control, leaving the control in a slightly
+ *     illogical state, because there's no way for the user to select nothing,
+ *     since all user agents automatically preselect the first available
+ *     option. But people are used to this being the behavior of select
+ *     controls.
+ *     @todo Address the above issue in Drupal 8.
+ *   - If #required is not TRUE and this value is set (most commonly to an
+ *     empty string), then an extra option (see #empty_option above)
+ *     representing a "non-selection" is added with this as its value.
+ * - #multiple: (optional) Indicates whether one or more options can be
+ *   selected. Defaults to FALSE.
+ * - #default_value: Must be NULL or not set in case there is no value for the
+ *   element yet, in which case a first default option is inserted by default.
+ *   Whether this first option is a valid option depends on whether the field
+ *   is #required or not.
+ * - #required: (optional) Whether the user needs to select an option (TRUE)
+ *   or not (FALSE). Defaults to FALSE.
+ * - #size: The size of the input element in characters.
  *
  * Usage example:
  * @code
@@ -66,31 +89,7 @@ class Select extends FormElement {
    * select lists.
    *
    * @param array $element
-   *   The form element to process. Properties used:
-   *   - #multiple: (optional) Indicates whether one or more options can be
-   *     selected. Defaults to FALSE.
-   *   - #default_value: Must be NULL or not set in case there is no value for the
-   *     element yet, in which case a first default option is inserted by default.
-   *     Whether this first option is a valid option depends on whether the field
-   *     is #required or not.
-   *   - #required: (optional) Whether the user needs to select an option (TRUE)
-   *     or not (FALSE). Defaults to FALSE.
-   *   - #empty_option: (optional) The label to show for the first default option.
-   *     By default, the label is automatically set to "- Select -" for a required
-   *     field and "- None -" for an optional field.
-   *   - #empty_value: (optional) The value for the first default option, which is
-   *     used to determine whether the user submitted a value or not.
-   *     - If #required is TRUE, this defaults to '' (an empty string).
-   *     - If #required is not TRUE and this value isn't set, then no extra option
-   *       is added to the select control, leaving the control in a slightly
-   *       illogical state, because there's no way for the user to select nothing,
-   *       since all user agents automatically preselect the first available
-   *       option. But people are used to this being the behavior of select
-   *       controls.
-   *       @todo Address the above issue in Drupal 8.
-   *     - If #required is not TRUE and this value is set (most commonly to an
-   *       empty string), then an extra option (see #empty_option above)
-   *       representing a "non-selection" is added with this as its value.
+   *   The form element to process.
    * @param \Drupal\Core\Form\FormStateInterface $form_state
    *   The current state of the form.
    * @param array $complete_form

core/lib/Drupal/Core/Render/Element/Table.php

@@ -24,6 +24,7 @@ use Drupal\Component\Utility\Html as HtmlUtility;
  *   providing responsive tables.  Defaults to TRUE.
  * - #sticky: Indicates whether to add the drupal.tableheader library that makes
  *   table headers always visible at the top of the page. Defaults to FALSE.
+ * - #size: The size of the input element in characters.
  *
  * Usage example:
  * @code

core/lib/Drupal/Core/Render/Element/Tel.php

@@ -10,6 +10,9 @@ use Drupal\Core\Render\Element;
  * Provides an HTML5 input element with type of "tel". It provides no special
  * validation.
  *
+ * Properties:
+ * - #size: The size of the input element in characters.
+ *
  * Usage example:
  * @code
  * $form['phone'] = array(

core/lib/Drupal/Core/Render/Element/Url.php

@@ -11,6 +11,7 @@ use Drupal\Core\Render\Element;
  *
  * Properties:
  * - #default_value: A valid URL string.
+ * - #size: The size of the input element in characters.
  *
  * Usage example:
  * @code

core/lib/Drupal/Core/Render/theme.api.php

@@ -254,13 +254,13 @@
  * form array, which specifies the form elements for an HTML form; see the
  * @link form_api Form generation topic @endlink for more information on forms.
  *
- * Render arrays (at each level in the hierarchy) will usually have one of the
- * following three properties defined:
+ * Render arrays (at any level of the hierarchy) will usually have one of the
+ * following properties defined:
  * - #type: Specifies that the array contains data and options for a particular
- *   type of "render element" (examples: 'form', for an HTML form; 'textfield',
- *   'submit', and other HTML form element types; 'table', for a table with
- *   rows, columns, and headers). See @ref elements below for more on render
- *   element types.
+ *   type of "render element" (for example, 'form', for an HTML form;
+ *   'textfield', 'submit', for HTML form element types; 'table', for a table
+ *   with rows, columns, and headers). See @ref elements below for more on
+ *   render element types.
  * - #theme: Specifies that the array contains data to be themed by a particular
  *   theme hook. Modules define theme hooks by implementing hook_theme(), which
  *   specifies the input "variables" used to provide data and options; if a
@@ -277,30 +277,29 @@
  *   can customize the markup. Note that the value is passed through
  *   \Drupal\Component\Utility\Xss::filterAdmin(), which strips known XSS
  *   vectors while allowing a permissive list of HTML tags that are not XSS
- *   vectors. (I.e, <script> and <style> are not allowed.) See
- *   \Drupal\Component\Utility\Xss::$adminTags for the list of tags that will
- *   be allowed. If your markup needs any of the tags that are not in this
- *   whitelist, then you can implement a theme hook and template file and/or
- *   an asset library. Aternatively, you can use the render array key
- *   #allowed_tags to alter which tags are filtered.
+ *   vectors. (For example, <script> and <style> are not allowed.) See
+ *   \Drupal\Component\Utility\Xss::$adminTags for the list of allowed tags. If
+ *   your markup needs any of the tags not in this whitelist, then you can
+ *   implement a theme hook and/or an asset library. Alternatively, you can use
+ *   the key #allowed_tags to alter which tags are filtered.
  * - #plain_text: Specifies that the array provides text that needs to be
- *   escaped. This value takes precedence over #markup if present.
- * - #allowed_tags: If #markup is supplied this can be used to change which tags
- *   are using to filter the markup. The value should be an array of tags that
- *   Xss::filter() would accept. If #plain_text is set this value is ignored.
+ *   escaped. This value takes precedence over #markup.
+ * - #allowed_tags: If #markup is supplied, this can be used to change which
+ *   tags are allowed in the markup. The value is an array of tags that
+ *   Xss::filter() would accept. If #plain_text is set, this value is ignored.
  *
  *   Usage example:
  *   @code
- *   $output['admin_filtered_string'] = array(
+ *   $output['admin_filtered_string'] = [
  *     '#markup' => '<em>This is filtered using the admin tag list</em>',
- *   );
- *   $output['filtered_string'] = array(
- *     '#markup' => '<em>This is filtered</em>',
- *     '#allowed_tags' => ['strong'],
- *   );
- *   $output['escaped_string'] = array(
+ *   ];
+ *   $output['filtered_string'] = [
+ *     '#markup' => '<video><source src="v.webm" type="video/webm"></video>',
+ *     '#allowed_tags' => ['video', 'source'],
+ *   ];
+ *   $output['escaped_string'] = [
  *     '#plain_text' => '<em>This is escaped</em>',
- *   );
+ *   ];
  *   @endcode
  *
  *   @see core.libraries.yml