Upstream/WordPress
1
0
Fork 0
mirror of https://github.com/WordPress/WordPress.git synced 2024-06-21 20:35:00 +02:00
Code Issues Projects Releases Wiki Activity

Docs: Use third-person singular verbs for function descriptions in wp-includes/category-template.php, per the documentation standards.

Browse Source 
See #49572.
Built from https://develop.svn.wordpress.org/trunk@47545


git-svn-id: http://core.svn.wordpress.org/trunk@47320 1a063a9b-81f0-0310-95a4-ce76da25c4cd
This commit is contained in:
Sergey Biryukov 2020-04-02 15:51:08 +00:00
parent 4ef14fd7af
commit ca8463f4f4
2 changed files with 24 additions and 24 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

46
wp-includes/category-template.php
View File

@ -8,7 +8,7 @@
*/ */
/** /**
* Retrieve category link URL. * Retrieves category link URL.
* *
* @since 1.0.0 * @since 1.0.0
* @see get_term_link() * @see get_term_link()
@ -31,7 +31,7 @@ function get_category_link( $category ) {
} }
/** /**
* Retrieve category parents with separator. * Retrieves category parents with separator.
* *
* @since 1.2.0 * @since 1.2.0
* @since 4.8.0 The `$visited` parameter was deprecated and renamed to `$deprecated`. * @since 4.8.0 The `$visited` parameter was deprecated and renamed to `$deprecated`.
@ -61,7 +61,7 @@ function get_category_parents( $id, $link = false, $separator = '/', $nicename =
} }
/** /**
* Retrieve post categories. * Retrieves post categories.
* *
* This tag may be used outside The Loop by passing a post id as the parameter. * This tag may be used outside The Loop by passing a post id as the parameter.
* *
@ -98,7 +98,7 @@ function get_the_category( $id = false ) {
} }
/** /**
* Retrieve category name based on category ID. * Retrieves category name based on category ID.
* *
* @since 0.71 * @since 0.71
* *
@ -117,7 +117,7 @@ function get_the_category_by_ID( $cat_ID ) { // phpcs:ignore WordPress.NamingCon
} }
/** /**
* Retrieve category list for a post in either HTML list or custom format. * Retrieves category list for a post in either HTML list or custom format.
* *
* @since 1.5.1 * @since 1.5.1
* *
@ -251,7 +251,7 @@ function in_category( $category, $post = null ) {
} }
/** /**
* Display category list for a post in either HTML list or custom format. * Displays category list for a post in either HTML list or custom format.
* *
* @since 0.71 * @since 0.71
* *
@ -265,7 +265,7 @@ function the_category( $separator = '', $parents = '', $post_id = false ) {
} }
/** /**
* Retrieve category description. * Retrieves category description.
* *
* @since 1.0.0 * @since 1.0.0
* *
@ -277,7 +277,7 @@ function category_description( $category = 0 ) {
} }
/** /**
* Display or retrieve the HTML dropdown list of categories. * Displays or retrieves the HTML dropdown list of categories.
* *
* The 'hierarchical' argument, which is disabled by default, will override the * The 'hierarchical' argument, which is disabled by default, will override the
* depth argument, unless it is true. When the argument is false, it will * depth argument, unless it is true. When the argument is false, it will
@ -465,7 +465,7 @@ function wp_dropdown_categories( $args = '' ) {
} }
/** /**
* Display or retrieve the HTML list of categories. * Displays or retrieves the HTML list of categories.
* *
* @since 2.1.0 * @since 2.1.0
* @since 4.4.0 Introduced the `hide_title_if_empty` and `separator` arguments. * @since 4.4.0 Introduced the `hide_title_if_empty` and `separator` arguments.
@ -1058,7 +1058,7 @@ function _wp_object_count_sort_cb( $a, $b ) {
// //
/** /**
* Retrieve HTML list content for category list. * Retrieves HTML list content for category list.
* *
* @since 2.1.0 * @since 2.1.0
* @since 5.3.0 Formalized the existing `...$args` parameter by adding it * @since 5.3.0 Formalized the existing `...$args` parameter by adding it
@ -1081,7 +1081,7 @@ function walk_category_tree( ...$args ) {
} }
/** /**
* Retrieve HTML dropdown (select) content for category list. * Retrieves HTML dropdown (select) content for category list.
* *
* @since 2.1.0 * @since 2.1.0
* @since 5.3.0 Formalized the existing `...$args` parameter by adding it * @since 5.3.0 Formalized the existing `...$args` parameter by adding it
@ -1108,7 +1108,7 @@ function walk_category_dropdown_tree( ...$args ) {
// //
/** /**
* Retrieve the link to the tag. * Retrieves the link to the tag.
* *
* @since 2.3.0 * @since 2.3.0
* @see get_term_link() * @see get_term_link()
@ -1121,7 +1121,7 @@ function get_tag_link( $tag ) {
} }
/** /**
* Retrieve the tags for a post. * Retrieves the tags for a post.
* *
* @since 2.3.0 * @since 2.3.0
* *
@ -1143,7 +1143,7 @@ function get_the_tags( $id = 0 ) {
} }
/** /**
* Retrieve the tags for a post formatted as a string. * Retrieves the tags for a post formatted as a string.
* *
* @since 2.3.0 * @since 2.3.0
* *
@ -1170,7 +1170,7 @@ function get_the_tag_list( $before = '', $sep = '', $after = '', $id = 0 ) {
} }
/** /**
* Retrieve the tags for a post. * Retrieves the tags for a post.
* *
* @since 2.3.0 * @since 2.3.0
* *
@ -1191,7 +1191,7 @@ function the_tags( $before = null, $sep = ', ', $after = '' ) {
} }
/** /**
* Retrieve tag description. * Retrieves tag description.
* *
* @since 2.8.0 * @since 2.8.0
* *
@ -1203,7 +1203,7 @@ function tag_description( $tag = 0 ) {
} }
/** /**
* Retrieve term description. * Retrieves term description.
* *
* @since 2.8.0 * @since 2.8.0
* @since 4.9.2 The `$taxonomy` parameter was deprecated. * @since 4.9.2 The `$taxonomy` parameter was deprecated.
@ -1224,7 +1224,7 @@ function term_description( $term = 0, $deprecated = null ) {
} }
/** /**
* Retrieve the terms of the taxonomy that are attached to the post. * Retrieves the terms of the taxonomy that are attached to the post.
* *
* @since 2.5.0 * @since 2.5.0
* *
@ -1267,7 +1267,7 @@ function get_the_terms( $post, $taxonomy ) {
} }
/** /**
* Retrieve a post's terms as a list with specified format. * Retrieves a post's terms as a list with specified format.
* *
* @since 2.5.0 * @since 2.5.0
* *
@ -1315,7 +1315,7 @@ function get_the_term_list( $id, $taxonomy, $before = '', $sep = '', $after = ''
} }
/** /**
* Retrieve term parents with separator. * Retrieves term parents with separator.
* *
* @since 4.8.0 * @since 4.8.0
* *
@ -1380,7 +1380,7 @@ function get_term_parents_list( $term_id, $taxonomy, $args = array() ) {
} }
/** /**
* Display the terms in a list. * Displays the terms in a list.
* *
* @since 2.5.0 * @since 2.5.0
* *
@ -1413,7 +1413,7 @@ function the_terms( $id, $taxonomy, $before = '', $sep = ', ', $after = '' ) {
} }
/** /**
* Check if the current post has any of given category. * Checks if the current post has any of given category.
* *
* @since 3.1.0 * @since 3.1.0
* *
@ -1451,7 +1451,7 @@ function has_tag( $tag = '', $post = null ) {
} }
/** /**
* Check if the current post has any of given terms. * Checks if the current post has any of given terms.
* *
* The given terms are checked against the post's terms' term_ids, names and slugs. * The given terms are checked against the post's terms' term_ids, names and slugs.
* Terms given as integers will only be checked against the post's terms' term_ids. * Terms given as integers will only be checked against the post's terms' term_ids.

2
wp-includes/version.php
View File

@ -13,7 +13,7 @@
* *
* @global string $wp_version * @global string $wp_version
*/ */
$wp_version = '5.5-alpha-47544'; $wp_version = '5.5-alpha-47545';
/** /**
* 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.