Docs: Update and correct various inline documentation.

See #42505, #41756

Built from https://develop.svn.wordpress.org/trunk@43177


git-svn-id: http://core.svn.wordpress.org/trunk@43006 1a063a9b-81f0-0310-95a4-ce76da25c4cd
This commit is contained in:
John Blackbourn 2018-05-07 17:20:22 +00:00
parent 8bc4e6d94f
commit 8b34c79cec
6 changed files with 42 additions and 42 deletions

View File

@ -8,7 +8,7 @@
*/ */
/** /**
* Fetch an instance of a WP_List_Table class. * Fetches an instance of a WP_List_Table class.
* *
* @access private * @access private
* @since 3.1.0 * @since 3.1.0
@ -17,7 +17,7 @@
* *
* @param string $class The type of the list table, which is the class name. * @param string $class The type of the list table, which is the class name.
* @param array $args Optional. Arguments to pass to the class. Accepts 'screen'. * @param array $args Optional. Arguments to pass to the class. Accepts 'screen'.
* @return object|bool Object on success, false if the class does not exist. * @return WP_List_Table|bool List table object on success, false if the class does not exist.
*/ */
function _get_list_table( $class, $args = array() ) { function _get_list_table( $class, $args = array() ) {
$core_classes = array( $core_classes = array(

View File

@ -673,16 +673,16 @@ function format_code_lang( $code = '' ) {
} }
/** /**
* Synchronize category and post tag slugs when global terms are enabled. * Synchronizes category and post tag slugs when global terms are enabled.
* *
* @since 3.0.0 * @since 3.0.0
* *
* @param object $term The term. * @param WP_Term|array $term The term.
* @param string $taxonomy The taxonomy for `$term`. Should be 'category' or 'post_tag', as these are * @param string $taxonomy The taxonomy for `$term`. Should be 'category' or 'post_tag', as these are
* the only taxonomies which are processed by this function; anything else * the only taxonomies which are processed by this function; anything else
* will be returned untouched. * will be returned untouched.
* @return object|array Returns `$term`, after filtering the 'slug' field with sanitize_title() * @return WP_Term|array Returns `$term`, after filtering the 'slug' field with `sanitize_title()`
* if $taxonomy is 'category' or 'post_tag'. * if `$taxonomy` is 'category' or 'post_tag'.
*/ */
function sync_category_tag_slugs( $term, $taxonomy ) { function sync_category_tag_slugs( $term, $taxonomy ) {
if ( global_terms_enabled() && ( $taxonomy == 'category' || $taxonomy == 'post_tag' ) ) { if ( global_terms_enabled() && ( $taxonomy == 'category' || $taxonomy == 'post_tag' ) ) {

View File

@ -352,7 +352,7 @@ final class WP_Post {
* @since 3.5.0 * @since 3.5.0
* *
* @param string $filter Filter. * @param string $filter Filter.
* @return self|array|bool|object|WP_Post * @return array|bool|object|WP_Post
*/ */
public function filter( $filter ) { public function filter( $filter ) {
if ( $this->filter == $filter ) { if ( $this->filter == $filter ) {

View File

@ -429,7 +429,7 @@ function has_excerpt( $post = 0 ) {
} }
/** /**
* Display the classes for the post div. * Displays the classes for the post container element.
* *
* @since 2.7.0 * @since 2.7.0
* *
@ -442,7 +442,7 @@ function post_class( $class = '', $post_id = null ) {
} }
/** /**
* Retrieves the classes for the post div as an array. * Retrieves an array of the class names for the post container element.
* *
* The class names are many. If the post is a sticky, then the 'sticky' * The class names are many. If the post is a sticky, then the 'sticky'
* class name. The class 'hentry' is always added to each post. If the post has a * class name. The class 'hentry' is always added to each post. If the post has a
@ -451,16 +451,16 @@ function post_class( $class = '', $post_id = null ) {
* eg 'category-foo' or 'my_custom_taxonomy-bar'. * eg 'category-foo' or 'my_custom_taxonomy-bar'.
* *
* The 'post_tag' taxonomy is a special * The 'post_tag' taxonomy is a special
* case; the class has the 'tag-' prefix instead of 'post_tag-'. All classes are * case; the class has the 'tag-' prefix instead of 'post_tag-'. All class names are
* passed through the filter, {@see 'post_class'}, with the list of classes, followed by * passed through the filter, {@see 'post_class'}, with the list of class names, followed by
* $class parameter value, with the post ID as the last parameter. * $class parameter value, with the post ID as the last parameter.
* *
* @since 2.7.0 * @since 2.7.0
* @since 4.2.0 Custom taxonomy classes were added. * @since 4.2.0 Custom taxonomy class names were added.
* *
* @param string|array $class One or more classes to add to the class list. * @param string|string[] $class Space-separated string or array of class names to add to the class list.
* @param int|WP_Post $post_id Optional. Post ID or post object. * @param int|WP_Post $post_id Optional. Post ID or post object.
* @return array Array of classes. * @return string[] Array of class names.
*/ */
function get_post_class( $class = '', $post_id = null ) { function get_post_class( $class = '', $post_id = null ) {
$post = get_post( $post_id ); $post = get_post( $post_id );
@ -552,12 +552,12 @@ function get_post_class( $class = '', $post_id = null ) {
$classes = array_map( 'esc_attr', $classes ); $classes = array_map( 'esc_attr', $classes );
/** /**
* Filters the list of CSS classes for the current post. * Filters the list of CSS class names for the current post.
* *
* @since 2.7.0 * @since 2.7.0
* *
* @param array $classes An array of post classes. * @param string[] $classes An array of post class names.
* @param array $class An array of additional classes added to the post. * @param string[] $class An array of additional class names added to the post.
* @param int $post_id The post ID. * @param int $post_id The post ID.
*/ */
$classes = apply_filters( 'post_class', $classes, $class, $post->ID ); $classes = apply_filters( 'post_class', $classes, $class, $post->ID );
@ -566,26 +566,26 @@ function get_post_class( $class = '', $post_id = null ) {
} }
/** /**
* Display the classes for the body element. * Displays the class names for the body element.
* *
* @since 2.8.0 * @since 2.8.0
* *
* @param string|array $class One or more classes to add to the class list. * @param string|string[] $class Space-separated string or array of class names to add to the class list.
*/ */
function body_class( $class = '' ) { function body_class( $class = '' ) {
// Separates classes with a single space, collates classes for body element // Separates class names with a single space, collates class names for body element
echo 'class="' . join( ' ', get_body_class( $class ) ) . '"'; echo 'class="' . join( ' ', get_body_class( $class ) ) . '"';
} }
/** /**
* Retrieve the classes for the body element as an array. * Retrieves an array of the class names for the body element.
* *
* @since 2.8.0 * @since 2.8.0
* *
* @global WP_Query $wp_query * @global WP_Query $wp_query
* *
* @param string|array $class One or more classes to add to the class list. * @param string|string[] $class Space-separated string or array of class names to add to the class list.
* @return array Array of classes. * @return string[] Array of class names.
*/ */
function get_body_class( $class = '' ) { function get_body_class( $class = '' ) {
global $wp_query; global $wp_query;
@ -800,12 +800,12 @@ function get_body_class( $class = '' ) {
$classes = array_map( 'esc_attr', $classes ); $classes = array_map( 'esc_attr', $classes );
/** /**
* Filters the list of CSS body classes for the current post or page. * Filters the list of CSS body class names for the current post or page.
* *
* @since 2.8.0 * @since 2.8.0
* *
* @param array $classes An array of body classes. * @param string[] $classes An array of body class names.
* @param array $class An array of additional classes added to the body. * @param string[] $class An array of additional class names added to the body.
*/ */
$classes = apply_filters( 'body_class', $classes, $class ); $classes = apply_filters( 'body_class', $classes, $class );

View File

@ -810,26 +810,26 @@ function get_term( $term, $taxonomy = '', $output = OBJECT, $filter = 'raw' ) {
} }
/** /**
* Filters a term. * Filters a taxonomy term object.
* *
* @since 2.3.0 * @since 2.3.0
* @since 4.4.0 `$_term` can now also be a WP_Term object. * @since 4.4.0 `$_term` is now a `WP_Term` object.
* *
* @param int|WP_Term $_term Term object or ID. * @param WP_Term $_term Term object.
* @param string $taxonomy The taxonomy slug. * @param string $taxonomy The taxonomy slug.
*/ */
$_term = apply_filters( 'get_term', $_term, $taxonomy ); $_term = apply_filters( 'get_term', $_term, $taxonomy );
/** /**
* Filters a taxonomy. * Filters a taxonomy term object.
* *
* The dynamic portion of the filter name, `$taxonomy`, refers * The dynamic portion of the filter name, `$taxonomy`, refers
* to the taxonomy slug. * to the slug of the term's taxonomy.
* *
* @since 2.3.0 * @since 2.3.0
* @since 4.4.0 `$_term` can now also be a WP_Term object. * @since 4.4.0 `$_term` is now a `WP_Term` object.
* *
* @param int|WP_Term $_term Term object or ID. * @param WP_Term $_term Term object.
* @param string $taxonomy The taxonomy slug. * @param string $taxonomy The taxonomy slug.
*/ */
$_term = apply_filters( "get_{$taxonomy}", $_term, $taxonomy ); $_term = apply_filters( "get_{$taxonomy}", $_term, $taxonomy );

View File

@ -4,7 +4,7 @@
* *
* @global string $wp_version * @global string $wp_version
*/ */
$wp_version = '5.0-alpha-43175'; $wp_version = '5.0-alpha-43177';
/** /**
* 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.