Upstream/WordPress
1
0
Fork 0
mirror of https://github.com/WordPress/WordPress.git synced 2024-12-22 17:18:32 +01:00
Code Issues Projects Releases Wiki Activity

Docs: Use third-person singular verbs for function descriptions in the Core Translation API.

Browse Source 
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
This commit is contained in:
audrasjb 2022-06-07 05:18:13 +00:00
parent 56d7437f59
commit 20c003e842
2 changed files with 28 additions and 28 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

54
wp-includes/l10n.php
View File

@ -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 * @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. * 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 * 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. * 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. * 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. * 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. * 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 * If there is no translation, or the text domain isn't loaded, the original text
* is escaped and returned. * is escaped and returned.
@ -331,7 +331,7 @@ function esc_html__( $text, $domain = 'default' ) {
} }
/** /**
* Display translated text. * Displays translated text.
* *
* @since 1.2.0 * @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). * Encodes `< > & " '` (less than, greater than, ampersand, double quote, single quote).
* Will never double encode entities. * 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 * If there is no translation, or the text domain isn't loaded, the original text
* is escaped and displayed. * 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 * Quite a few times, there will be collisions with similar translatable text
* found in more than two places, but with different translated context. * 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 * @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 * If there is no translation, or the text domain isn't loaded, the original text
* is escaped and returned. * 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 * If there is no translation, or the text domain isn't loaded, the original text
* is escaped and returned. * 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 * 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. * 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 * @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. * Loads the .mo file in WP_LANG_DIR constant path from WordPress root.
* The translated (.mo) file is named based on the locale. * 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 3.0.0
* @since 4.6.0 The function now tries to load the .mo file from the languages directory first. * @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 * 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. * 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 * 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. * 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. * 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 * @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. * 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 * Looks in the wp-content/languages directory for translations of
* plugins or themes. * 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 * @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.0.0
* @since 4.3.0 Introduced the `echo` argument. * @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 * @since 4.7.0
* *

2
wp-includes/version.php
View File

@ -16,7 +16,7 @@
* *
* @global string $wp_version * @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. * Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema.