Docs: Add missing `@since` entries for `WP_Theme` class methods.

Props keesiemeijer.
Fixes #39503.
Built from https://develop.svn.wordpress.org/trunk@39736


git-svn-id: http://core.svn.wordpress.org/trunk@39676 1a063a9b-81f0-0310-95a4-ce76da25c4cd
This commit is contained in:
Sergey Biryukov 2017-01-06 22:10:35 +00:00
parent b971410d2f
commit 64675a6a0b
2 changed files with 20 additions and 2 deletions

View File

@ -148,7 +148,7 @@ final class WP_Theme implements ArrayAccess {
* URL to the theme root, usually an absolute URL to wp-content/themes * URL to the theme root, usually an absolute URL to wp-content/themes
* *
* @access private * @access private
* var string * @var string
*/ */
private $theme_root_uri; private $theme_root_uri;
@ -193,6 +193,8 @@ final class WP_Theme implements ArrayAccess {
/** /**
* Constructor for WP_Theme. * Constructor for WP_Theme.
* *
* @since 3.4.0
*
* @global array $wp_theme_directories * @global array $wp_theme_directories
* *
* @param string $theme_dir Directory of the theme within the theme_root. * @param string $theme_dir Directory of the theme within the theme_root.
@ -333,6 +335,8 @@ final class WP_Theme implements ArrayAccess {
/** /**
* When converting the object to a string, the theme name is returned. * When converting the object to a string, the theme name is returned.
* *
* @since 3.4.0
*
* @return string Theme name, ready for display (translated) * @return string Theme name, ready for display (translated)
*/ */
public function __toString() { public function __toString() {
@ -344,6 +348,8 @@ final class WP_Theme implements ArrayAccess {
* *
* @staticvar array $properties * @staticvar array $properties
* *
* @since 3.4.0
*
* @param string $offset Property to check if set. * @param string $offset Property to check if set.
* @return bool Whether the given property is set. * @return bool Whether the given property is set.
*/ */
@ -359,6 +365,8 @@ final class WP_Theme implements ArrayAccess {
/** /**
* __get() magic method for properties formerly returned by current_theme_info() * __get() magic method for properties formerly returned by current_theme_info()
* *
* @since 3.4.0
*
* @param string $offset Property to get. * @param string $offset Property to get.
* @return mixed Property value. * @return mixed Property value.
*/ */
@ -401,6 +409,8 @@ final class WP_Theme implements ArrayAccess {
/** /**
* Method to implement ArrayAccess for keys formerly returned by get_themes() * Method to implement ArrayAccess for keys formerly returned by get_themes()
* *
* @since 3.4.0
*
* @param mixed $offset * @param mixed $offset
* @param mixed $value * @param mixed $value
*/ */
@ -409,6 +419,8 @@ final class WP_Theme implements ArrayAccess {
/** /**
* Method to implement ArrayAccess for keys formerly returned by get_themes() * Method to implement ArrayAccess for keys formerly returned by get_themes()
* *
* @since 3.4.0
*
* @param mixed $offset * @param mixed $offset
*/ */
public function offsetUnset( $offset ) {} public function offsetUnset( $offset ) {}
@ -418,6 +430,8 @@ final class WP_Theme implements ArrayAccess {
* *
* @staticvar array $keys * @staticvar array $keys
* *
* @since 3.4.0
*
* @param mixed $offset * @param mixed $offset
* @return bool * @return bool
*/ */
@ -441,6 +455,8 @@ final class WP_Theme implements ArrayAccess {
* and care should be taken to use `$theme::display( 'Name' )` to get a properly * and care should be taken to use `$theme::display( 'Name' )` to get a properly
* translated header. * translated header.
* *
* @since 3.4.0
*
* @param mixed $offset * @param mixed $offset
* @return mixed * @return mixed
*/ */
@ -1226,6 +1242,8 @@ final class WP_Theme implements ArrayAccess {
* *
* This hits the filesystem. * This hits the filesystem.
* *
* @since 4.4.0
*
* @return WP_Theme|false Object, or false if no theme is installed, which would be bad. * @return WP_Theme|false Object, or false if no theme is installed, which would be bad.
*/ */
public static function get_core_default_theme() { public static function get_core_default_theme() {

View File

@ -4,7 +4,7 @@
* *
* @global string $wp_version * @global string $wp_version
*/ */
$wp_version = '4.8-alpha-39735'; $wp_version = '4.8-alpha-39736';
/** /**
* 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.