Issue #2601610 by krknth: Fix comment standards for filter module

core/modules/filter/src/Controller/FilterController.php

@@ -17,8 +17,9 @@ class FilterController {
   /**
    * Displays a page with long filter tips.
    *
-   * @param \Drupal\filter\FilterFormatInterface|null $format
-   *   A filter format, or NULL to show tips for all formats. Defaults to NULL.
+   * @param \Drupal\filter\FilterFormatInterface|null $filter_format
+   *   (optional) A filter format, or NULL to show tips for all formats.
+   *   Defaults to NULL.
    *
    * @return array
    *   A renderable array.

core/modules/filter/src/Element/ProcessedText.php

@@ -138,7 +138,11 @@ class ProcessedText extends RenderElement {
   /**
    * Wraps a logger channel.
    *
+   * @param string $channel
+   *   The name of the channel.
+   *
    * @return \Psr\Log\LoggerInterface
+   *   The logger for this channel.
    */
   protected static function logger($channel) {
     return \Drupal::logger($channel);

core/modules/filter/src/Tests/FilterUnitTest.php

@@ -1135,7 +1135,8 @@ body {color:red}
    *   (optional) Message to display if failed. Defaults to an empty string.
    * @param $group
    *   (optional) The group this message belongs to. Defaults to 'Other'.
-   * @return
+   *
+   * @return bool
    *   TRUE on pass, FALSE on fail.
    */
   function assertNormalized($haystack, $needle, $message = '', $group = 'Other') {
@@ -1159,7 +1160,8 @@ body {color:red}
    *   (optional) Message to display if failed. Defaults to an empty string.
    * @param $group
    *   (optional) The group this message belongs to. Defaults to 'Other'.
-   * @return
+   *
+   * @return bool
    *   TRUE on pass, FALSE on fail.
    */
   function assertNoNormalized($haystack, $needle, $message = '', $group = 'Other') {