WordPress.org
Get WordPress

Make WordPress Core

Changeset 46594


Ignore:
Timestamp:
10/26/2019 08:42:00 PM (7 years ago)
Author:
johnbillion
Message:

Docs: Miscellaneous docblock fixes and improvements.

See #48303

Location:
trunk/src
Files:
7 edited

Legend:

Unmodified
Added
Removed

  • trunk/src/wp-admin/includes/post.php

    r46091 r46594  
    13201320 * @param string $title Optional. Title to override the post's current title when generating the post name. Default null.
    13211321 * @param string $name  Optional. Name to override the post name. Default null.
    1322  * @return array Array containing the sample permalink with placeholder for the post name, and the post name.
     1322 * @return array {
     1323 *     Array containing the sample permalink with placeholder for the post name, and the post name.
     1324 *
     1325 *     @type string $0 The permalink with placeholder for the post name.
     1326 *     @type string $1 The post name.
     1327 * }
    13231328 */
    13241329function get_sample_permalink( $id, $title = null, $name = null ) {
    … …  
    13841389         * @since 4.4.0
    13851390         *
    1386          * @param array   $permalink Array containing the sample permalink with placeholder for the post name, and the post name.
     1391         * @param array   $permalink {
     1392         *     Array containing the sample permalink with placeholder for the post name, and the post name.
     1393         *
     1394         *     @type string $0 The permalink with placeholder for the post name.
     1395         *     @type string $1 The post name.
     1396         * }
    13871397         * @param int     $post_id   Post ID.
    13881398         * @param string  $title     Post title.
    … …  
    16381648
    16391649        if ( $user ) {
    1640 
    16411650                /**
    16421651                 * Filters whether to show the post locked dialog.
    16431652                 *
    1644                  * Returning a falsey value to the filter will short-circuit displaying the dialog.
     1653                 * Returning false from the filter will prevent the dialog from being displayed.
    16451654                 *
    16461655                 * @since 3.6.0
    16471656                 *
    1648                  * @param bool         $display Whether to display the dialog. Default true.
    1649                  * @param WP_Post      $post    Post object.
    1650                  * @param WP_User|bool $user    WP_User object on success, false otherwise.
     1657                 * @param bool    $display Whether to display the dialog. Default true.
     1658                 * @param WP_Post $post    Post object.
     1659                 * @param WP_User $user    The user with the lock for the post.
    16511660                 */
    16521661                if ( ! apply_filters( 'show_post_locked_dialog', true, $post, $user ) ) {
    … …  
    16971706                 * Filters whether to allow the post lock to be overridden.
    16981707                 *
    1699                  * Returning a falsey value to the filter will disable the ability
     1708                 * Returning false from the filter will disable the ability
    17001709                 * to override the post lock.
    17011710                 *
    17021711                 * @since 3.6.0
    17031712                 *
    1704                  * @param bool    $override Whether to allow overriding post locks. Default true.
     1713                 * @param bool    $override Whether to allow the post lock to be overridden. Default true.
    17051714                 * @param WP_Post $post     Post object.
    1706                  * @param WP_User $user     User object.
     1715                 * @param WP_User $user     The user with the lock for the post.
    17071716                 */
    17081717                $override = apply_filters( 'override_post_lock', true, $post, $user );

  • trunk/src/wp-admin/user-new.php

    r45932 r46594  
    106106                         *
    107107                         * @param int    $user_id     The invited user's ID.
    108                          * @param array  $role        The role of invited user.
     108                         * @param array  $role        Array containing role information for the invited user.
    109109                         * @param string $newuser_key The key of the invitation.
    110110                         */

  • trunk/src/wp-includes/class-wp-block-styles-registry.php

    r46586 r46594  
    6868         *
    6969         * @param string $block_name       Block type name including namespace.
    70          * @param array $block_style_name Block style name.
     70         * @param string $block_style_name Block style name.
    7171         *
    7272         * @return boolean True if the block style was unregistered with success and false otherwise.
    … …  
    9191         *
    9292         * @param string $block_name       Block type name including namespace.
    93          * @param array $block_style_name Block style name.
     93         * @param string $block_style_name Block style name.
    9494         *
    9595         * @return array Registered block style properties.
    … …  
    136136         *
    137137         * @param string $block_name       Block type name including namespace.
    138          * @param array $block_style_name Block style name.
     138         * @param string $block_style_name Block style name.
    139139         *
    140140         * @return bool True if the block style is registered, false otherwise.

  • trunk/src/wp-includes/class-wp-image-editor-gd.php

    r45892 r46594  
    246246         * @since 5.3.0
    247247         *
    248          * @param array $size_data Array of width, height, and whether to crop.
     248         * @param array $size_data {
     249         *     Array of size data.
     250         *
     251         *     @type int  $width  The maximum width in pixels.
     252         *     @type int  $height The maximum height in pixels.
     253         *     @type bool $crop   Whether to crop the image to exact dimensions.
     254         * }
    249255         * @return WP_Error|array WP_Error on error, or the image data array for inclusion in the `sizes` array in the image meta.
    250256         */

  • trunk/src/wp-includes/class-wp-image-editor-imagick.php

    r46238 r46594  
    454454         * @since 5.3.0
    455455         *
    456          * @param array $size_data Array of width, height, and whether to crop.
     456         * @param array $size_data {
     457         *     Array of size data.
     458         *
     459         *     @type int  $width  The maximum width in pixels.
     460         *     @type int  $height The maximum height in pixels.
     461         *     @type bool $crop   Whether to crop the image to exact dimensions.
     462         * }
    457463         * @return WP_Error|array WP_Error on error, or the image data array for inclusion in the `sizes` array in the image meta.
    458464         */

  • trunk/src/wp-includes/functions.php

    r46577 r46594  
    28582858 *
    28592859 * @since 3.5.0
    2860  * @since 4.2.0 Support was added for GIMP (xcf) files.
     2860 * @since 4.2.0 Support was added for GIMP (.xcf) files.
     2861 * @since 4.9.2 Support was added for Flac (.flac) files.
     2862 * @since 4.9.6 Support was added for AAC (.aac) files.
    28612863 *
    28622864 * @return array Array of mime types keyed by the file extension regex corresponding to those types.
    … …  
    30433045         * @since 2.0.0
    30443046         *
    3045          * @param array            $t    Mime types keyed by the file extension regex corresponding to
    3046          *                               those types. 'swf' and 'exe' removed from full list. 'htm|html' also
    3047          *                               removed depending on '$user' capabilities.
     3047         * @param array            $t    Mime types keyed by the file extension regex corresponding to those types.
    30483048         * @param int|WP_User|null $user User ID, User object or null if not provided (indicates current user).
    30493049         */

  • trunk/src/wp-includes/media.php

    r46418 r46594  
    3939 *
    4040 * Finally, there is a filter named {@see 'editor_max_image_size'}, that will be
    41  * called on the calculated array for width and height, respectively. The second
    42  * parameter will be the value that was in the $size parameter. The returned
    43  * type for the hook is an array with the width as the first element and the
    44  * height as the second element.
     41 * called on the calculated array for width and height, respectively.
    4542 *
    4643 * @since 2.5.0
    … …  
    5552 * @param string       $context Optional. Could be 'display' (like in a theme) or 'edit'
    5653 *                              (like inserting into an editor). Default null.
    57  * @return array Width and height of what the result image should resize to.
     54 * @return int[] {
     55 *     An array of width and height values.
     56 *
     57 *     @type int $0 The maximum width in pixels.
     58 *     @type int $1 The maximum height in pixels.
     59 * }
    5860 */
    5961function image_constrain_size_for_editor( $width, $height, $size = 'medium', $context = null ) {
    … …  
    118120         * @since 2.5.0
    119121         *
    120          * @param array        $max_image_size An array with the width as the first element,
    121          *                                     and the height as the second element.
     122         * @param int[]        $max_image_size {
     123         *     An array of width and height values.
     124         *
     125         *     @type int $0 The maximum width in pixels.
     126         *     @type int $1 The maximum height in pixels.
     127         * }
    122128         * @param string|array $size           Size of what the result image should be.
    123129         * @param string       $context        The context the image is being resized for.
    … …  
    418424 * @param int $max_width      Optional. Max width in pixels to constrain to. Default 0.
    419425 * @param int $max_height     Optional. Max height in pixels to constrain to. Default 0.
    420  * @return array First item is the width, the second item is the height.
     426 * @return int[] {
     427 *     An array of width and height values.
     428 *
     429 *     @type int $0 The width in pixels.
     430 *     @type int $1 The height in pixels.
     431 * }
    421432 */
    422433function wp_constrain_dimensions( $current_width, $current_height, $max_width = 0, $max_height = 0 ) {
    … …  
    475486         * @since 4.1.0
    476487         *
    477          * @param array $dimensions     The image width and height.
     488         * @param int[] $dimensions     {
     489         *     An array of width and height values.
     490         *
     491         *     @type int $0 The width in pixels.
     492         *     @type int $1 The height in pixels.
     493         * }
    478494         * @param int   $current_width  The current width of the image.
    479495         * @param int   $current_height The current height of the image.
    … …  
    11501166 * @since 4.4.0
    11511167 *
    1152  * @param array  $size_array    Array of width and height values in pixels (in that order).
     1168 * @param int[]  $size_array    {
     1169 *     An array of width and height values.
     1170 *
     1171 *     @type int $0 The width in pixels.
     1172 *     @type int $1 The height in pixels.
     1173 * }
    11531174 * @param string $image_src     The 'src' of the image.
    11541175 * @param array  $image_meta    The image meta data as returned by 'wp_get_attachment_metadata()'.
    1155  * @param int    $attachment_id Optional. The image attachment ID to pass to the filter. Default 0.
     1176 * @param int    $attachment_id Optional. The image attachment ID. Default 0.
    11561177 * @return string|bool          The 'srcset' attribute value. False on error or when only one source exists.
    11571178 */
    … …  
    11631184         *
    11641185         * @param array  $image_meta    The image meta data as returned by 'wp_get_attachment_metadata()'.
    1165          * @param array  $size_array    Array of width and height values in pixels (in that order).
     1186         * @param int[]  $size_array    {
     1187         *     An array of requested width and height values.
     1188         *
     1189         *     @type int $0 The width in pixels.
     1190         *     @type int $1 The height in pixels.
     1191         * }
    11661192         * @param string $image_src     The 'src' of the image.
    11671193         * @param int    $attachment_id The image attachment ID or 0 if not supplied.
    … …  
    12321258         *
    12331259         * @param int   $max_width  The maximum image width to be included in the 'srcset'. Default '2048'.
    1234          * @param array $size_array Array of width and height values in pixels (in that order).
     1260         * @param int[] $size_array {
     1261         *     An array of requested width and height values.
     1262         *
     1263         *     @type int $0 The width in pixels.
     1264         *     @type int $1 The height in pixels.
     1265         * }
    12351266         */
    12361267        $max_srcset_image_width = apply_filters( 'max_srcset_image_width', 2048, $size_array );
    … …  
    13111342         *     }
    13121343         * }
    1313          * @param array  $size_array    Array of width and height values in pixels (in that order).
     1344         * @param array $size_array     {
     1345         *     An array of requested width and height values.
     1346         *
     1347         *     @type int $0 The width in pixels.
     1348         *     @type int $1 The height in pixels.
     1349         * }
    13141350         * @param string $image_src     The 'src' of the image.
    13151351         * @param array  $image_meta    The image meta data as returned by 'wp_get_attachment_metadata()'.
    … …  
    23772413
    23782414/**
    2379  * Returns a filtered list of WP-supported audio formats.
     2415 * Returns a filtered list of supported audio formats.
    23802416 *
    23812417 * @since 3.6.0
    … …  
    26252661
    26262662/**
    2627  * Returns a filtered list of WP-supported video formats.
     2663 * Returns a filtered list of supported video formats.
    26282664 *
    26292665 * @since 3.6.0
    … …  
    40124048         * @since 3.6.0
    40134049         *
    4014          * @param array  $args Post query arguments.
    4015          * @param string $type Mime type of the desired media.
    4016          * @param mixed  $post Post ID or object.
     4050         * @param array   $args Post query arguments.
     4051         * @param string  $type Mime type of the desired media.
     4052         * @param WP_Post $post Post object.
    40174053         */
    40184054        $args = apply_filters( 'get_attached_media_args', $args, $type, $post );
    … …  
    40254061         * @since 3.6.0
    40264062         *
    4027          * @param array  $children Associative array of media attached to the given post.
    4028          * @param string $type     Mime type of the media desired.
    4029          * @param mixed  $post     Post ID or object.
     4063         * @param array   $children Associative array of media attached to the given post.
     4064         * @param string  $type     Mime type of the media desired.
     4065         * @param WP_Post $post     Post object.
    40304066         */
    40314067        return (array) apply_filters( 'get_attached_media', $children, $type, $post );
    … …  
    40334069
    40344070/**
    4035  * Check the content blob for an audio, video, object, embed, or iframe tags.
     4071 * Check the content HTML for a audio, video, object, embed, or iframe tags.
    40364072 *
    40374073 * @since 3.6.0
    … …  
    42894325
    42904326/**
    4291  * Registers the personal data exporter for media
     4327 * Registers the personal data exporter for media.
    42924328 *
    42934329 * @param array   $exporters   An array of personal data exporters.
Note: See TracChangeset for help on using the changeset viewer.