Issue #2721909 by anoopjohn: Fix Drupal.Commenting.FunctionComment.ReturnCommentIndentation

core/includes/install.core.inc

@@ -1084,7 +1084,7 @@ function install_verify_completed_task() {
  *   The site path.
  *
  * @return bool
- *  TRUE if there are no database errors.
+ *   TRUE if there are no database errors.
  */
 function install_verify_database_settings($site_path) {
   if ($database = Database::getConnectionInfo()) {

core/includes/install.inc

@@ -115,8 +115,8 @@ function drupal_install_profile_distribution_name() {
  * Loads the installation profile, extracting its defined version.
  *
  * @return string Distribution version defined in the profile's .info.yml file.
- * Defaults to \Drupal::VERSION if no version is explicitly provided
- * by the installation profile.
+ *   Defaults to \Drupal::VERSION if no version is explicitly provided
+ *   by the installation profile.
  *
  * @see install_profile_info()
  */
@@ -139,7 +139,7 @@ function drupal_install_profile_distribution_version() {
  * Detects all supported databases that are compiled into PHP.
  *
  * @return
- *  An array of database types compiled into PHP.
+ *   An array of database types compiled into PHP.
  */
 function drupal_detect_database_types() {
   $databases = drupal_get_database_types();
@@ -724,7 +724,7 @@ function drupal_verify_install_file($file, $mask = NULL, $type = 'file') {
  *   (optional) Whether to output messages. Defaults to TRUE.
  *
  * @return
- *  TRUE/FALSE whether or not the directory was successfully created.
+ *   TRUE/FALSE whether or not the directory was successfully created.
  */
 function drupal_install_mkdir($file, $mask, $message = TRUE) {
   $mod = 0;
@@ -773,7 +773,7 @@ function drupal_install_mkdir($file, $mask, $message = TRUE) {
  *   (optional) Whether to output messages. Defaults to TRUE.
  *
  * @return
- *  TRUE/FALSE whether or not we were able to fix the file's permissions.
+ *   TRUE/FALSE whether or not we were able to fix the file's permissions.
  */
 function drupal_install_fix_file($file, $mask, $message = TRUE) {
   // If $file does not exist, fileperms() issues a PHP warning.

core/includes/update.inc

@@ -65,7 +65,7 @@ function update_check_incompatibility($name, $type = 'module') {
  * Returns whether the minimum schema requirement has been satisfied.
  *
  * @return array
- *  A requirements info array.
+ *   A requirements info array.
  */
 function update_system_schema_requirements() {
   $requirements = array();

core/lib/Drupal/Component/Annotation/Plugin.php

@@ -49,7 +49,7 @@ public function __construct($values) {
    *   The annotation array.
    *
    * @return array
-   *  The parsed annotation as a definition.
+   *   The parsed annotation as a definition.
    */
   protected function parse(array $values) {
     $definitions = array();

core/lib/Drupal/Core/Cache/Cache.php

@@ -149,7 +149,7 @@ public static function invalidateTags(array $tags) {
    * Gets all cache bin services.
    *
    * @return array
-   *  An array of cache backend objects keyed by cache bins.
+   *   An array of cache backend objects keyed by cache bins.
    */
   public static function getBins() {
     $bins = array();

core/lib/Drupal/Core/Cache/CacheableDependencyInterface.php

@@ -37,7 +37,7 @@ public function getCacheContexts();
    * When this object is modified, these cache tags will be invalidated.
    *
    * @return string[]
-   *  A set of cache tags.
+   *   A set of cache tags.
    */
   public function getCacheTags();
 

core/lib/Drupal/Core/Config/StorageInterface.php

@@ -93,28 +93,28 @@ public function rename($name, $new_name);
   /**
    * Encodes configuration data into the storage-specific format.
    *
+   * This is a publicly accessible static method to allow for alternative
+   * usages in data conversion scripts and also tests.
+   *
    * @param array $data
    *   The configuration data to encode.
    *
    * @return string
    *   The encoded configuration data.
-   *
-   * This is a publicly accessible static method to allow for alternative
-   * usages in data conversion scripts and also tests.
    */
   public function encode($data);
 
   /**
    * Decodes configuration data from the storage-specific format.
    *
+   * This is a publicly accessible static method to allow for alternative
+   * usages in data conversion scripts and also tests.
+   *
    * @param string $raw
    *   The raw configuration data string to decode.
    *
    * @return array
    *   The decoded configuration data as an associative array.
-   *
-   * This is a publicly accessible static method to allow for alternative
-   * usages in data conversion scripts and also tests.
    */
   public function decode($raw);
 

core/lib/Drupal/Core/Extension/module.api.php

@@ -72,6 +72,8 @@
  * frequently called should be left in the main module file so that they are
  * always available.
  *
+ * See system_hook_info() for all hook groups defined by Drupal core.
+ *
  * @return
  *   An associative array whose keys are hook names and whose values are an
  *   associative array containing:
@@ -79,8 +81,6 @@
  *     system will determine whether a file with the name $module.$group.inc
  *     exists, and automatically load it when required.
  *
- * See system_hook_info() for all hook groups defined by Drupal core.
- *
  * @see hook_hook_info_alter()
  */
 function hook_hook_info() {

core/lib/Drupal/Core/Plugin/ContextAwarePluginBase.php

@@ -41,11 +41,11 @@ protected function createContextFromConfiguration(array $context_configuration)
   /**
    * {@inheritdoc}
    *
-   * @return \Drupal\Core\Plugin\Context\ContextInterface
-   *   The context object.
-   *
    * This code is identical to the Component in order to pick up a different
    * Context class.
+   *
+   * @return \Drupal\Core\Plugin\Context\ContextInterface
+   *   The context object.
    */
   public function getContext($name) {
     // Check for a valid context value.

core/lib/Drupal/Core/Render/RenderCacheInterface.php

@@ -64,7 +64,7 @@ public function get(array $elements);
    *   this array.
    *
    * @return bool|null
-   *  Returns FALSE if no cache item could be created, NULL otherwise.
+   *   Returns FALSE if no cache item could be created, NULL otherwise.
    *
    * @see ::get()
    */

core/lib/Drupal/Core/Routing/UrlGenerator.php

@@ -253,7 +253,7 @@ protected function doGenerate(array $variables, array $defaults, array $tokens,
    *   $parameters merged in.
    *
    * @return string
-   *  The url path corresponding to the route, without the base path.
+   *   The url path corresponding to the route, without the base path.
    */
   protected function getInternalPathFromRoute($name, SymfonyRoute $route, $parameters = array(), $query_params = array()) {
     // The Route has a cache of its own and is not recompiled as long as it does

core/lib/Drupal/Core/Routing/UrlGeneratorInterface.php

@@ -21,7 +21,7 @@ interface UrlGeneratorInterface extends VersatileGeneratorInterface {
    *   \Symfony\Component\Routing\Generator\UrlGeneratorInterface::generate().
    *
    * @return string
-   *  The internal Drupal path corresponding to the route.
+   *   The internal Drupal path corresponding to the route.
    */
   public function getPathFromRoute($name, $parameters = array());
 

core/lib/Drupal/Core/StringTranslation/Translator/FileTranslation.php

@@ -82,7 +82,7 @@ public function findTranslationFiles($langcode = NULL) {
    *   want to find translation files.
    *
    * @return string
-   *  String file pattern.
+   *   String file pattern.
    */
   protected function getTranslationFilesPattern($langcode = NULL) {
     // The file name matches: drupal-[release version].[language code].po

core/modules/book/src/BookManagerInterface.php

@@ -18,6 +18,8 @@ interface BookManagerInterface {
    * Since this can be the full tree including hidden items, the data returned
    * may be used for generating an an admin interface or a select.
    *
+   * Note: based on menu_tree_all_data().
+   *
    * @param int $bid
    *   The Book ID to find links for.
    * @param array|null $link
@@ -31,8 +33,6 @@ interface BookManagerInterface {
    *
    * @return array
    *   An tree of menu links in an array, in the order they should be rendered.
-   *
-   * Note: based on menu_tree_all_data().
    */
   public function bookTreeAllData($bid, $link = NULL, $max_depth = NULL);
 

core/modules/contact/src/ContactFormInterface.php

@@ -21,7 +21,7 @@ public function getRecipients();
    * Returns an auto-reply message to send to the message author.
    *
    * @return string
-   *  An auto-reply message
+   *   An auto-reply message
    */
   public function getReply();
 

core/modules/content_translation/src/Controller/ContentTranslationController.php

@@ -77,8 +77,8 @@ public function prepareTranslation(ContentEntityInterface $entity, LanguageInter
    *   The route match.
    * @param string $entity_type_id
    *   (optional) The entity type ID.
-   * @return array Array of page elements to render.
-   * Array of page elements to render.
+   * @return array
+   *   Array of page elements to render.
    */
   public function overview(RouteMatchInterface $route_match, $entity_type_id = NULL) {
     /** @var \Drupal\Core\Entity\ContentEntityInterface $entity */

core/modules/field/src/Tests/FieldTestBase.php

@@ -17,7 +17,7 @@ abstract class FieldTestBase extends WebTestBase {
    * @param $cardinality
    *   Number of values to generate.
    * @return
-   *  An array of random values, in the format expected for field values.
+   *   An array of random values, in the format expected for field values.
    */
   function _generateTestFieldValues($cardinality) {
     $values = array();

core/modules/field/tests/src/Kernel/FieldKernelTestBase.php

@@ -158,7 +158,7 @@ protected function entityValidateAndSave(EntityInterface $entity) {
    * @param $cardinality
    *   Number of values to generate.
    * @return
-   *  An array of random values, in the format expected for field values.
+   *   An array of random values, in the format expected for field values.
    */
   protected function _generateTestFieldValues($cardinality) {
     $values = array();

core/modules/file/src/Plugin/migrate/destination/EntityFile.php

@@ -147,7 +147,7 @@ public function import(Row $row, array $old_destination_id_values = array()) {
    *   (optional) FILE_EXISTS_REPLACE (default) or FILE_EXISTS_RENAME.
    *
    * @return bool
-   *  TRUE on success, FALSE on failure.
+   *   TRUE on success, FALSE on failure.
    */
   protected function writeFile($source, $destination, $replace = FILE_EXISTS_REPLACE) {
     if ($this->configuration['move']) {
@@ -190,8 +190,8 @@ protected function getOverwriteMode(Row $row) {
    *   The URI or path.
    *
    * @return string|false
-   *  The directory component of the path or URI, or FALSE if it could not
-   *  be determined.
+   *   The directory component of the path or URI, or FALSE if it could not
+   *   be determined.
    */
   protected function getDirectory($uri) {
     $dir = $this->fileSystem->dirname($uri);
@@ -213,8 +213,8 @@ protected function getDirectory($uri) {
    *   The destination URI.
    *
    * @return bool
-   *  TRUE if the source and destination URIs refer to the same physical path,
-   *  otherwise FALSE.
+   *   TRUE if the source and destination URIs refer to the same physical path,
+   *   otherwise FALSE.
    */
   protected function isLocationUnchanged($source, $destination) {
     if ($this->isLocalUri($source) && $this->isLocalUri($destination)) {

core/modules/file/src/Tests/FileListingTest.php

@@ -148,7 +148,7 @@ function testFileListingPages() {
    * Creates and saves a test file.
    *
    * @return \Drupal\Core\Entity\EntityInterface
-   *  A file entity.
+   *   A file entity.
    */
   protected function createFile() {
     // Create a new file entity.