diff --git a/core/lib/Drupal/Core/Render/theme.api.php b/core/lib/Drupal/Core/Render/theme.api.php index cb960152278ad64531f71edfef6925ddf8bc5db5..cd33aecbc29b1ad671d13feca25c9724ed7590d7 100644 --- a/core/lib/Drupal/Core/Render/theme.api.php +++ b/core/lib/Drupal/Core/Render/theme.api.php @@ -857,8 +857,7 @@ function hook_element_plugin_alter(array &$definitions) { } /** - * Perform necessary alterations to the JavaScript before it is presented on - * the page. + * Alters JavaScript before it is presented on the page. * * @param $javascript * An array of all JavaScript being presented on the page. diff --git a/core/modules/comment/tests/modules/comment_empty_title_test/comment_empty_title_test.module b/core/modules/comment/tests/modules/comment_empty_title_test/comment_empty_title_test.module index 3fe1616e7b3583442e7bcf67e5ed83a174d9e323..9baeb7e3f17c94b11e26cca873d1bc1416bb7b30 100644 --- a/core/modules/comment/tests/modules/comment_empty_title_test/comment_empty_title_test.module +++ b/core/modules/comment/tests/modules/comment_empty_title_test/comment_empty_title_test.module @@ -2,8 +2,7 @@ /** * @file - * Dummy module emptying comment titles to test for appropriate and accessible - * markup in edge case scenarios where comments have empty titles. + * Empties comment titles to test markup in edge case scenarios. */ /** diff --git a/core/modules/comment/tests/modules/comment_test/comment_test.module b/core/modules/comment/tests/modules/comment_test/comment_test.module index 3b5437e2acc1318fe838689d22b08e9cdf44c605..3dd4f427909aa1e0e3365046e5224dea2f891205 100644 --- a/core/modules/comment/tests/modules/comment_test/comment_test.module +++ b/core/modules/comment/tests/modules/comment_test/comment_test.module @@ -2,8 +2,7 @@ /** * @file - * Dummy module implementing comment related hooks to test API interaction with - * the Comment module. + * Implements comment-related hooks to test API interactions. */ use Drupal\comment\CommentInterface; diff --git a/core/modules/file/tests/file_test/file_test.module b/core/modules/file/tests/file_test/file_test.module index 22fc35d8992f6919458f1872d9614fd9c5a0a698..720912609552442a287be7d96dfa343954ea0e6a 100644 --- a/core/modules/file/tests/file_test/file_test.module +++ b/core/modules/file/tests/file_test/file_test.module @@ -42,8 +42,9 @@ function file_test_reset() { } /** - * Get the arguments passed to invocation of a given hook since - * file_test_reset() was last called. + * Gets the arguments passed to a given hook invocation. + * + * Arguments are gathered since file_test_reset() was last called. * * @param string $op * One of the hook_file_* operations: 'load', 'validate', 'download', diff --git a/core/modules/locale/locale.compare.inc b/core/modules/locale/locale.compare.inc index d10114acaad1197d2d82cebdef30faac1c8edbf5..b07c5360c70bcd0d624d0817c2ae3f4c759c3de2 100644 --- a/core/modules/locale/locale.compare.inc +++ b/core/modules/locale/locale.compare.inc @@ -253,8 +253,7 @@ function locale_translation_batch_status_build($projects = [], $langcodes = []) } /** - * Helper function to construct batch operations checking remote translation - * status. + * Constructs batch operations for checking remote translation status. * * @param array $projects * Array of project names to be processed. diff --git a/core/modules/locale/locale.module b/core/modules/locale/locale.module index c06ea62bb237e20d96728611feba152ba74024f9..ab64ccf4c8016f8afd2ed3414fc75f3f51aa9a14 100644 --- a/core/modules/locale/locale.module +++ b/core/modules/locale/locale.module @@ -1071,8 +1071,9 @@ function _locale_strip_quotes($string) { } /** - * Parses a JavaScript file, extracts strings wrapped in Drupal.t() and - * Drupal.formatPlural() and inserts them into the database. + * Parses a JavaScript file, extracts translatable strings, and saves them. + * + * Strings are extracted from both Drupal.t() and Drupal.formatPlural(). * * @param string $filepath * File name to parse. diff --git a/core/modules/migrate/tests/modules/migrate_prepare_row_test/migrate_prepare_row_test.module b/core/modules/migrate/tests/modules/migrate_prepare_row_test/migrate_prepare_row_test.module index 6b7bc8c25f025eefc727f36c2f2b3b744e0f9d92..6c14847781c1f3aa4462958c19c503f3353dc14b 100644 --- a/core/modules/migrate/tests/modules/migrate_prepare_row_test/migrate_prepare_row_test.module +++ b/core/modules/migrate/tests/modules/migrate_prepare_row_test/migrate_prepare_row_test.module @@ -2,8 +2,7 @@ /** * @file - * Test module for testing the migration source plugin prepareRow() exception - * handling. + * Tests the migration source plugin prepareRow() exception handling. */ use Drupal\migrate\Plugin\MigrationInterface; diff --git a/core/modules/migrate/tests/modules/migrate_skip_all_rows_test/migrate_skip_all_rows_test.module b/core/modules/migrate/tests/modules/migrate_skip_all_rows_test/migrate_skip_all_rows_test.module index cd87d0ee1de7dd42410b7205e743f7c63b216b51..a9c91ebbefd055f05846ebbb8bce211370ac7690 100644 --- a/core/modules/migrate/tests/modules/migrate_skip_all_rows_test/migrate_skip_all_rows_test.module +++ b/core/modules/migrate/tests/modules/migrate_skip_all_rows_test/migrate_skip_all_rows_test.module @@ -2,8 +2,7 @@ /** * @file - * Test module for testing the migration source plugin prepareRow() exception - * handling. + * Tests the migration source plugin prepareRow() exception. */ use Drupal\migrate\Plugin\MigrationInterface; diff --git a/core/modules/search/tests/modules/search_langcode_test/search_langcode_test.module b/core/modules/search/tests/modules/search_langcode_test/search_langcode_test.module index 38330602a5a624e3a808ee1fe692bf99061e11e7..53015fa4324122ce41af06c75efdc8caa37c3331 100644 --- a/core/modules/search/tests/modules/search_langcode_test/search_langcode_test.module +++ b/core/modules/search/tests/modules/search_langcode_test/search_langcode_test.module @@ -2,9 +2,10 @@ /** * @file - * Test module setting up two tests, one for checking if the entity $langcode is - * being passed on and another one sets up the alternate verb forms for the - * stemming test. + * Tests the preprocessing of search text. + * + * Preprocessing is tested when the language code is passed to the preprocess + * hook and also when with alternate verb forms for the stemming test. */ /** diff --git a/core/modules/system/tests/modules/update_test_description/update_test_description.install b/core/modules/system/tests/modules/update_test_description/update_test_description.install index 1ed00ccad30b7c046bdacd2481041203fb10585c..06ce31ad36b655f460a1e7825c301d6271047c9c 100644 --- a/core/modules/system/tests/modules/update_test_description/update_test_description.install +++ b/core/modules/system/tests/modules/update_test_description/update_test_description.install @@ -11,9 +11,11 @@ function update_test_description_update_8001() { } +// @codingStandardsIgnoreStart /** * Update test with multiline description, the quick brown fox jumped over the * lazy dog. */ function update_test_description_update_8002() { } +// @codingStandardsIgnoreEnd diff --git a/core/modules/taxonomy/tests/modules/taxonomy_term_display_configurable_test/taxonomy_term_display_configurable_test.module b/core/modules/taxonomy/tests/modules/taxonomy_term_display_configurable_test/taxonomy_term_display_configurable_test.module index 6114a9c45df9054b2e64238e08d4b17bf18258da..3d0607894848327652e2c4433d32c10b0c72de96 100644 --- a/core/modules/taxonomy/tests/modules/taxonomy_term_display_configurable_test/taxonomy_term_display_configurable_test.module +++ b/core/modules/taxonomy/tests/modules/taxonomy_term_display_configurable_test/taxonomy_term_display_configurable_test.module @@ -2,8 +2,7 @@ /** * @file - * A module for testing making taxonomy_term base fields' displays - * configurable. + * Tests configurable displays for taxonomy_term base fields. */ use Drupal\Core\Entity\EntityTypeInterface; diff --git a/core/modules/user/user.module b/core/modules/user/user.module index 4109a3b8f99391b7147b00d20cc4e4af436bf27d..fc5484150e1b123f4a850521f4de48fb4143c621 100644 --- a/core/modules/user/user.module +++ b/core/modules/user/user.module @@ -1012,8 +1012,7 @@ function user_role_revoke_permissions($rid, array $permissions = []) { } /** - * Conditionally create and send a notification email when a certain - * operation happens on the given user account. + * Creates and sends a notification email following a change to a user account. * * @param string $op * The operation being performed on the account. Possible values: diff --git a/core/modules/views/views.module b/core/modules/views/views.module index 0c781090b896872eaf3b13bc904c3c30cd6f5be7..17698310447f9791ac47742be637705f0ad615d8 100644 --- a/core/modules/views/views.module +++ b/core/modules/views/views.module @@ -219,8 +219,7 @@ function views_theme($existing, $type, $theme, $path) { } /** - * A theme preprocess function to automatically allow view-based node - * templates if called from a view. + * Allows view-based node templates if called from a view. * * The 'modules/node.views.inc' file is a better place for this, but * we haven't got a chance to load that file before Drupal builds the @@ -256,8 +255,7 @@ function views_theme_suggestions_node_alter(array &$suggestions, array $variable } /** - * A theme preprocess function to automatically allow view-based node - * templates if called from a view. + * Allows view-based comment templates if called from a view. */ function views_preprocess_comment(&$variables) { // The view data is added to the comment in diff --git a/core/modules/views_ui/admin.inc b/core/modules/views_ui/admin.inc index 230dd773ae19590fa19e4d78d3426030fe317761..92f2d7d91d7a212e8512f4d76dc109f7047a2c85 100644 --- a/core/modules/views_ui/admin.inc +++ b/core/modules/views_ui/admin.inc @@ -200,9 +200,7 @@ function views_ui_nojs_submit($form, FormStateInterface $form_state) { } /** - * Add a <select> dropdown for a given section, allowing the user to - * change whether this info is stored on the default display or on - * the current display. + * Adds an element to select either the default display or the current display. */ function views_ui_standard_display_dropdown(&$form, FormStateInterface $form_state, $section) { $view = $form_state->get('view'); @@ -269,8 +267,7 @@ function views_ui_standard_display_dropdown(&$form, FormStateInterface $form_sta } /** - * Create the menu path for one of our standard AJAX forms based upon known - * information about the form. + * Creates the menu path for a standard AJAX form given the form state. * * @return \Drupal\Core\Url * The URL object pointing to the form URL.