Issue #2716661 by anoopjohn: Fix 'Drupal.Commenting.FunctionComment' coding standard - Issues related to @see references

core/core.api.php

@@ -2095,7 +2095,7 @@ function hook_mail_backend_info_alter(&$info) {
  * @param $countries
  *   The associative array of countries keyed by two-letter country code.
  *
- * @see \Drupal\Core\Locale\CountryManager::getList().
+ * @see \Drupal\Core\Locale\CountryManager::getList()
  */
 function hook_countries_alter(&$countries) {
   // Elbonia is now independent, so add it to the country list.

core/includes/install.inc

@@ -362,13 +362,14 @@ function drupal_rewrite_settings($settings = array(), $settings_file = NULL) {
  * Checks whether this token represents a scalar or NULL.
  *
  * @param int $type
- *   The token type
+ *   The token type.
- *   @see token_name().
  * @param string $value
  *   The value of the token.
  *
  * @return bool
  *   TRUE if this token represents a scalar or NULL.
+ *
+ * @see token_name()
  */
 function _drupal_rewrite_settings_is_simple($type, $value) {
   $is_integer = $type == T_LNUMBER;
@@ -386,11 +387,12 @@ function _drupal_rewrite_settings_is_simple($type, $value) {
  * string.
  *
  * @param int $type
- *   The token type
+ *   The token type.
- *   @see token_name().
  *
  * @return bool
  *   TRUE if this token represents a number or a string.
+ *
+ * @see token_name()
  */
 function _drupal_rewrite_settings_is_array_index($type) {
   $is_integer = $type == T_LNUMBER;

core/lib/Drupal/Component/Plugin/Exception/InvalidPluginDefinitionException.php

@@ -17,10 +17,12 @@ class InvalidPluginDefinitionException extends PluginException {
   /**
    * Constructs a InvalidPluginDefinitionException.
    *
+   * For the remaining parameters see \Exception.
+   *
    * @param string $plugin_id
    *   The plugin ID of the mapper.
    *
-   * @see \Exception for the remaining parameters.
+   * @see \Exception
    */
   public function __construct($plugin_id, $message = '', $code = 0, \Exception $previous = NULL) {
     $this->pluginId = $plugin_id;

core/lib/Drupal/Component/Plugin/Exception/PluginNotFoundException.php

@@ -10,10 +10,12 @@ class PluginNotFoundException extends PluginException {
   /**
    * Construct an PluginNotFoundException exception.
    *
+   * For the remaining parameters see \Exception.
+   *
    * @param string $plugin_id
    *   The plugin ID that was not found.
    *
-   * @see \Exception for remaining parameters.
+   * @see \Exception
    */
   public function __construct($plugin_id, $message = '', $code = 0, \Exception $previous = NULL) {
     if (empty($message)) {

core/lib/Drupal/Core/Config/Entity/ConfigEntityType.php

@@ -127,11 +127,11 @@ class ConfigEntityType extends EntityType implements ConfigEntityTypeInterface {
   /**
    * {@inheritdoc}
    *
-   * @see \Drupal\Core\Config\Entity\ConfigEntityStorage.
-   *
    * @throws \Drupal\Core\Config\Entity\Exception\ConfigEntityStorageClassException
    *   Exception thrown when the provided class is not an instance of
    *   \Drupal\Core\Config\Entity\ConfigEntityStorage.
+   *
+   * @see \Drupal\Core\Config\Entity\ConfigEntityStorage
    */
   protected function checkStorageClass($class) {
     if (!is_a($class, 'Drupal\Core\Config\Entity\ConfigEntityStorage', TRUE)) {

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

@@ -67,10 +67,10 @@ interface StorageComparerInterface {
    *
    * Until the changelist has been calculated this will always be FALSE.
    *
-   * @see \Drupal\Core\Config\StorageComparerInterface::createChangelist().
-   *
    * @return bool
    *   TRUE if there are changes to process and FALSE if not.
+   *
+   * @see \Drupal\Core\Config\StorageComparerInterface::createChangelist()
    */
   public function hasChanges();
 

core/lib/Drupal/Core/Database/Driver/pgsql/Connection.php

@@ -374,7 +374,7 @@ class Connection extends DatabaseConnection {
    *   A string representing the savepoint name. By default,
    *   "mimic_implicit_commit" is used.
    *
-   * @see Drupal\Core\Database\Connection::pushTransaction().
+   * @see Drupal\Core\Database\Connection::pushTransaction()
    */
   public function addSavepoint($savepoint_name = 'mimic_implicit_commit') {
     if ($this->inTransaction()) {
@@ -389,7 +389,7 @@ class Connection extends DatabaseConnection {
    *   A string representing the savepoint name. By default,
    *   "mimic_implicit_commit" is used.
    *
-   * @see Drupal\Core\Database\Connection::popTransaction().
+   * @see Drupal\Core\Database\Connection::popTransaction()
    */
   public function releaseSavepoint($savepoint_name = 'mimic_implicit_commit') {
     if (isset($this->transactionLayers[$savepoint_name])) {

core/lib/Drupal/Core/Entity/ContentEntityType.php

@@ -28,11 +28,11 @@ class ContentEntityType extends EntityType implements ContentEntityTypeInterface
   /**
    * {@inheritdoc}
    *
-   * @see \Drupal\Core\Entity\ContentEntityStorageInterface.
-   *
    * @throws \InvalidArgumentException
    *   If the provided class does not implement
    *   \Drupal\Core\Entity\ContentEntityStorageInterface.
+   *
+   * @see \Drupal\Core\Entity\ContentEntityStorageInterface
    */
   protected function checkStorageClass($class) {
     $required_interface = ContentEntityStorageInterface::class;

core/lib/Drupal/Core/Entity/Query/QueryAggregateInterface.php

@@ -63,7 +63,7 @@ interface QueryAggregateInterface extends QueryInterface {
    * @return \Drupal\Core\Entity\Query\QueryAggregateInterface
    *   The called object.
    *
-   * @see \Drupal\Core\Entity\Query\QueryInterface::condition().
+   * @see \Drupal\Core\Entity\Query\QueryInterface::condition()
    */
   public function conditionAggregate($field, $function = NULL, $value = NULL, $operator = '=', $langcode = NULL);
 

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

@@ -81,7 +81,7 @@ use Drupal\Core\Utility\UpdateException;
  *
  * See system_hook_info() for all hook groups defined by Drupal core.
  *
- * @see hook_hook_info_alter().
+ * @see hook_hook_info_alter()
  */
 function hook_hook_info() {
   $hooks['token_info'] = array(

core/lib/Drupal/Core/Installer/InstallerKernel.php

@@ -27,7 +27,7 @@ class InstallerKernel extends DrupalKernel {
    * re-instantiated during a single install request. Most drivers will not
    * need this method.
    *
-   * @see \Drupal\Core\Database\Install\Tasks::runTasks().
+   * @see \Drupal\Core\Database\Install\Tasks::runTasks()
    */
   public function resetConfigStorage() {
     $this->configStorage = NULL;

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

@@ -29,8 +29,8 @@ trait LinkGeneratorTrait {
   /**
    * Renders a link to a route given a route name and its parameters.
    *
-   * @see \Drupal\Core\Utility\LinkGeneratorInterface::generate() for details
+   * For details on the arguments, usage, and possible exceptions see
-   *   on the arguments, usage, and possible exceptions.
+   * \Drupal\Core\Utility\LinkGeneratorInterface::generate().
    *
    * @return \Drupal\Core\GeneratedLink
    *   A GeneratedLink object containing a link to the given route and
@@ -38,6 +38,8 @@ trait LinkGeneratorTrait {
    *
    * @deprecated in Drupal 8.0.0 and will be removed before Drupal 9.0.0.
    *   Use \Drupal\Core\Link instead.
+   *
+   * @see \Drupal\Core\Utility\LinkGeneratorInterface::generate()
    */
   protected function l($text, Url $url) {
     return $this->getLinkGenerator()->generate($text, $url);

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

@@ -27,14 +27,16 @@ trait UrlGeneratorTrait {
   /**
    * Generates a URL or path for a specific route based on the given parameters.
    *
-   * @see \Drupal\Core\Routing\UrlGeneratorInterface::generateFromRoute() for
+   * For details on the arguments, usage, and possible exceptions see
-   *   details on the arguments, usage, and possible exceptions.
+   * \Drupal\Core\Routing\UrlGeneratorInterface::generateFromRoute().
    *
    * @return string
    *   The generated URL for the given route.
    *
    * @deprecated in Drupal 8.0.0 and will be removed before Drupal 9.0.0.
    *   Use \Drupal\Core\Url instead.
+   *
+   * @see \Drupal\Core\Routing\UrlGeneratorInterface::generateFromRoute()
    */
   protected function url($route_name, $route_parameters = array(), $options = array()) {
     return $this->getUrlGenerator()->generateFromRoute($route_name, $route_parameters, $options);

core/lib/Drupal/Core/Template/TwigExtension.php

@@ -206,10 +206,11 @@ class TwigExtension extends \Twig_Extension {
    * @param array $options
    *   (optional) An associative array of additional options. The 'absolute'
    *   option is forced to be FALSE.
-   *   @see \Drupal\Core\Routing\UrlGeneratorInterface::generateFromRoute().
    *
    * @return string
    *   The generated URL path (relative URL) for the given route.
+   *
+   * @see \Drupal\Core\Routing\UrlGeneratorInterface::generateFromRoute()
    */
   public function getPath($name, $parameters = array(), $options = array()) {
     $options['absolute'] = FALSE;

core/modules/book/src/BookManager.php

@@ -720,7 +720,7 @@ class BookManager implements BookManagerInterface {
    * @param array $flat
    *   A flat array of the menu links from $tree, passed by reference.
    *
-   * @see static::bookTreeGetFlat().
+   * @see static::bookTreeGetFlat()
    */
   protected function flatBookTree(array $tree, array &$flat) {
     foreach ($tree as $data) {

core/modules/field_ui/field_ui.api.php

@@ -27,7 +27,7 @@
  * @return array
  *   Returns the form array to be built.
  *
- * @see \Drupal\field_ui\DisplayOverView.
+ * @see \Drupal\field_ui\DisplayOverView
  */
 function hook_field_formatter_third_party_settings_form(\Drupal\Core\Field\FormatterInterface $plugin, \Drupal\Core\Field\FieldDefinitionInterface $field_definition, $view_mode, $form, \Drupal\Core\Form\FormStateInterface $form_state) {
   $element = array();
@@ -60,7 +60,7 @@ function hook_field_formatter_third_party_settings_form(\Drupal\Core\Field\Forma
  * @return array
  *   Returns the form array to be built.
  *
- * @see \Drupal\field_ui\FormDisplayOverView.
+ * @see \Drupal\field_ui\FormDisplayOverView
  */
 function hook_field_widget_third_party_settings_form(\Drupal\Core\Field\WidgetInterface $plugin, \Drupal\Core\Field\FieldDefinitionInterface $field_definition, $form_mode, $form, \Drupal\Core\Form\FormStateInterface $form_state) {
   $element = array();
@@ -87,7 +87,7 @@ function hook_field_widget_third_party_settings_form(\Drupal\Core\Field\WidgetIn
  *   - field_definition: The field definition.
  *   - view_mode: The view mode being configured.
  *
- * @see \Drupal\field_ui\DisplayOverView.
+ * @see \Drupal\field_ui\DisplayOverView
  */
 function hook_field_formatter_settings_summary_alter(&$summary, $context) {
   // Append a message to the summary when an instance of foo_formatter has
@@ -110,7 +110,7 @@ function hook_field_formatter_settings_summary_alter(&$summary, $context) {
  *   - field_definition: The field definition.
  *   - form_mode: The form mode being configured.
  *
- * @see \Drupal\field_ui\FormDisplayOverView.
+ * @see \Drupal\field_ui\FormDisplayOverView
  */
 function hook_field_widget_settings_summary_alter(&$summary, $context) {
   // Append a message to the summary when an instance of foo_widget has

core/modules/locale/src/LocaleConfigManager.php

@@ -204,7 +204,6 @@ class LocaleConfigManager {
    *   The translatable array structure. A nested array matching the exact
    *   structure under of the default configuration for $name with only the
    *   elements that are translatable wrapped into a TranslatableMarkup.
-   *   @see self::getTranslatableData().
    * @param string $langcode
    *   The language code to process the array with.
    *
@@ -212,6 +211,8 @@ class LocaleConfigManager {
    *   Processed translatable data array. Will only contain translations
    *   different from source strings or in case of untranslatable English, the
    *   source strings themselves.
+   *
+   * @see self::getTranslatableData()
    */
   protected function processTranslatableData($name, array $active, array $translatable, $langcode) {
     $translated = array();

core/modules/menu_ui/menu_ui.module

@@ -389,8 +389,8 @@ function menu_ui_form_node_form_submit($form, FormStateInterface $form_state) {
  *
  * Adds menu options to the node type form.
  *
- * @see NodeTypeForm::form().
+ * @see NodeTypeForm::form()
- * @see menu_ui_form_node_type_form_submit().
+ * @see menu_ui_form_node_type_form_submit()
  */
 function menu_ui_form_node_type_form_alter(&$form, FormStateInterface $form_state) {
   /** @var \Drupal\Core\Menu\MenuParentFormSelectorInterface $menu_parent_selector */
@@ -437,7 +437,7 @@ function menu_ui_form_node_type_form_alter(&$form, FormStateInterface $form_stat
 /**
  * Submit handler for forms with menu options.
  *
- * @see menu_ui_form_node_type_form_alter().
+ * @see menu_ui_form_node_type_form_alter()
  */
 function menu_ui_form_node_type_form_validate(&$form, FormStateInterface $form_state) {
   $available_menus = array_filter($form_state->getValue('menu_options'));
@@ -457,7 +457,7 @@ function menu_ui_form_node_type_form_validate(&$form, FormStateInterface $form_s
 /**
  * Entity builder for the node type form with menu options.
  *
- * @see menu_ui_form_node_type_form_alter().
+ * @see menu_ui_form_node_type_form_alter()
  */
 function menu_ui_form_node_type_form_builder($entity_type, NodeTypeInterface $type, &$form, FormStateInterface $form_state) {
   $type->setThirdPartySetting('menu_ui', 'available_menus', array_values(array_filter($form_state->getValue('menu_options'))));

core/modules/migrate/src/Plugin/MigrationInterface.php

@@ -279,7 +279,7 @@ interface MigrationInterface extends PluginInspectionInterface, DerivativeInspec
    * @return $this
    *   The migration entity.
    *
-   * @see Drupal\migrate_drupal\Plugin\migrate\load\LoadEntity::processLinkField().
+   * @see Drupal\migrate_drupal\Plugin\migrate\load\LoadEntity::processLinkField()
    */
   public function mergeProcessOfProperty($property, array $process_of_property);
 

core/modules/options/tests/options_test/options_test.module

@@ -11,7 +11,7 @@ use Drupal\Core\Field\FieldStorageDefinitionInterface;
 /**
  * Implements callback_allowed_values_function().
  *
- * @see options_allowed_values().
+ * @see options_allowed_values()
  */
 function options_test_allowed_values_callback(FieldStorageDefinitionInterface $definition, FieldableEntityInterface $entity = NULL) {
   $values = array(
@@ -38,7 +38,7 @@ function options_test_allowed_values_callback(FieldStorageDefinitionInterface $d
  *   NULL. Since this is not yet used for testing Views integration, that is
  *   alright for now. Fix this in https://www.drupal.org/node/2012130.
  *
- * @see options_allowed_values().
+ * @see options_allowed_values()
  */
 function options_test_dynamic_values_callback(FieldStorageDefinitionInterface $definition, FieldableEntityInterface $entity = NULL, &$cacheable = NULL) {
   $values = array();

core/modules/simpletest/src/WebTestBase.php

@@ -1302,7 +1302,7 @@ abstract class WebTestBase extends TestBase {
    * @param $header
    *   An header.
    *
-   * @see _drupal_log_error().
+   * @see _drupal_log_error()
    */
   protected function curlHeaderCallback($curlHandler, $header) {
     // Header fields can be extended over multiple lines by preceding each

core/modules/system/src/Tests/Entity/EntityDefinitionTestTrait.php

@@ -199,7 +199,7 @@ trait EntityDefinitionTestTrait {
   /**
    * Adds an index to the 'entity_test_update' entity type's base table.
    *
-   * @see \Drupal\entity_test\EntityTestStorageSchema::getEntitySchema().
+   * @see \Drupal\entity_test\EntityTestStorageSchema::getEntitySchema()
    */
   protected function addEntityIndex() {
     $indexes = array(

core/modules/system/src/Tests/Menu/MenuRouterTest.php

@@ -205,7 +205,7 @@ class MenuRouterTest extends WebTestBase {
   /**
    * Make sure the maintenance mode can be bypassed using an EventSubscriber.
    *
-   * @see \Drupal\menu_test\EventSubscriber\MaintenanceModeSubscriber::onKernelRequestMaintenance().
+   * @see \Drupal\menu_test\EventSubscriber\MaintenanceModeSubscriber::onKernelRequestMaintenance()
    */
   public function testMaintenanceModeLoginPaths() {
     $this->container->get('state')->set('system.maintenance_mode', TRUE);

core/modules/system/src/Tests/System/SystemAuthorizeTest.php

@@ -34,7 +34,7 @@ class SystemAuthorizeTest extends WebTestBase {
    * $_SESSION inside the test site, not the framework site. This callback
    * redirects to authorize.php when it's done initializing.
    *
-   * @see system_authorized_init().
+   * @see system_authorized_init()
    */
   function drupalGetAuthorizePHP($page_title = 'system-test-auth') {
     $this->drupalGet('system-test/authorize-init/' . $page_title);

core/modules/system/src/Tests/TypedData/TypedDataTest.php

@@ -50,7 +50,7 @@ class TypedDataTest extends KernelTestBase {
   /**
    * Creates a typed data object and ensures it implements TypedDataInterface.
    *
-   * @see \Drupal\Core\TypedData\TypedDataManager::create().
+   * @see \Drupal\Core\TypedData\TypedDataManager::create()
    */
   protected function createTypedData($definition, $value = NULL, $name = NULL) {
     if (is_array($definition)) {

core/modules/system/system.module

@@ -1138,7 +1138,7 @@ function system_sort_modules_by_info_name($a, $b) {
  * Callback for uasort() within
  * \Drupal\system\Controller\SystemController::themesPage().
  *
- * @see system_sort_modules_by_info_name().
+ * @see system_sort_modules_by_info_name()
  */
 function system_sort_themes($a, $b) {
   if ($a->is_default) {

core/modules/system/tests/modules/menu_test/menu_test.module

@@ -82,7 +82,7 @@ function menu_test_menu_name($new_name = '') {
  * @return string
  *   A string containing the title and case number.
  *
- * @see menu_test_menu().
+ * @see menu_test_menu()
  */
 function menu_test_title_callback($title, $case_number = 3) {
   return t($title) . ' - Case ' . $case_number;

core/modules/system/tests/modules/module_test/module_test.module

@@ -69,7 +69,7 @@ function module_test_hook_info() {
 /**
  * Load function used by module_test_hook_dynamic_loading_invoke_all_during_load().
  *
- * @see module_test_menu().
+ * @see module_test_menu()
  */
 function module_test_load($param) {
   $result = \Drupal::moduleHandler()->invokeAll('test_hook');

core/modules/system/tests/modules/system_test/src/Controller/SystemTestController.php

@@ -242,7 +242,7 @@ class SystemTestController extends ControllerBase {
   /**
    * Initialize authorize.php during testing.
    *
-   * @see system_authorized_init().
+   * @see system_authorized_init()
    */
   public function authorizeInit($page_title) {
     $authorize_url = Url::fromUri('base:core/authorize.php', array('absolute' => TRUE))->toString();

core/modules/taxonomy/src/TermTranslationHandler.php

@@ -24,7 +24,7 @@ class TermTranslationHandler extends ContentTranslationHandler {
    *
    * This handles the save action.
    *
-   * @see \Drupal\Core\Entity\EntityForm::build().
+   * @see \Drupal\Core\Entity\EntityForm::build()
    */
   function entityFormSave(array $form, FormStateInterface $form_state) {
     if ($this->getSourceLangcode($form_state)) {

core/modules/toolbar/src/Element/Toolbar.php

@@ -61,7 +61,7 @@ class Toolbar extends RenderElement {
    * @return array
    *  A renderable array.
    *
-   * @see toolbar_page_top().
+   * @see toolbar_page_top()
    */
   public static function preRenderToolbar($element) {
     // Get the configured breakpoints to switch from vertical to horizontal

core/modules/user/src/ProfileTranslationHandler.php

@@ -40,7 +40,7 @@ class ProfileTranslationHandler extends ContentTranslationHandler {
    *
    * This handles the save action.
    *
-   * @see \Drupal\Core\Entity\EntityForm::build().
+   * @see \Drupal\Core\Entity\EntityForm::build()
    */
   public function entityFormSave(array $form, FormStateInterface $form_state) {
     if ($this->getSourceLangcode($form_state)) {

core/modules/user/src/UserInterface.php

@@ -180,7 +180,7 @@ interface UserInterface extends ContentEntityInterface, EntityChangedInterface,
    * @return bool
    *   TRUE if the correct existing password was provided.
    *
-   * @see UserInterface::setExistingPassword().
+   * @see UserInterface::setExistingPassword()
    */
   public function checkExistingPassword(UserInterface $account_unchanged);
 

core/modules/views/src/Plugin/views/BrokenHandlerTrait.php

@@ -13,7 +13,7 @@ trait BrokenHandlerTrait {
   /**
    * Returns this handlers name in the UI.
    *
-   * @see \Drupal\views\Plugin\views\PluginBase::defineOptions().
+   * @see \Drupal\views\Plugin\views\PluginBase::defineOptions()
    */
   public function adminLabel($short = FALSE) {
     return t('Broken/missing handler');
@@ -22,7 +22,7 @@ trait BrokenHandlerTrait {
   /**
    * The option definition for this handler.
    *
-   * @see \Drupal\views\Plugin\views\PluginBase::defineOptions().
+   * @see \Drupal\views\Plugin\views\PluginBase::defineOptions()
    */
   public function defineOptions() {
     return array();
@@ -32,7 +32,7 @@ trait BrokenHandlerTrait {
    * Ensure the main table for this handler is in the query. This is used
    * a lot.
    *
-   * @see \Drupal\views\Plugin\views\HandlerBase::ensureMyTable().
+   * @see \Drupal\views\Plugin\views\HandlerBase::ensureMyTable()
    */
   public function ensureMyTable() {
     // No table to ensure.
@@ -48,7 +48,7 @@ trait BrokenHandlerTrait {
   /**
    * Provides a form to edit options for this plugin.
    *
-   * @see \Drupal\views\Plugin\views\PluginBase::defineOptions().
+   * @see \Drupal\views\Plugin\views\PluginBase::defineOptions()
    */
   public function buildOptionsForm(&$form, FormStateInterface $form_state) {
     $description_top = t('The handler for this item is broken or missing. The following details are available:');
@@ -84,7 +84,7 @@ trait BrokenHandlerTrait {
    *
    * This means it's a placeholder used when a handler can't be found.
    *
-   * @see \Drupal\views\Plugin\views\HandlerBase::broken().
+   * @see \Drupal\views\Plugin\views\HandlerBase::broken()
    */
   public function broken() {
     return TRUE;
@@ -95,7 +95,7 @@ trait BrokenHandlerTrait {
    *
    * @return array
    *
-   * @see \Drupal\views\Plugin\views\PluginBase::calculateDependencies().
+   * @see \Drupal\views\Plugin\views\PluginBase::calculateDependencies()
    */
   public function calculateDependencies() {
     return [];

core/modules/views/src/Plugin/views/argument/ArgumentPluginBase.php

@@ -1206,7 +1206,7 @@ abstract class ArgumentPluginBase extends HandlerBase implements CacheableDepend
    * @return string
    *   The sanitized identifier.
    *
-   * @see decodeValidatorId().
+   * @see decodeValidatorId()
    */
   public static function encodeValidatorId($id) {
     return str_replace(':', '---', $id);

core/modules/views/src/Tests/TestHelperPlugin.php

@@ -21,7 +21,7 @@ class TestHelperPlugin extends PluginBase {
   /**
    * Calls the protected method setOptionDefaults().
    *
-   * @see \Drupal\views\Plugin\views\PluginBase::setOptionDefaults().
+   * @see \Drupal\views\Plugin\views\PluginBase::setOptionDefaults()
    */
   public function testSetOptionDefaults(&$storage, $options, $level = 0) {
     $this->setOptionDefaults($storage, $options, $level);

core/modules/views/src/Tests/Wizard/BasicTest.php

@@ -193,7 +193,7 @@ class BasicTest extends WizardTestBase {
   /**
    * Tests default plugin values are populated from the wizard form.
    *
-   * @see \Drupal\views\Plugin\views\display\DisplayPluginBase::mergeDefaults().
+   * @see \Drupal\views\Plugin\views\display\DisplayPluginBase::mergeDefaults()
    */
   public function testWizardDefaultValues() {
     $random_id = strtolower($this->randomMachineName(16));

core/modules/views/tests/src/Kernel/Plugin/ViewsBlockTest.php

@@ -39,7 +39,7 @@ class ViewsBlockTest extends ViewsKernelTestBase {
   /**
    * Tests that ViewsBlock::getMachineNameSuggestion() produces the right value.
    *
-   * @see \Drupal\views\Plugin\Block::getmachineNameSuggestion().
+   * @see \Drupal\views\Plugin\Block::getmachineNameSuggestion()
    */
   public function testMachineNameSuggestion() {
     $plugin_definition = array(

core/phpcs.xml.dist

@@ -60,8 +60,6 @@
     <exclude name="Drupal.Commenting.FunctionComment.ParamCommentNotCapital"/>
     <exclude name="Drupal.Commenting.FunctionComment.ParamNameNoMatch"/>
     <exclude name="Drupal.Commenting.FunctionComment.ReturnCommentIndentation"/>
-    <exclude name="Drupal.Commenting.FunctionComment.SeeAdditionalText"/>
-    <exclude name="Drupal.Commenting.FunctionComment.SeePunctuation"/>
     <exclude name="Drupal.Commenting.FunctionComment.TypeHintMissing"/>
     <exclude name="Drupal.Commenting.FunctionComment.VoidReturn"/>
   </rule>

core/tests/Drupal/Tests/Component/Datetime/DateTimePlusTest.php

@@ -286,7 +286,7 @@ class DateTimePlusTest extends UnitTestCase {
    *   An array of arrays, each containing the input parameters for
    *   DateTimePlusTest::testDates().
    *
-   * @see DateTimePlusTest::testDates().
+   * @see DateTimePlusTest::testDates()
    */
   public function providerTestDates() {
     return array(
@@ -313,7 +313,7 @@ class DateTimePlusTest extends UnitTestCase {
    *   An array of arrays, each containing the input parameters for
    *   DateTimePlusTest::testDates().
    *
-   * @see DateTimePlusTest::testDates().
+   * @see DateTimePlusTest::testDates()
    */
   public function providerTestDateArrays() {
     return array(

core/tests/Drupal/Tests/Core/Asset/JsOptimizerUnitTest.php

@@ -31,7 +31,7 @@ class JsOptimizerUnitTest extends UnitTestCase {
   /**
    * Provides data for the JS asset cleaning test.
    *
-   * @see \Drupal\Core\Asset\JsOptimizer::clean().
+   * @see \Drupal\Core\Asset\JsOptimizer::clean()
    *
    * @returns array
    *   An array of test data.
@@ -78,7 +78,7 @@ class JsOptimizerUnitTest extends UnitTestCase {
   /**
    * Provides data for the JS asset optimize test.
    *
-   * @see \Drupal\Core\Asset\JsOptimizer::optimize().
+   * @see \Drupal\Core\Asset\JsOptimizer::optimize()
    *
    * @returns array
    *   An array of test data.

core/tests/Drupal/Tests/Core/Block/BlockBaseTest.php

@@ -14,7 +14,7 @@ class BlockBaseTest extends UnitTestCase {
   /**
    * Tests the machine name suggestion.
    *
-   * @see \Drupal\Core\Block\BlockBase::getMachineNameSuggestion().
+   * @see \Drupal\Core\Block\BlockBase::getMachineNameSuggestion()
    */
   public function testGetMachineNameSuggestion() {
     $module_handler = $this->getMock('Drupal\Core\Extension\ModuleHandlerInterface');

core/tests/Drupal/Tests/Core/ParamConverter/ParamConverterManagerTest.php

@@ -65,7 +65,7 @@ class ParamConverterManagerTest extends UnitTestCase {
    *   An array of arrays, each containing the input parameters for
    *   providerTestResolvers::testAddConverter().
    *
-   * @see ParamConverterManagerTest::testAddConverter().
+   * @see ParamConverterManagerTest::testAddConverter()
    */
   public function providerTestAddConverter() {
     $converters[0]['unsorted'] = array(
@@ -108,7 +108,7 @@ class ParamConverterManagerTest extends UnitTestCase {
    *   An array of arrays, each containing the input parameters for
    *   providerTestResolvers::testGetConverter().
    *
-   * @see ParamConverterManagerTest::testGetConverter().
+   * @see ParamConverterManagerTest::testGetConverter()
    */
   public function providerTestGetConverter() {
     return array(

core/tests/Drupal/Tests/Core/Plugin/Discovery/DerivativeDiscoveryDecoratorTest.php

@@ -29,7 +29,7 @@ class DerivativeDiscoveryDecoratorTest extends UnitTestCase {
   /**
    * Tests the getDerivativeFetcher method.
    *
-   * @see \Drupal\Component\Plugin\Discovery\DerivativeDiscoveryDecorator::getDerivativeFetcher().
+   * @see \Drupal\Component\Plugin\Discovery\DerivativeDiscoveryDecorator::getDerivativeFetcher()
    */
   public function testGetDerivativeFetcher() {
     $definitions = array();

core/tests/Drupal/Tests/Core/Session/UserSessionTest.php

@@ -135,7 +135,7 @@ class UserSessionTest extends UnitTestCase {
    *
    * @dataProvider providerTestHasPermission
    *
-   * @see \Drupal\Core\Session\UserSession::hasPermission().
+   * @see \Drupal\Core\Session\UserSession::hasPermission()
    */
   public function testHasPermission($permission, array $sessions_with_access, array $sessions_without_access) {
     foreach ($sessions_with_access as $name) {