From 20c003e8425d2076b754f14874811a318ac5931c Mon Sep 17 00:00:00 2001 From: audrasjb Date: Tue, 7 Jun 2022 05:18:13 +0000 Subject: [PATCH] Docs: Use third-person singular verbs for function descriptions in the `Core Translation` API. See #55646. Built from https://develop.svn.wordpress.org/trunk@53474 git-svn-id: http://core.svn.wordpress.org/trunk@53063 1a063a9b-81f0-0310-95a4-ce76da25c4cd --- wp-includes/l10n.php | 54 ++++++++++++++++++++--------------------- wp-includes/version.php | 2 +- 2 files changed, 28 insertions(+), 28 deletions(-) diff --git a/wp-includes/l10n.php b/wp-includes/l10n.php index 98e527281e..fd817ed067 100644 --- a/wp-includes/l10n.php +++ b/wp-includes/l10n.php @@ -110,7 +110,7 @@ function get_user_locale( $user_id = 0 ) { } /** - * Determine the current locale desired for the request. + * Determines the current locale desired for the request. * * @since 5.0.0 * @@ -167,7 +167,7 @@ function determine_locale() { } /** - * Retrieve the translation of $text. + * Retrieves the translation of $text. * * If there is no translation, or the text domain isn't loaded, the original text is returned. * @@ -213,7 +213,7 @@ function translate( $text, $domain = 'default' ) { } /** - * Remove last item on a pipe-delimited string. + * Removes last item on a pipe-delimited string. * * Meant for removing the last item in a string, such as 'Role name|User role'. The original * string will be returned if no pipe '|' characters are found in the string. @@ -233,7 +233,7 @@ function before_last_bar( $string ) { } /** - * Retrieve the translation of $text in the context defined in $context. + * Retrieves the translation of $text in the context defined in $context. * * If there is no translation, or the text domain isn't loaded, the original text is returned. * @@ -282,7 +282,7 @@ function translate_with_gettext_context( $text, $context, $domain = 'default' ) } /** - * Retrieve the translation of $text. + * Retrieves the translation of $text. * * If there is no translation, or the text domain isn't loaded, the original text is returned. * @@ -298,7 +298,7 @@ function __( $text, $domain = 'default' ) { } /** - * Retrieve the translation of $text and escapes it for safe use in an attribute. + * Retrieves the translation of $text and escapes it for safe use in an attribute. * * If there is no translation, or the text domain isn't loaded, the original text is returned. * @@ -314,7 +314,7 @@ function esc_attr__( $text, $domain = 'default' ) { } /** - * Retrieve the translation of $text and escapes it for safe use in HTML output. + * Retrieves the translation of $text and escapes it for safe use in HTML output. * * If there is no translation, or the text domain isn't loaded, the original text * is escaped and returned. @@ -331,7 +331,7 @@ function esc_html__( $text, $domain = 'default' ) { } /** - * Display translated text. + * Displays translated text. * * @since 1.2.0 * @@ -344,7 +344,7 @@ function _e( $text, $domain = 'default' ) { } /** - * Display translated text that has been escaped for safe use in an attribute. + * Displays translated text that has been escaped for safe use in an attribute. * * Encodes `< > & " '` (less than, greater than, ampersand, double quote, single quote). * Will never double encode entities. @@ -362,7 +362,7 @@ function esc_attr_e( $text, $domain = 'default' ) { } /** - * Display translated text that has been escaped for safe use in HTML output. + * Displays translated text that has been escaped for safe use in HTML output. * * If there is no translation, or the text domain isn't loaded, the original text * is escaped and displayed. @@ -380,7 +380,7 @@ function esc_html_e( $text, $domain = 'default' ) { } /** - * Retrieve translated string with gettext context. + * Retrieves translated string with gettext context. * * Quite a few times, there will be collisions with similar translatable text * found in more than two places, but with different translated context. @@ -401,7 +401,7 @@ function _x( $text, $context, $domain = 'default' ) { } /** - * Display translated string with gettext context. + * Displays translated string with gettext context. * * @since 3.0.0 * @@ -415,7 +415,7 @@ function _ex( $text, $context, $domain = 'default' ) { } /** - * Translate string with gettext context, and escapes it for safe use in an attribute. + * Translates string with gettext context, and escapes it for safe use in an attribute. * * If there is no translation, or the text domain isn't loaded, the original text * is escaped and returned. @@ -433,7 +433,7 @@ function esc_attr_x( $text, $context, $domain = 'default' ) { } /** - * Translate string with gettext context, and escapes it for safe use in HTML output. + * Translates string with gettext context, and escapes it for safe use in HTML output. * * If there is no translation, or the text domain isn't loaded, the original text * is escaped and returned. @@ -686,7 +686,7 @@ function translate_nooped_plural( $nooped_plural, $count, $domain = 'default' ) } /** - * Load a .mo file into the text domain $domain. + * Loads a .mo file into the text domain $domain. * * If the text domain already exists, the translations will be merged. If both * sets have the same string, the translation from the original value will be taken. @@ -766,7 +766,7 @@ function load_textdomain( $domain, $mofile ) { } /** - * Unload translations for a text domain. + * Unloads translations for a text domain. * * @since 3.0.0 * @@ -818,7 +818,7 @@ function unload_textdomain( $domain ) { } /** - * Load default translated strings based on locale. + * Loads default translated strings based on locale. * * Loads the .mo file in WP_LANG_DIR constant path from WordPress root. * The translated (.mo) file is named based on the locale. @@ -904,7 +904,7 @@ function load_plugin_textdomain( $domain, $deprecated = false, $plugin_rel_path } /** - * Load the translated strings for a plugin residing in the mu-plugins directory. + * Loads the translated strings for a plugin residing in the mu-plugins directory. * * @since 3.0.0 * @since 4.6.0 The function now tries to load the .mo file from the languages directory first. @@ -931,7 +931,7 @@ function load_muplugin_textdomain( $domain, $mu_plugin_rel_path = '' ) { } /** - * Load the theme's translated strings. + * Loads the theme's translated strings. * * If the current locale exists as a .mo file in the theme's root directory, it * will be included in the translated strings by the $domain. @@ -972,7 +972,7 @@ function load_theme_textdomain( $domain, $path = false ) { } /** - * Load the child themes translated strings. + * Loads the child themes translated strings. * * If the current locale exists as a .mo file in the child themes * root directory, it will be included in the translated strings by the $domain. @@ -1299,7 +1299,7 @@ function _get_path_to_translation_from_lang_dir( $domain ) { } /** - * Return the Translations instance for a text domain. + * Returns the Translations instance for a text domain. * * If there isn't one, returns empty Translations instance. * @@ -1325,7 +1325,7 @@ function get_translations_for_domain( $domain ) { } /** - * Whether there are translations for the text domain. + * Determines whether there are translations for the text domain. * * @since 3.0.0 * @@ -1364,7 +1364,7 @@ function translate_user_role( $name, $domain = 'default' ) { } /** - * Get all available languages based on the presence of *.mo files in a given directory. + * Gets all available languages based on the presence of *.mo files in a given directory. * * The default directory is WP_LANG_DIR. * @@ -1401,7 +1401,7 @@ function get_available_languages( $dir = null ) { } /** - * Get installed translations. + * Gets installed translations. * * Looks in the wp-content/languages directory for translations of * plugins or themes. @@ -1457,7 +1457,7 @@ function wp_get_installed_translations( $type ) { } /** - * Extract headers from a PO file. + * Extracts headers from a PO file. * * @since 3.7.0 * @@ -1482,7 +1482,7 @@ function wp_get_pomo_file_data( $po_file ) { } /** - * Language selector. + * Displays or returns a Language selector. * * @since 4.0.0 * @since 4.3.0 Introduced the `echo` argument. @@ -1712,7 +1712,7 @@ function restore_current_locale() { } /** - * Whether switch_to_locale() is in effect. + * Determines whether switch_to_locale() is in effect. * * @since 4.7.0 * diff --git a/wp-includes/version.php b/wp-includes/version.php index 54a0b2e7dd..8e7eeb703c 100644 --- a/wp-includes/version.php +++ b/wp-includes/version.php @@ -16,7 +16,7 @@ * * @global string $wp_version */ -$wp_version = '6.1-alpha-53473'; +$wp_version = '6.1-alpha-53474'; /** * Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema.