Remove backticks on `$post` variables in some short parameter descriptions.

See [28653], [28654].
See #28388.

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


git-svn-id: http://core.svn.wordpress.org/trunk@28765 1a063a9b-81f0-0310-95a4-ce76da25c4cd
This commit is contained in:
Drew Jaynes 2014-07-03 19:28:14 +00:00
parent 0ac4474ce4
commit d4dd02b4ae
9 changed files with 28 additions and 28 deletions

View File

@ -519,8 +519,8 @@ class WP_List_Table {
* @since 3.1.0 * @since 3.1.0
* @access protected * @access protected
* *
* @param int $post_id * @param int $post_id The post ID.
* @param int $pending_comments * @param int $pending_comments Number of pending comments.
*/ */
protected function comments_bubble( $post_id, $pending_comments ) { protected function comments_bubble( $post_id, $pending_comments ) {
$pending_phrase = sprintf( __( '%s pending' ), number_format( $pending_comments ) ); $pending_phrase = sprintf( __( '%s pending' ), number_format( $pending_comments ) );

View File

@ -1472,7 +1472,7 @@ function the_post_password() {
* *
* @since 2.7.0 * @since 2.7.0
* *
* @param int|WP_Post $post Optional. Post ID or WP_Post object. Default is global `$post`. * @param int|WP_Post $post Optional. Post ID or WP_Post object. Default is global $post.
* @return string The post title if set. * @return string The post title if set.
*/ */
function _draft_or_post_title( $post = 0 ) { function _draft_or_post_title( $post = 0 ) {

View File

@ -641,7 +641,7 @@ function get_comment_link( $comment = null, $args = array() ) {
* *
* @since 1.5.0 * @since 1.5.0
* *
* @param int|WP_Post $post_id Optional. Post ID or WP_Post object. Default is global `$post`. * @param int|WP_Post $post_id Optional. Post ID or WP_Post object. Default is global $post.
* @return string The link to the comments. * @return string The link to the comments.
*/ */
function get_comments_link( $post_id = 0 ) { function get_comments_link( $post_id = 0 ) {
@ -678,7 +678,7 @@ function comments_link( $deprecated = '', $deprecated_2 = '' ) {
* *
* @since 1.5.0 * @since 1.5.0
* *
* @param int|WP_Post $post_id Optional. Post ID or WP_Post object. Default is global `$post`. * @param int|WP_Post $post_id Optional. Post ID or WP_Post object. Default is global $post.
* @return int The number of comments a post has. * @return int The number of comments a post has.
*/ */
function get_comments_number( $post_id = 0 ) { function get_comments_number( $post_id = 0 ) {

View File

@ -290,7 +290,7 @@ function get_post_permalink( $id = 0, $leavename = false, $sample = false ) {
* *
* @since 1.0.0 * @since 1.0.0
* *
* @param int|WP_Post $post_id Optional. Post ID or WP_Post object. Default is global `$post`. * @param int|WP_Post $post_id Optional. Post ID or WP_Post object. Default is global $post.
* @param mixed $deprecated Not used. * @param mixed $deprecated Not used.
* @return string * @return string
*/ */

View File

@ -3022,7 +3022,7 @@ function wp_enqueue_media( $args = array() ) {
* @since 3.6.0 * @since 3.6.0
* *
* @param string $type Mime type. * @param string $type Mime type.
* @param int|WP_Post $post Optional. Post ID or WP_Post object. Default is global `$post`. * @param int|WP_Post $post Optional. Post ID or WP_Post object. Default is global $post.
* @return array Found attachments. * @return array Found attachments.
*/ */
function get_attached_media( $type, $post = 0 ) { function get_attached_media( $type, $post = 0 ) {
@ -3147,7 +3147,7 @@ function get_post_galleries( $post, $html = true ) {
* *
* @since 3.6.0 * @since 3.6.0
* *
* @param int|WP_Post $post Optional. Post ID or WP_Post object. Default is global `$post`. * @param int|WP_Post $post Optional. Post ID or WP_Post object. Default is global $post.
* @param bool $html Whether to return HTML or data. * @param bool $html Whether to return HTML or data.
* @return string|array Gallery data and srcs parsed from the expanded shortcode. * @return string|array Gallery data and srcs parsed from the expanded shortcode.
*/ */
@ -3172,7 +3172,7 @@ function get_post_gallery( $post = 0, $html = true ) {
* *
* @since 3.6.0 * @since 3.6.0
* *
* @param int|WP_Post $post Optional. Post ID or WP_Post object. Default is global `$post`. * @param int|WP_Post $post Optional. Post ID or WP_Post object. Default is global $post.
* @return array A list of lists, each containing image srcs parsed. * @return array A list of lists, each containing image srcs parsed.
* from an expanded shortcode * from an expanded shortcode
*/ */
@ -3186,7 +3186,7 @@ function get_post_galleries_images( $post = 0 ) {
* *
* @since 3.6.0 * @since 3.6.0
* *
* @param int|WP_Post $post Optional. Post ID or WP_Post object. Default is global `$post`. * @param int|WP_Post $post Optional. Post ID or WP_Post object. Default is global $post.
* @return array A list of a gallery's image srcs in order. * @return array A list of a gallery's image srcs in order.
*/ */
function get_post_gallery_images( $post = 0 ) { function get_post_gallery_images( $post = 0 ) {

View File

@ -105,7 +105,7 @@ function the_title_attribute( $args = '' ) {
* *
* @since 0.71 * @since 0.71
* *
* @param int|WP_Post $post Optional. Post ID or WP_Post object. Default is global `$post`. * @param int|WP_Post $post Optional. Post ID or WP_Post object. Default is global $post.
* @return string * @return string
*/ */
function get_the_title( $post = 0 ) { function get_the_title( $post = 0 ) {
@ -1565,7 +1565,7 @@ function prepend_attachment($content) {
* *
* @since 1.0.0 * @since 1.0.0
* *
* @param int|WP_Post $post Optional. Post ID or WP_Post object. Default is global `$post`. * @param int|WP_Post $post Optional. Post ID or WP_Post object. Default is global $post.
* @return string HTML content for password form for password protected post. * @return string HTML content for password form for password protected post.
*/ */
function get_the_password_form( $post = 0 ) { function get_the_password_form( $post = 0 ) {
@ -1738,7 +1738,7 @@ function wp_post_revision_title_expanded( $revision, $link = true ) {
* @uses get_edit_post_link() * @uses get_edit_post_link()
* @uses get_the_author_meta() * @uses get_the_author_meta()
* *
* @param int|WP_Post $post_id Optional. Post ID or WP_Post object. Default is global `$post`. * @param int|WP_Post $post_id Optional. Post ID or WP_Post object. Default is global $post.
* @param string $type 'all' (default), 'revision' or 'autosave' * @param string $type 'all' (default), 'revision' or 'autosave'
* @return null * @return null
*/ */

View File

@ -1868,7 +1868,7 @@ function delete_post_meta_by_key($post_meta_key) {
* @since 1.2.0 * @since 1.2.0
* @link http://codex.wordpress.org/Function_Reference/get_post_custom * @link http://codex.wordpress.org/Function_Reference/get_post_custom
* *
* @param int $post_id Optional. Post ID. Default is ID of the global `$post`. * @param int $post_id Optional. Post ID. Default is ID of the global $post.
* @return array Post meta for the given post. * @return array Post meta for the given post.
*/ */
function get_post_custom( $post_id = 0 ) { function get_post_custom( $post_id = 0 ) {
@ -1887,7 +1887,7 @@ function get_post_custom( $post_id = 0 ) {
* @since 1.2.0 * @since 1.2.0
* @link http://codex.wordpress.org/Function_Reference/get_post_custom_keys * @link http://codex.wordpress.org/Function_Reference/get_post_custom_keys
* *
* @param int $post_id Optional. Post ID. Default is ID of the global `$post`. * @param int $post_id Optional. Post ID. Default is ID of the global $post.
* @return array|null Either array of the keys, or null if keys could not be retrieved. * @return array|null Either array of the keys, or null if keys could not be retrieved.
*/ */
function get_post_custom_keys( $post_id = 0 ) { function get_post_custom_keys( $post_id = 0 ) {
@ -1910,7 +1910,7 @@ function get_post_custom_keys( $post_id = 0 ) {
* @link http://codex.wordpress.org/Function_Reference/get_post_custom_values * @link http://codex.wordpress.org/Function_Reference/get_post_custom_values
* *
* @param string $key Meta field key. * @param string $key Meta field key.
* @param int $post_id Optional. Post ID. Default is ID of the global `$post`. * @param int $post_id Optional. Post ID. Default is ID of the global $post.
* @return array Meta field values. * @return array Meta field values.
*/ */
function get_post_custom_values( $key = '', $post_id = 0 ) { function get_post_custom_values( $key = '', $post_id = 0 ) {
@ -1930,7 +1930,7 @@ function get_post_custom_values( $key = '', $post_id = 0 ) {
* *
* @since 2.7.0 * @since 2.7.0
* *
* @param int $post_id Optional. Post ID. Default is ID of the global `$post`. * @param int $post_id Optional. Post ID. Default is ID of the global $post.
* @return bool Whether post is sticky. * @return bool Whether post is sticky.
*/ */
function is_sticky( $post_id = 0 ) { function is_sticky( $post_id = 0 ) {
@ -2624,7 +2624,7 @@ function wp_trash_post($post_id = 0) {
* *
* @since 2.9.0 * @since 2.9.0
* *
* @param int $post_id Optional. Post ID. Default is ID of the global `$post`. * @param int $post_id Optional. Post ID. Default is ID of the global $post.
* @return mixed False on failure * @return mixed False on failure
*/ */
function wp_untrash_post( $post_id = 0 ) { function wp_untrash_post( $post_id = 0 ) {
@ -2788,7 +2788,7 @@ function wp_untrash_post_comments($post = null) {
* *
* @uses wp_get_object_terms() Retrieves the categories. Args details can be found here. * @uses wp_get_object_terms() Retrieves the categories. Args details can be found here.
* *
* @param int $post_id Optional. The Post ID. Does not default to the ID of the global `$post`. * @param int $post_id Optional. The Post ID. Does not default to the ID of the global $post.
* @param array $args Optional. Overwrite the defaults. * @param array $args Optional. Overwrite the defaults.
* @return array * @return array
*/ */
@ -2813,7 +2813,7 @@ function wp_get_post_categories( $post_id = 0, $args = array() ) {
* *
* @uses wp_get_object_terms() Gets the tags for returning. Args can be found here * @uses wp_get_object_terms() Gets the tags for returning. Args can be found here
* *
* @param int $post_id Optional. The Post ID. Does not default to the ID of the global `$post`. * @param int $post_id Optional. The Post ID. Does not default to the ID of the global $post.
* @param array $args Optional. Overwrite the defaults * @param array $args Optional. Overwrite the defaults
* @return array List of post tags. * @return array List of post tags.
*/ */
@ -2832,7 +2832,7 @@ function wp_get_post_tags( $post_id = 0, $args = array() ) {
* *
* @uses wp_get_object_terms() Gets the tags for returning. Args can be found here * @uses wp_get_object_terms() Gets the tags for returning. Args can be found here
* *
* @param int $post_id Optional. The Post ID. Does not default to the ID of the global `$post`. * @param int $post_id Optional. The Post ID. Does not default to the ID of the global $post.
* @param string $taxonomy The taxonomy for which to retrieve terms. Defaults to post_tag. * @param string $taxonomy The taxonomy for which to retrieve terms. Defaults to post_tag.
* @param array $args Optional. {@link wp_get_object_terms()} arguments. * @param array $args Optional. {@link wp_get_object_terms()} arguments.
* @return array List of post tags. * @return array List of post tags.
@ -3646,7 +3646,7 @@ function _truncate_post_slug( $slug, $length = 200 ) {
* *
* @since 2.3.0 * @since 2.3.0
* *
* @param int $post_id Optional. The Post ID. Does not default to the ID of the global `$post`. * @param int $post_id Optional. The Post ID. Does not default to the ID of the global $post.
* @param string $tags The tags to set for the post, separated by commas. * @param string $tags The tags to set for the post, separated by commas.
* @return bool|null Will return false if $post_id is not an integer or is 0. Will return null otherwise * @return bool|null Will return false if $post_id is not an integer or is 0. Will return null otherwise
*/ */
@ -3660,7 +3660,7 @@ function wp_add_post_tags( $post_id = 0, $tags = '' ) {
* @since 2.3.0 * @since 2.3.0
* @uses wp_set_object_terms() Sets the tags for the post. * @uses wp_set_object_terms() Sets the tags for the post.
* *
* @param int $post_id Optional. The Post ID. Does not default to the ID of the global `$post`. * @param int $post_id Optional. The Post ID. Does not default to the ID of the global $post.
* @param string $tags The tags to set for the post, separated by commas. * @param string $tags The tags to set for the post, separated by commas.
* @param bool $append If true, don't delete existing tags, just add on. If false, replace the tags with the new tags. * @param bool $append If true, don't delete existing tags, just add on. If false, replace the tags with the new tags.
* @return mixed Array of affected term IDs. WP_Error or false on failure. * @return mixed Array of affected term IDs. WP_Error or false on failure.
@ -3675,7 +3675,7 @@ function wp_set_post_tags( $post_id = 0, $tags = '', $append = false ) {
* @since 2.8.0 * @since 2.8.0
* @uses wp_set_object_terms() Sets the tags for the post. * @uses wp_set_object_terms() Sets the tags for the post.
* *
* @param int $post_id Optional. The Post ID. Does not default to the ID of the global `$post`. * @param int $post_id Optional. The Post ID. Does not default to the ID of the global $post.
* @param string $tags The tags to set for the post, separated by commas. * @param string $tags The tags to set for the post, separated by commas.
* @param string $taxonomy Taxonomy name. Defaults to 'post_tag'. * @param string $taxonomy Taxonomy name. Defaults to 'post_tag'.
* @param bool $append If true, don't delete existing tags, just add on. If false, replace the tags with the new tags. * @param bool $append If true, don't delete existing tags, just add on. If false, replace the tags with the new tags.
@ -3714,7 +3714,7 @@ function wp_set_post_terms( $post_id = 0, $tags = '', $taxonomy = 'post_tag', $a
* *
* @since 2.1.0 * @since 2.1.0
* *
* @param int $post_ID Optional. The Post ID. Does not default to the ID of the global `$post`. * @param int $post_ID Optional. The Post ID. Does not default to the ID of the global $post.
* @param array|int $post_categories Optional. List of categories or ID of category. * @param array|int $post_categories Optional. List of categories or ID of category.
* @param bool $append If true, don't delete existing categories, just add on. If false, replace the categories with the new categories. * @param bool $append If true, don't delete existing categories, just add on. If false, replace the categories with the new categories.
* @return bool|mixed * @return bool|mixed

View File

@ -409,7 +409,7 @@ function wp_delete_post_revision( $revision_id ) {
* *
* @uses get_children() * @uses get_children()
* *
* @param int|WP_Post $post_id Optional. Post ID or WP_Post object. Default is global `$post`. * @param int|WP_Post $post_id Optional. Post ID or WP_Post object. Default is global $post.
* @return array An array of revisions, or an empty array if none. * @return array An array of revisions, or an empty array if none.
*/ */
function wp_get_post_revisions( $post_id = 0, $args = null ) { function wp_get_post_revisions( $post_id = 0, $args = null ) {

View File

@ -3778,7 +3778,7 @@ function the_taxonomies( $args = array() ) {
* *
* @since 2.5.0 * @since 2.5.0
* *
* @param int|WP_Post $post Optional. Post ID or WP_Post object. Default is global `$post`. * @param int|WP_Post $post Optional. Post ID or WP_Post object. Default is global $post.
* @param array $args Override the defaults. * @param array $args Override the defaults.
* @return array List of taxonomies. * @return array List of taxonomies.
*/ */
@ -3831,7 +3831,7 @@ function get_the_taxonomies( $post = 0, $args = array() ) {
* *
* @uses get_object_taxonomies() * @uses get_object_taxonomies()
* *
* @param int|WP_Post $post Optional. Post ID or WP_Post object. Default is global `$post`. * @param int|WP_Post $post Optional. Post ID or WP_Post object. Default is global $post.
* @return array * @return array
*/ */
function get_post_taxonomies( $post = 0 ) { function get_post_taxonomies( $post = 0 ) {