Docs: Increase the specificity of types in various inline documentation.

See #54729

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


git-svn-id: http://core.svn.wordpress.org/trunk@52241 1a063a9b-81f0-0310-95a4-ce76da25c4cd
This commit is contained in:
John Blackbourn 2022-01-30 19:25:03 +00:00
parent effadc5da9
commit ecc08a41f6
16 changed files with 30 additions and 29 deletions

View File

@ -31,7 +31,7 @@ class Walker_CategoryDropdown extends Walker {
* *
* @since 2.1.0 * @since 2.1.0
* @todo Decouple this * @todo Decouple this
* @var array * @var string[]
* *
* @see Walker::$db_fields * @see Walker::$db_fields
*/ */

View File

@ -30,7 +30,7 @@ class Walker_Category extends Walker {
* Database fields to use. * Database fields to use.
* *
* @since 2.1.0 * @since 2.1.0
* @var array * @var string[]
* *
* @see Walker::$db_fields * @see Walker::$db_fields
* @todo Decouple this * @todo Decouple this

View File

@ -30,7 +30,7 @@ class Walker_Comment extends Walker {
* Database fields to use. * Database fields to use.
* *
* @since 2.7.0 * @since 2.7.0
* @var array * @var string[]
* *
* @see Walker::$db_fields * @see Walker::$db_fields
* @todo Decouple this * @todo Decouple this

View File

@ -30,7 +30,7 @@ class Walker_Nav_Menu extends Walker {
* *
* @since 3.0.0 * @since 3.0.0
* @todo Decouple this. * @todo Decouple this.
* @var array * @var string[]
* *
* @see Walker::$db_fields * @see Walker::$db_fields
*/ */

View File

@ -30,7 +30,7 @@ class Walker_PageDropdown extends Walker {
* Database fields to use. * Database fields to use.
* *
* @since 2.1.0 * @since 2.1.0
* @var array * @var string[]
* *
* @see Walker::$db_fields * @see Walker::$db_fields
* @todo Decouple this * @todo Decouple this

View File

@ -30,7 +30,7 @@ class Walker_Page extends Walker {
* Database fields to use. * Database fields to use.
* *
* @since 2.1.0 * @since 2.1.0
* @var array * @var string[]
* *
* @see Walker::$db_fields * @see Walker::$db_fields
* @todo Decouple this. * @todo Decouple this.

View File

@ -79,7 +79,7 @@ class WP_Block_Type {
* in search interfaces. * in search interfaces.
* *
* @since 5.5.0 * @since 5.5.0
* @var array * @var string[]
*/ */
public $keywords = array(); public $keywords = array();
@ -223,7 +223,7 @@ class WP_Block_Type {
* available when nested within the specified blocks. * available when nested within the specified blocks.
* @type string|null $icon Block type icon. * @type string|null $icon Block type icon.
* @type string $description A detailed block type description. * @type string $description A detailed block type description.
* @type array $keywords Additional keywords to produce block type as * @type string[] $keywords Additional keywords to produce block type as
* result in search interfaces. * result in search interfaces.
* @type string|null $textdomain The translation textdomain. * @type string|null $textdomain The translation textdomain.
* @type array $styles Alternative block styles. * @type array $styles Alternative block styles.

View File

@ -53,7 +53,7 @@ class WP_Date_Query {
* Supported time-related parameter keys. * Supported time-related parameter keys.
* *
* @since 4.1.0 * @since 4.1.0
* @var array * @var string[]
*/ */
public $time_keys = array( 'after', 'before', 'year', 'month', 'monthnum', 'week', 'w', 'dayofyear', 'day', 'dayofweek', 'dayofweek_iso', 'hour', 'minute', 'second' ); public $time_keys = array( 'after', 'before', 'year', 'month', 'monthnum', 'week', 'w', 'dayofyear', 'day', 'dayofweek', 'dayofweek_iso', 'hour', 'minute', 'second' );

View File

@ -34,7 +34,7 @@ class WP_List_Util {
* Temporary arguments for sorting. * Temporary arguments for sorting.
* *
* @since 4.7.0 * @since 4.7.0
* @var array * @var string[]
*/ */
private $orderby = array(); private $orderby = array();

View File

@ -18,7 +18,7 @@ class WP_Locale {
* Stores the translated strings for the full weekday names. * Stores the translated strings for the full weekday names.
* *
* @since 2.1.0 * @since 2.1.0
* @var array * @var string[]
*/ */
public $weekday; public $weekday;
@ -31,7 +31,7 @@ class WP_Locale {
* @see WP_Locale::init() for how to handle the hack. * @see WP_Locale::init() for how to handle the hack.
* *
* @since 2.1.0 * @since 2.1.0
* @var array * @var string[]
*/ */
public $weekday_initial; public $weekday_initial;
@ -39,7 +39,7 @@ class WP_Locale {
* Stores the translated strings for the abbreviated weekday names. * Stores the translated strings for the abbreviated weekday names.
* *
* @since 2.1.0 * @since 2.1.0
* @var array * @var string[]
*/ */
public $weekday_abbrev; public $weekday_abbrev;
@ -47,7 +47,7 @@ class WP_Locale {
* Stores the translated strings for the full month names. * Stores the translated strings for the full month names.
* *
* @since 2.1.0 * @since 2.1.0
* @var array * @var string[]
*/ */
public $month; public $month;
@ -55,7 +55,7 @@ class WP_Locale {
* Stores the translated strings for the month names in genitive case, if the locale specifies. * Stores the translated strings for the month names in genitive case, if the locale specifies.
* *
* @since 4.4.0 * @since 4.4.0
* @var array * @var string[]
*/ */
public $month_genitive; public $month_genitive;
@ -63,7 +63,7 @@ class WP_Locale {
* Stores the translated strings for the abbreviated month names. * Stores the translated strings for the abbreviated month names.
* *
* @since 2.1.0 * @since 2.1.0
* @var array * @var string[]
*/ */
public $month_abbrev; public $month_abbrev;
@ -73,7 +73,7 @@ class WP_Locale {
* Also the capitalized versions. * Also the capitalized versions.
* *
* @since 2.1.0 * @since 2.1.0
* @var array * @var string[]
*/ */
public $meridiem; public $meridiem;

View File

@ -92,6 +92,7 @@ final class WP_Post_Type {
* Whether queries can be performed on the front end for the post type as part of `parse_request()`. * Whether queries can be performed on the front end for the post type as part of `parse_request()`.
* *
* Endpoints would include: * Endpoints would include:
*
* - `?post_type={post_type_key}` * - `?post_type={post_type_key}`
* - `?{post_type_key}={single_post_slug}` * - `?{post_type_key}={single_post_slug}`
* - `?{post_type_query_var}={single_post_slug}` * - `?{post_type_query_var}={single_post_slug}`

View File

@ -275,7 +275,7 @@ class WP_Rewrite {
* Additional tags can be added with add_rewrite_tag(). * Additional tags can be added with add_rewrite_tag().
* *
* @since 1.5.0 * @since 1.5.0
* @var array * @var string[]
*/ */
public $rewritecode = array( public $rewritecode = array(
'%year%', '%year%',
@ -296,7 +296,7 @@ class WP_Rewrite {
* of rewrite tags, see WP_Rewrite::$rewritecode. * of rewrite tags, see WP_Rewrite::$rewritecode.
* *
* @since 1.5.0 * @since 1.5.0
* @var array * @var string[]
*/ */
public $rewritereplace = array( public $rewritereplace = array(
'([0-9]{4})', '([0-9]{4})',
@ -316,7 +316,7 @@ class WP_Rewrite {
* Query variables that rewrite tags map to, see WP_Rewrite::$rewritecode. * Query variables that rewrite tags map to, see WP_Rewrite::$rewritecode.
* *
* @since 1.5.0 * @since 1.5.0
* @var array * @var string[]
*/ */
public $queryreplace = array( public $queryreplace = array(
'year=', 'year=',
@ -336,7 +336,7 @@ class WP_Rewrite {
* Supported default feeds. * Supported default feeds.
* *
* @since 1.5.0 * @since 1.5.0
* @var array * @var string[]
*/ */
public $feeds = array( 'feed', 'rdf', 'rss', 'rss2', 'atom' ); public $feeds = array( 'feed', 'rdf', 'rss', 'rss2', 'atom' );

View File

@ -144,7 +144,7 @@ final class WP_Taxonomy {
* An array of object types this taxonomy is registered for. * An array of object types this taxonomy is registered for.
* *
* @since 4.7.0 * @since 4.7.0
* @var array * @var string[]
*/ */
public $object_type = null; public $object_type = null;
@ -289,8 +289,8 @@ final class WP_Taxonomy {
* *
* @since 4.7.0 * @since 4.7.0
* *
* @param array|string $object_type Name of the object type for the taxonomy object. * @param string|string[] $object_type Name or array of names of the object types for the taxonomy.
* @param array|string $args Array or query string of arguments for registering a taxonomy. * @param array|string $args Array or query string of arguments for registering a taxonomy.
*/ */
public function set_props( $object_type, $args ) { public function set_props( $object_type, $args ) {
$args = wp_parse_args( $args ); $args = wp_parse_args( $args );

View File

@ -23,7 +23,7 @@ final class WP_Theme implements ArrayAccess {
* *
* @since 3.4.0 * @since 3.4.0
* @since 5.4.0 Added `Requires at least` and `Requires PHP` headers. * @since 5.4.0 Added `Requires at least` and `Requires PHP` headers.
* @var array * @var string[]
*/ */
private static $file_headers = array( private static $file_headers = array(
'Name' => 'Theme Name', 'Name' => 'Theme Name',
@ -54,7 +54,7 @@ final class WP_Theme implements ArrayAccess {
* @since 5.0.0 Added the Twenty Nineteen theme. * @since 5.0.0 Added the Twenty Nineteen theme.
* @since 5.3.0 Added the Twenty Twenty theme. * @since 5.3.0 Added the Twenty Twenty theme.
* @since 5.6.0 Added the Twenty Twenty-One theme. * @since 5.6.0 Added the Twenty Twenty-One theme.
* @var array * @var string[]
*/ */
private static $default_themes = array( private static $default_themes = array(
'classic' => 'WordPress Classic', 'classic' => 'WordPress Classic',
@ -77,7 +77,7 @@ final class WP_Theme implements ArrayAccess {
* Renamed theme tags. * Renamed theme tags.
* *
* @since 3.8.0 * @since 3.8.0
* @var array * @var string[]
*/ */
private static $tag_map = array( private static $tag_map = array(
'fixed-width' => 'fixed-layout', 'fixed-width' => 'fixed-layout',

View File

@ -24,7 +24,7 @@ class Walker {
* DB fields to use. * DB fields to use.
* *
* @since 2.1.0 * @since 2.1.0
* @var array * @var string[]
*/ */
public $db_fields; public $db_fields;

View File

@ -16,7 +16,7 @@
* *
* @global string $wp_version * @global string $wp_version
*/ */
$wp_version = '6.0-alpha-52651'; $wp_version = '6.0-alpha-52652';
/** /**
* 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.