From b556c3aa25d519d1caaf8aa141427bad839110bf Mon Sep 17 00:00:00 2001 From: audrasjb Date: Mon, 24 Apr 2023 16:37:22 +0000 Subject: [PATCH] Docs: Use third-person singular verbs in various function descriptions, as per docblocks standards. Props laurentmagnin, pouicpouic, jbcouton, audrasjb. See #57840. Built from https://develop.svn.wordpress.org/trunk@55681 git-svn-id: http://core.svn.wordpress.org/trunk@55193 1a063a9b-81f0-0310-95a4-ce76da25c4cd --- .../class-wp-privacy-policy-content.php | 18 +++++++++--------- wp-includes/class-wp-comment.php | 12 ++++++------ wp-includes/version.php | 2 +- wp-includes/widgets/class-wp-widget-text.php | 8 ++++---- 4 files changed, 20 insertions(+), 20 deletions(-) diff --git a/wp-admin/includes/class-wp-privacy-policy-content.php b/wp-admin/includes/class-wp-privacy-policy-content.php index 0f8883afa9..c3dc60e1bb 100644 --- a/wp-admin/includes/class-wp-privacy-policy-content.php +++ b/wp-admin/includes/class-wp-privacy-policy-content.php @@ -20,7 +20,7 @@ final class WP_Privacy_Policy_Content { private function __construct() {} /** - * Add content to the postbox shown when editing the privacy policy. + * Adds content to the postbox shown when editing the privacy policy. * * Plugins and themes should suggest text for inclusion in the site's privacy policy. * The suggested text should contain information about any functionality that affects user privacy, @@ -49,7 +49,7 @@ final class WP_Privacy_Policy_Content { } /** - * Quick check if any privacy info has changed. + * Performs a quick check to determine whether any privacy info has changed. * * @since 4.9.6 */ @@ -123,7 +123,7 @@ final class WP_Privacy_Policy_Content { } /** - * Output a warning when some privacy info has changed. + * Outputs a warning when some privacy info has changed. * * @since 4.9.6 * @@ -154,7 +154,7 @@ final class WP_Privacy_Policy_Content { } /** - * Update the cached policy info when the policy page is updated. + * Updates the cached policy info when the policy page is updated. * * @since 4.9.6 * @access private @@ -203,7 +203,7 @@ final class WP_Privacy_Policy_Content { } /** - * Check for updated, added or removed privacy policy information from plugins. + * Checks for updated, added or removed privacy policy information from plugins. * * Caches the current info in post_meta of the policy page. * @@ -301,7 +301,7 @@ final class WP_Privacy_Policy_Content { } /** - * Add a notice with a link to the guide when editing the privacy policy page. + * Adds a notice with a link to the guide when editing the privacy policy page. * * @since 4.9.6 * @since 5.0.0 The `$post` parameter was made optional. @@ -372,7 +372,7 @@ final class WP_Privacy_Policy_Content { } /** - * Output the privacy policy guide together with content from the theme and plugins. + * Outputs the privacy policy guide together with content from the theme and plugins. * * @since 4.9.6 */ @@ -441,7 +441,7 @@ final class WP_Privacy_Policy_Content { } /** - * Return the default suggested privacy policy content. + * Returns the default suggested privacy policy content. * * @since 4.9.6 * @since 5.0.0 Added the `$blocks` parameter. @@ -690,7 +690,7 @@ final class WP_Privacy_Policy_Content { } /** - * Add the suggested privacy policy text to the policy postbox. + * Adds the suggested privacy policy text to the policy postbox. * * @since 4.9.6 */ diff --git a/wp-includes/class-wp-comment.php b/wp-includes/class-wp-comment.php index c5f8cc49f4..83d40a5261 100644 --- a/wp-includes/class-wp-comment.php +++ b/wp-includes/class-wp-comment.php @@ -219,7 +219,7 @@ final class WP_Comment { } /** - * Convert object to array. + * Converts object to array. * * @since 4.4.0 * @@ -230,7 +230,7 @@ final class WP_Comment { } /** - * Get the children of a comment. + * Gets the children of a comment. * * @since 4.4.0 * @@ -302,7 +302,7 @@ final class WP_Comment { } /** - * Add a child to the comment. + * Adds a child to the comment. * * Used by `WP_Comment_Query` when bulk-filling descendants. * @@ -315,7 +315,7 @@ final class WP_Comment { } /** - * Get a child comment by ID. + * Gets a child comment by ID. * * @since 4.4.0 * @@ -331,7 +331,7 @@ final class WP_Comment { } /** - * Set the 'populated_children' flag. + * Sets the 'populated_children' flag. * * This flag is important for ensuring that calling `get_children()` on a childless comment will not trigger * unneeded database queries. @@ -345,7 +345,7 @@ final class WP_Comment { } /** - * Check whether a non-public property is set. + * Determines whether a non-public property is set. * * If `$name` matches a post field, the comment post will be loaded and the post's value checked. * diff --git a/wp-includes/version.php b/wp-includes/version.php index f831e9a318..f2840c2320 100644 --- a/wp-includes/version.php +++ b/wp-includes/version.php @@ -16,7 +16,7 @@ * * @global string $wp_version */ -$wp_version = '6.3-alpha-55680'; +$wp_version = '6.3-alpha-55681'; /** * Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema. diff --git a/wp-includes/widgets/class-wp-widget-text.php b/wp-includes/widgets/class-wp-widget-text.php index 55c8663f3f..c0409e8ff5 100644 --- a/wp-includes/widgets/class-wp-widget-text.php +++ b/wp-includes/widgets/class-wp-widget-text.php @@ -44,7 +44,7 @@ class WP_Widget_Text extends WP_Widget { } /** - * Add hooks for enqueueing assets when registering all widget instances of this widget class. + * Adds hooks for enqueueing assets when registering all widget instances of this widget class. * * @param int $number Optional. The unique order number of this widget instance * compared to other instances of the same class. Default -1. @@ -340,7 +340,7 @@ class WP_Widget_Text extends WP_Widget { } /** - * Inject max-width and remove height for videos too constrained to fit inside sidebars on frontend. + * Injects max-width and removes height for videos too constrained to fit inside sidebars on frontend. * * @since 4.9.0 * @@ -410,7 +410,7 @@ class WP_Widget_Text extends WP_Widget { } /** - * Enqueue preview scripts. + * Enqueues preview scripts. * * These scripts normally are enqueued just-in-time when a playlist shortcode is used. * However, in the customizer, a playlist shortcode may be used in a text widget and @@ -510,7 +510,7 @@ class WP_Widget_Text extends WP_Widget { } /** - * Render form template scripts. + * Renders form template scripts. * * @since 4.8.0 * @since 4.9.0 The method is now static.