Upstream/WordPress
1
0
Fork 0
mirror of https://github.com/WordPress/WordPress.git synced 2024-06-29 16:25:03 +02:00
Code Issues Projects Releases Wiki Activity

First there were two, and now there are three -- in the @since versions that came before and that shall be. And so it will be, says nacin.

Browse Source 
Props JustinSainton, SergeyBiryukov, DrewAPicture.
Fixes #26713.

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


git-svn-id: http://core.svn.wordpress.org/trunk@26754 1a063a9b-81f0-0310-95a4-ce76da25c4cd
This commit is contained in:
Drew Jaynes 2013-12-24 18:57:12 +00:00
parent 1f5f0fcd33
commit cd8cedc40d
39 changed files with 289 additions and 251 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
wp-activate.php
View File

@ -27,7 +27,7 @@ $wp_query->is_404 = false;
/** /**
* Fires before the Site Activation page is loaded. * Fires before the Site Activation page is loaded.
* *
* @since 3.0 * @since 3.0.0
*/ */
do_action( 'activate_header' ); do_action( 'activate_header' );
@ -40,7 +40,7 @@ function do_activate_header() {
/** /**
* Fires before the Site Activation page is loaded, but on the wp_head action. * Fires before the Site Activation page is loaded, but on the wp_head action.
* *
* @since 3.0 * @since 3.0.0
*/ */
do_action( 'activate_wp_head' ); do_action( 'activate_wp_head' );
} }

2
wp-admin/admin-functions.php
View File

@ -4,7 +4,7 @@
* *
* This file is deprecated, use 'wp-admin/includes/admin.php' instead. * This file is deprecated, use 'wp-admin/includes/admin.php' instead.
* *
* @deprecated 2.5 * @deprecated 2.5.0
* @package WordPress * @package WordPress
* @subpackage Administration * @subpackage Administration
*/ */

2
wp-admin/custom-header.php
View File

@ -177,7 +177,7 @@ class Custom_Image_Header {
/** /**
* Set up the enqueue for the CSS files * Set up the enqueue for the CSS files
* *
* @since 2.7 * @since 2.7.0
*/ */
function css_includes() { function css_includes() {
$step = $this->step(); $step = $this->step();

2
wp-admin/includes/ajax-actions.php
View File

@ -259,7 +259,7 @@ function wp_ajax_logged_in() {
* *
* Contrary to normal success AJAX response ("1"), die with time() on success. * Contrary to normal success AJAX response ("1"), die with time() on success.
* *
* @since 2.7 * @since 2.7.0
* *
* @param int $comment_id * @param int $comment_id
* @return die * @return die

4
wp-admin/includes/class-ftp-pure.php
View File

@ -3,7 +3,7 @@
* PemFTP - A Ftp implementation in pure PHP * PemFTP - A Ftp implementation in pure PHP
* *
* @package PemFTP * @package PemFTP
* @since 2.5 * @since 2.5.0
* *
* @version 1.0 * @version 1.0
* @copyright Alexey Dotsenko * @copyright Alexey Dotsenko
@ -17,7 +17,7 @@
* *
* @package PemFTP * @package PemFTP
* @subpackage Pure * @subpackage Pure
* @since 2.5 * @since 2.5.0
* *
* @version 1.0 * @version 1.0
* @copyright Alexey Dotsenko * @copyright Alexey Dotsenko

4
wp-admin/includes/class-ftp-sockets.php
View File

@ -3,7 +3,7 @@
* PemFTP - A Ftp implementation in pure PHP * PemFTP - A Ftp implementation in pure PHP
* *
* @package PemFTP * @package PemFTP
* @since 2.5 * @since 2.5.0
* *
* @version 1.0 * @version 1.0
* @copyright Alexey Dotsenko * @copyright Alexey Dotsenko
@ -17,7 +17,7 @@
* *
* @package PemFTP * @package PemFTP
* @subpackage Socket * @subpackage Socket
* @since 2.5 * @since 2.5.0
* *
* @version 1.0 * @version 1.0
* @copyright Alexey Dotsenko * @copyright Alexey Dotsenko

4
wp-admin/includes/class-wp-theme-install-list-table.php
View File

@ -358,7 +358,7 @@ class WP_Theme_Install_List_Table extends WP_Themes_List_Table {
/** /**
* Send required variables to JavaScript land * Send required variables to JavaScript land
* *
* @since 3.4 * @since 3.4.0
* @access private * @access private
* *
* @uses $tab Global; current tab within Themes->Install screen * @uses $tab Global; current tab within Themes->Install screen
@ -372,7 +372,7 @@ class WP_Theme_Install_List_Table extends WP_Themes_List_Table {
/** /**
* Check to see if the theme is already installed. * Check to see if the theme is already installed.
* *
* @since 3.4 * @since 3.4.0
* @access private * @access private
* *
* @param object $theme - A WordPress.org Theme API object. * @param object $theme - A WordPress.org Theme API object.

2
wp-admin/includes/file.php
View File

@ -191,7 +191,7 @@ function validate_file_to_edit( $file, $allowed_files = '' ) {
* Handle PHP uploads in WordPress, sanitizing file names, checking extensions for mime type, * Handle PHP uploads in WordPress, sanitizing file names, checking extensions for mime type,
* and moving the file to the appropriate directory within the uploads directory. * and moving the file to the appropriate directory within the uploads directory.
* *
* @since 2.0 * @since 2.0.0
* *
* @uses wp_handle_upload_error * @uses wp_handle_upload_error
* @uses apply_filters * @uses apply_filters

8
wp-admin/includes/misc.php
View File

@ -346,7 +346,7 @@ function wp_doc_link_parse( $content ) {
/** /**
* Saves option for number of rows when listing posts, pages, comments, etc. * Saves option for number of rows when listing posts, pages, comments, etc.
* *
* @since 2.8 * @since 2.8.0
**/ **/
function set_screen_options() { function set_screen_options() {
@ -648,7 +648,7 @@ add_action('admin_head', '_ipad_meta');
/** /**
* Check lock status for posts displayed on the Posts screen * Check lock status for posts displayed on the Posts screen
* *
* @since 3.6 * @since 3.6.0
*/ */
function wp_check_locked_posts( $response, $data, $screen_id ) { function wp_check_locked_posts( $response, $data, $screen_id ) {
$checked = array(); $checked = array();
@ -679,7 +679,7 @@ add_filter( 'heartbeat_received', 'wp_check_locked_posts', 10, 3 );
/** /**
* Check lock status on the New/Edit Post screen and refresh the lock * Check lock status on the New/Edit Post screen and refresh the lock
* *
* @since 3.6 * @since 3.6.0
*/ */
function wp_refresh_post_lock( $response, $data, $screen_id ) { function wp_refresh_post_lock( $response, $data, $screen_id ) {
if ( array_key_exists( 'wp-refresh-post-lock', $data ) ) { if ( array_key_exists( 'wp-refresh-post-lock', $data ) ) {
@ -718,7 +718,7 @@ add_filter( 'heartbeat_received', 'wp_refresh_post_lock', 10, 3 );
/** /**
* Check nonce expiration on the New/Edit Post screen and refresh if needed * Check nonce expiration on the New/Edit Post screen and refresh if needed
* *
* @since 3.6 * @since 3.6.0
*/ */
function wp_refresh_post_nonces( $response, $data, $screen_id ) { function wp_refresh_post_nonces( $response, $data, $screen_id ) {
if ( array_key_exists( 'wp-refresh-post-nonces', $data ) ) { if ( array_key_exists( 'wp-refresh-post-nonces', $data ) ) {

2
wp-admin/includes/plugin.php
View File

@ -1412,7 +1412,7 @@ function remove_submenu_page( $menu_slug, $submenu_slug ) {
* *
* If the slug hasn't been registered properly no url will be returned * If the slug hasn't been registered properly no url will be returned
* *
* @since 3.0 * @since 3.0.0
* *
* @param string $menu_slug The slug name to refer to this menu by (should be unique for this menu) * @param string $menu_slug The slug name to refer to this menu by (should be unique for this menu)
* @param bool $echo Whether or not to echo the url - default is true * @param bool $echo Whether or not to echo the url - default is true

2
wp-admin/includes/template.php
View File

@ -1949,7 +1949,7 @@ function convert_to_screen( $hook_name ) {
/** /**
* Output the HTML for restoring the post data from DOM storage * Output the HTML for restoring the post data from DOM storage
* *
* @since 3.6 * @since 3.6.0
* @access private * @access private
*/ */
function _local_storage_notice() { function _local_storage_notice() {

6
wp-admin/includes/user.php
View File

@ -9,7 +9,7 @@
/** /**
* Creates a new user from the "Users" form using $_POST information. * Creates a new user from the "Users" form using $_POST information.
* *
* @since 2.0 * @since 2.0.0
* *
* @return null|WP_Error|int Null when adding user, WP_Error or User ID integer when no parameters. * @return null|WP_Error|int Null when adding user, WP_Error or User ID integer when no parameters.
*/ */
@ -22,7 +22,7 @@ function add_user() {
* *
* Used on user-edit.php and profile.php to manage and process user options, passwords etc. * Used on user-edit.php and profile.php to manage and process user options, passwords etc.
* *
* @since 2.0 * @since 2.0.0
* *
* @param int $user_id Optional. User ID. * @param int $user_id Optional. User ID.
* @return int user id of the updated user * @return int user id of the updated user
@ -193,7 +193,7 @@ function edit_user( $user_id = 0 ) {
* only editors or authors. This filter allows admins to delegate * only editors or authors. This filter allows admins to delegate
* user management. * user management.
* *
* @since 2.8 * @since 2.8.0
* *
* @return unknown * @return unknown
*/ */

10
wp-admin/js/theme-install.js
View File

@ -129,7 +129,7 @@ jQuery( document ).ready( function() {
/** /**
* Class that provides infinite scroll for Themes admin screens * Class that provides infinite scroll for Themes admin screens
* *
* @since 3.4 * @since 3.4.0
* *
* @uses ajaxurl * @uses ajaxurl
* @uses list_args * @uses list_args
@ -147,7 +147,7 @@ var ThemeScroller;
/** /**
* Initializer * Initializer
* *
* @since 3.4 * @since 3.4.0
* @access private * @access private
*/ */
init: function() { init: function() {
@ -187,7 +187,7 @@ var ThemeScroller;
* Checks to see if user has scrolled to bottom of page. * Checks to see if user has scrolled to bottom of page.
* If so, requests another page of content from self.ajax(). * If so, requests another page of content from self.ajax().
* *
* @since 3.4 * @since 3.4.0
* @access private * @access private
*/ */
poll: function() { poll: function() {
@ -204,7 +204,7 @@ var ThemeScroller;
/** /**
* Applies results passed from this.ajax() to $outList * Applies results passed from this.ajax() to $outList
* *
* @since 3.4 * @since 3.4.0
* @access private * @access private
* *
* @param results Array with results from this.ajax() query. * @param results Array with results from this.ajax() query.
@ -227,7 +227,7 @@ var ThemeScroller;
/** /**
* Queries next page of themes * Queries next page of themes
* *
* @since 3.4 * @since 3.4.0
* @access private * @access private
*/ */
ajax: function() { ajax: function() {

4
wp-admin/update-core.php
View File

@ -133,7 +133,7 @@ function dismissed_updates() {
/** /**
* Display upgrade WordPress for downloading latest or upgrading automatically form. * Display upgrade WordPress for downloading latest or upgrading automatically form.
* *
* @since 2.7 * @since 2.7.0
* *
* @return null * @return null
*/ */
@ -353,7 +353,7 @@ function list_translation_updates() {
/** /**
* Upgrade WordPress core display. * Upgrade WordPress core display.
* *
* @since 2.7 * @since 2.7.0
* *
* @return null * @return null
*/ */

2
wp-admin/upgrade-functions.php
View File

@ -3,7 +3,7 @@
* WordPress Upgrade Functions. Old file, must not be used. Include * WordPress Upgrade Functions. Old file, must not be used. Include
* wp-admin/includes/upgrade.php instead. * wp-admin/includes/upgrade.php instead.
* *
* @deprecated 2.5 * @deprecated 2.5.0
* @package WordPress * @package WordPress
* @subpackage Administration * @subpackage Administration
*/ */

2
wp-includes/atomlib.php
View File

@ -7,7 +7,7 @@
* *
* @author Elias Torres <elias@torrez.us> * @author Elias Torres <elias@torrez.us>
* @version 0.4 * @version 0.4
* @since 2.3 * @since 2.3.0
*/ */
/** /**

16
wp-includes/author-template.php
View File

@ -13,7 +13,8 @@
/** /**
* Retrieve the author of the current post. * Retrieve the author of the current post.
* *
* @since 1.5 * @since 1.5.0
*
* @uses $authordata The current author's DB object. * @uses $authordata The current author's DB object.
* @uses apply_filters() Calls 'the_author' hook on the author display name. * @uses apply_filters() Calls 'the_author' hook on the author display name.
* *
@ -68,7 +69,8 @@ function the_author( $deprecated = '', $deprecated_echo = true ) {
/** /**
* Retrieve the author who last edited the current post. * Retrieve the author who last edited the current post.
* *
* @since 2.8 * @since 2.8.0
*
* @uses $post The current post's DB object. * @uses $post The current post's DB object.
* @uses get_post_meta() Retrieves the ID of the author who last edited the current post. * @uses get_post_meta() Retrieves the ID of the author who last edited the current post.
* @uses get_userdata() Retrieves the author's DB object. * @uses get_userdata() Retrieves the author's DB object.
@ -93,7 +95,8 @@ function get_the_modified_author() {
/** /**
* Display the name of the author who last edited the current post. * Display the name of the author who last edited the current post.
* *
* @since 2.8 * @since 2.8.0
*
* @see get_the_author() * @see get_the_author()
* @return string The author's display name, from get_the_modified_author(). * @return string The author's display name, from get_the_modified_author().
*/ */
@ -184,7 +187,9 @@ function get_the_author_link() {
* author's name. * author's name.
* *
* @link http://codex.wordpress.org/Template_Tags/the_author_link * @link http://codex.wordpress.org/Template_Tags/the_author_link
* @since 2.1 *
* @since 2.1.0
*
* @uses get_the_author_link() * @uses get_the_author_link()
*/ */
function the_author_link() { function the_author_link() {
@ -194,7 +199,8 @@ function the_author_link() {
/** /**
* Retrieve the number of posts by the author of the current post. * Retrieve the number of posts by the author of the current post.
* *
* @since 1.5 * @since 1.5.0
*
* @uses $post The current post in the Loop's DB object. * @uses $post The current post in the Loop's DB object.
* @uses count_user_posts() * @uses count_user_posts()
* @return int The number of posts by the author. * @return int The number of posts by the author.

5
wp-includes/cache.php
View File

@ -163,7 +163,8 @@ function wp_cache_replace( $key, $data, $group = '', $expire = 0 ) {
/** /**
* Saves the data to the cache. * Saves the data to the cache.
* *
* @since 2.0 * @since 2.0.0
*
* @uses $wp_object_cache Object Cache Class * @uses $wp_object_cache Object Cache Class
* @see WP_Object_Cache::set() * @see WP_Object_Cache::set()
* *
@ -256,7 +257,7 @@ function wp_cache_reset() {
* *
* @package WordPress * @package WordPress
* @subpackage Cache * @subpackage Cache
* @since 2.0 * @since 2.0.0
*/ */
class WP_Object_Cache { class WP_Object_Cache {

2
wp-includes/canonical.php
View File

@ -467,7 +467,7 @@ function redirect_canonical( $requested_url = null, $do_redirect = true ) {
* Removes arguments from a query string if they are not present in a URL * Removes arguments from a query string if they are not present in a URL
* DO NOT use this in plugin code. * DO NOT use this in plugin code.
* *
* @since 3.4 * @since 3.4.0
* @access private * @access private
* *
* @return string The altered query string * @return string The altered query string

4
wp-includes/category-template.php
View File

@ -1042,7 +1042,7 @@ function the_tags( $before = null, $sep = ', ', $after = '' ) {
/** /**
* Retrieve tag description. * Retrieve tag description.
* *
* @since 2.8 * @since 2.8.0
* *
* @param int $tag Optional. Tag ID. Will use global tag ID by default. * @param int $tag Optional. Tag ID. Will use global tag ID by default.
* @return string Tag description, available. * @return string Tag description, available.
@ -1054,7 +1054,7 @@ function tag_description( $tag = 0 ) {
/** /**
* Retrieve term description. * Retrieve term description.
* *
* @since 2.8 * @since 2.8.0
* *
* @param int $term Optional. Term ID. Will use global term ID by default. * @param int $term Optional. Term ID. Will use global term ID by default.
* @param string $taxonomy Optional taxonomy name. Defaults to 'post_tag'. * @param string $taxonomy Optional taxonomy name. Defaults to 'post_tag'.

22
wp-includes/class-IXR.php
View File

@ -30,7 +30,7 @@
* USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. * USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
* *
* @package IXR * @package IXR
* @since 1.5 * @since 1.5.0
* *
* @copyright Incutio Ltd 2010 (http://www.incutio.com) * @copyright Incutio Ltd 2010 (http://www.incutio.com)
* @version 1.7.4 7th September 2010 * @version 1.7.4 7th September 2010
@ -43,7 +43,7 @@
* IXR_Value * IXR_Value
* *
* @package IXR * @package IXR
* @since 1.5 * @since 1.5.0
*/ */
class IXR_Value { class IXR_Value {
var $data; var $data;
@ -171,7 +171,7 @@ class IXR_Value {
* IXR_MESSAGE * IXR_MESSAGE
* *
* @package IXR * @package IXR
* @since 1.5 * @since 1.5.0
* *
*/ */
class IXR_Message class IXR_Message
@ -344,7 +344,7 @@ class IXR_Message
* IXR_Server * IXR_Server
* *
* @package IXR * @package IXR
* @since 1.5 * @since 1.5.0
*/ */
class IXR_Server class IXR_Server
{ {
@ -555,7 +555,7 @@ EOD;
* IXR_Request * IXR_Request
* *
* @package IXR * @package IXR
* @since 1.5 * @since 1.5.0
*/ */
class IXR_Request class IXR_Request
{ {
@ -598,7 +598,7 @@ EOD;
* IXR_Client * IXR_Client
* *
* @package IXR * @package IXR
* @since 1.5 * @since 1.5.0
* *
*/ */
class IXR_Client class IXR_Client
@ -750,7 +750,7 @@ class IXR_Client
* IXR_Error * IXR_Error
* *
* @package IXR * @package IXR
* @since 1.5 * @since 1.5.0
*/ */
class IXR_Error class IXR_Error
{ {
@ -792,7 +792,7 @@ EOD;
* IXR_Date * IXR_Date
* *
* @package IXR * @package IXR
* @since 1.5 * @since 1.5.0
*/ */
class IXR_Date { class IXR_Date {
var $year; var $year;
@ -855,7 +855,7 @@ class IXR_Date {
* IXR_Base64 * IXR_Base64
* *
* @package IXR * @package IXR
* @since 1.5 * @since 1.5.0
*/ */
class IXR_Base64 class IXR_Base64
{ {
@ -876,7 +876,7 @@ class IXR_Base64
* IXR_IntrospectionServer * IXR_IntrospectionServer
* *
* @package IXR * @package IXR
* @since 1.5 * @since 1.5.0
*/ */
class IXR_IntrospectionServer extends IXR_Server class IXR_IntrospectionServer extends IXR_Server
{ {
@ -1039,7 +1039,7 @@ class IXR_IntrospectionServer extends IXR_Server
* IXR_ClientMulticall * IXR_ClientMulticall
* *
* @package IXR * @package IXR
* @since 1.5 * @since 1.5.0
*/ */
class IXR_ClientMulticall extends IXR_Client class IXR_ClientMulticall extends IXR_Client
{ {

34
wp-includes/class-http.php
View File

@ -1395,14 +1395,15 @@ class WP_Http_Curl {
* *
* @link http://core.trac.wordpress.org/ticket/4011 Proxy support ticket in WordPress. * @link http://core.trac.wordpress.org/ticket/4011 Proxy support ticket in WordPress.
* @link http://core.trac.wordpress.org/ticket/14636 Allow wildcard domains in WP_PROXY_BYPASS_HOSTS * @link http://core.trac.wordpress.org/ticket/14636 Allow wildcard domains in WP_PROXY_BYPASS_HOSTS
* @since 2.8 * @since 2.8.0
*/ */
class WP_HTTP_Proxy { class WP_HTTP_Proxy {
/** /**
* Whether proxy connection should be used. * Whether proxy connection should be used.
* *
* @since 2.8 * @since 2.8.0
*
* @use WP_PROXY_HOST * @use WP_PROXY_HOST
* @use WP_PROXY_PORT * @use WP_PROXY_PORT
* *
@ -1415,7 +1416,8 @@ class WP_HTTP_Proxy {
/** /**
* Whether authentication should be used. * Whether authentication should be used.
* *
* @since 2.8 * @since 2.8.0
*
* @use WP_PROXY_USERNAME * @use WP_PROXY_USERNAME
* @use WP_PROXY_PASSWORD * @use WP_PROXY_PASSWORD
* *
@ -1428,7 +1430,7 @@ class WP_HTTP_Proxy {
/** /**
* Retrieve the host for the proxy server. * Retrieve the host for the proxy server.
* *
* @since 2.8 * @since 2.8.0
* *
* @return string * @return string
*/ */
@ -1442,7 +1444,7 @@ class WP_HTTP_Proxy {
/** /**
* Retrieve the port for the proxy server. * Retrieve the port for the proxy server.
* *
* @since 2.8 * @since 2.8.0
* *
* @return string * @return string
*/ */
@ -1456,7 +1458,7 @@ class WP_HTTP_Proxy {
/** /**
* Retrieve the username for proxy authentication. * Retrieve the username for proxy authentication.
* *
* @since 2.8 * @since 2.8.0
* *
* @return string * @return string
*/ */
@ -1470,7 +1472,7 @@ class WP_HTTP_Proxy {
/** /**
* Retrieve the password for proxy authentication. * Retrieve the password for proxy authentication.
* *
* @since 2.8 * @since 2.8.0
* *
* @return string * @return string
*/ */
@ -1484,7 +1486,7 @@ class WP_HTTP_Proxy {
/** /**
* Retrieve authentication string for proxy authentication. * Retrieve authentication string for proxy authentication.
* *
* @since 2.8 * @since 2.8.0
* *
* @return string * @return string
*/ */
@ -1495,7 +1497,7 @@ class WP_HTTP_Proxy {
/** /**
* Retrieve header string for proxy authentication. * Retrieve header string for proxy authentication.
* *
* @since 2.8 * @since 2.8.0
* *
* @return string * @return string
*/ */
@ -1762,7 +1764,7 @@ class WP_Http_Cookie {
* *
* Includes RFC 1950, RFC 1951, and RFC 1952. * Includes RFC 1950, RFC 1951, and RFC 1952.
* *
* @since 2.8 * @since 2.8.0
* @package WordPress * @package WordPress
* @subpackage HTTP * @subpackage HTTP
*/ */
@ -1773,7 +1775,7 @@ class WP_Http_Encoding {
* *
* Supports the RFC 1951 standard. * Supports the RFC 1951 standard.
* *
* @since 2.8 * @since 2.8.0
* *
* @param string $raw String to compress. * @param string $raw String to compress.
* @param int $level Optional, default is 9. Compression level, 9 is highest. * @param int $level Optional, default is 9. Compression level, 9 is highest.
@ -1792,7 +1794,7 @@ class WP_Http_Encoding {
* 1952 standard gzip decode will be attempted. If all fail, then the * 1952 standard gzip decode will be attempted. If all fail, then the
* original compressed string will be returned. * original compressed string will be returned.
* *
* @since 2.8 * @since 2.8.0
* *
* @param string $compressed String to decompress. * @param string $compressed String to decompress.
* @param int $length The optional length of the compressed data. * @param int $length The optional length of the compressed data.
@ -1876,7 +1878,7 @@ class WP_Http_Encoding {
/** /**
* What encoding types to accept and their priority values. * What encoding types to accept and their priority values.
* *
* @since 2.8 * @since 2.8.0
* *
* @return string Types of encoding to accept. * @return string Types of encoding to accept.
*/ */
@ -1910,7 +1912,7 @@ class WP_Http_Encoding {
/** /**
* What encoding the content used when it was compressed to send in the headers. * What encoding the content used when it was compressed to send in the headers.
* *
* @since 2.8 * @since 2.8.0
* *
* @return string Content-Encoding string to send in the header. * @return string Content-Encoding string to send in the header.
*/ */
@ -1921,7 +1923,7 @@ class WP_Http_Encoding {
/** /**
* Whether the content be decoded based on the headers. * Whether the content be decoded based on the headers.
* *
* @since 2.8 * @since 2.8.0
* *
* @param array|string $headers All of the available headers. * @param array|string $headers All of the available headers.
* @return bool * @return bool
@ -1944,7 +1946,7 @@ class WP_Http_Encoding {
* ensure that the functions all exist in the PHP version and aren't * ensure that the functions all exist in the PHP version and aren't
* disabled. * disabled.
* *
* @since 2.8 * @since 2.8.0
* *
* @return bool * @return bool
*/ */

4
wp-includes/class-phpass.php
View File

@ -2,7 +2,7 @@
/** /**
* Portable PHP password hashing framework. * Portable PHP password hashing framework.
* @package phpass * @package phpass
* @since 2.5 * @since 2.5.0
* @version 0.3 / WordPress * @version 0.3 / WordPress
* @link http://www.openwall.com/phpass/ * @link http://www.openwall.com/phpass/
*/ */
@ -31,7 +31,7 @@
* @package phpass * @package phpass
* @version 0.3 / WordPress * @version 0.3 / WordPress
* @link http://www.openwall.com/phpass/ * @link http://www.openwall.com/phpass/
* @since 2.5 * @since 2.5.0
*/ */
class PasswordHash { class PasswordHash {
var $itoa64; var $itoa64;

2
wp-includes/class-wp-xmlrpc-server.php
View File

@ -3349,7 +3349,7 @@ class wp_xmlrpc_server extends IXR_Server {
/** /**
* Retrieves a list of post formats used by the site * Retrieves a list of post formats used by the site
* *
* @since 3.1 * @since 3.1.0
* *
* @param array $args Method parameters. Contains: * @param array $args Method parameters. Contains:
* - blog_id * - blog_id

2
wp-includes/comment-template.php
View File

@ -139,7 +139,7 @@ function comment_author_email_link( $linktext = '', $before = '', $after = '' )
* *
* @global object $comment The current Comment row object. * @global object $comment The current Comment row object.
* *
* @since 2.7 * @since 2.7.0
* *
* @param string $linktext Optional. The text to display instead of the comment author's email address. Default empty. * @param string $linktext Optional. The text to display instead of the comment author's email address. Default empty.
* @param string $before Optional. The text or HTML to display before the email link. Default empty. * @param string $before Optional. The text or HTML to display before the email link. Default empty.

3
wp-includes/default-constants.php
View File

@ -160,7 +160,8 @@ function wp_plugin_directory_constants() {
function wp_cookie_constants() { function wp_cookie_constants() {
/** /**
* Used to guarantee unique hash cookies * Used to guarantee unique hash cookies
* @since 1.5 *
* @since 1.5.0
*/ */
if ( !defined( 'COOKIEHASH' ) ) { if ( !defined( 'COOKIEHASH' ) ) {
$siteurl = get_site_option( 'siteurl' ); $siteurl = get_site_option( 'siteurl' );

206
wp-includes/deprecated.php
View File

@ -53,7 +53,7 @@ function get_postdata($postid) {
* Sets up the WordPress Loop. * Sets up the WordPress Loop.
* *
* @since 1.0.1 * @since 1.0.1
* @deprecated 1.5 * @deprecated 1.5.0
* @deprecated Use The Loop - {@link http://codex.wordpress.org/The_Loop Use new WordPress Loop} * @deprecated Use The Loop - {@link http://codex.wordpress.org/The_Loop Use new WordPress Loop}
*/ */
function start_wp() { function start_wp() {
@ -121,8 +121,8 @@ function the_category_head($before='', $after='') {
/** /**
* Prints link to the previous post. * Prints link to the previous post.
* *
* @since 1.5 * @since 1.5.0
* @deprecated 2.0 * @deprecated 2.0.0
* @deprecated Use previous_post_link() * @deprecated Use previous_post_link()
* @see previous_post_link() * @see previous_post_link()
* *
@ -159,7 +159,7 @@ function previous_post($format='%', $previous='previous post: ', $title='yes', $
* Prints link to the next post. * Prints link to the next post.
* *
* @since 0.71 * @since 0.71
* @deprecated 2.0 * @deprecated 2.0.0
* @deprecated Use next_post_link() * @deprecated Use next_post_link()
* @see next_post_link() * @see next_post_link()
* *
@ -194,8 +194,8 @@ function next_post($format='%', $next='next post: ', $title='yes', $in_same_cat=
/** /**
* Whether user can create a post. * Whether user can create a post.
* *
* @since 1.5 * @since 1.5.0
* @deprecated 2.0 * @deprecated 2.0.0
* @deprecated Use current_user_can() * @deprecated Use current_user_can()
* @see current_user_can() * @see current_user_can()
* *
@ -214,8 +214,8 @@ function user_can_create_post($user_id, $blog_id = 1, $category_id = 'None') {
/** /**
* Whether user can create a post. * Whether user can create a post.
* *
* @since 1.5 * @since 1.5.0
* @deprecated 2.0 * @deprecated 2.0.0
* @deprecated Use current_user_can() * @deprecated Use current_user_can()
* @see current_user_can() * @see current_user_can()
* *
@ -234,8 +234,8 @@ function user_can_create_draft($user_id, $blog_id = 1, $category_id = 'None') {
/** /**
* Whether user can edit a post. * Whether user can edit a post.
* *
* @since 1.5 * @since 1.5.0
* @deprecated 2.0 * @deprecated 2.0.0
* @deprecated Use current_user_can() * @deprecated Use current_user_can()
* @see current_user_can() * @see current_user_can()
* *
@ -263,8 +263,8 @@ function user_can_edit_post($user_id, $post_id, $blog_id = 1) {
/** /**
* Whether user can delete a post. * Whether user can delete a post.
* *
* @since 1.5 * @since 1.5.0
* @deprecated 2.0 * @deprecated 2.0.0
* @deprecated Use current_user_can() * @deprecated Use current_user_can()
* @see current_user_can() * @see current_user_can()
* *
@ -283,8 +283,8 @@ function user_can_delete_post($user_id, $post_id, $blog_id = 1) {
/** /**
* Whether user can set new posts' dates. * Whether user can set new posts' dates.
* *
* @since 1.5 * @since 1.5.0
* @deprecated 2.0 * @deprecated 2.0.0
* @deprecated Use current_user_can() * @deprecated Use current_user_can()
* @see current_user_can() * @see current_user_can()
* *
@ -303,8 +303,8 @@ function user_can_set_post_date($user_id, $blog_id = 1, $category_id = 'None') {
/** /**
* Whether user can delete a post. * Whether user can delete a post.
* *
* @since 1.5 * @since 1.5.0
* @deprecated 2.0 * @deprecated 2.0.0
* @deprecated Use current_user_can() * @deprecated Use current_user_can()
* @see current_user_can() * @see current_user_can()
* *
@ -323,8 +323,8 @@ function user_can_edit_post_date($user_id, $post_id, $blog_id = 1) {
/** /**
* Whether user can delete a post. * Whether user can delete a post.
* *
* @since 1.5 * @since 1.5.0
* @deprecated 2.0 * @deprecated 2.0.0
* @deprecated Use current_user_can() * @deprecated Use current_user_can()
* @see current_user_can() * @see current_user_can()
* *
@ -343,8 +343,8 @@ function user_can_edit_post_comments($user_id, $post_id, $blog_id = 1) {
/** /**
* Whether user can delete a post. * Whether user can delete a post.
* *
* @since 1.5 * @since 1.5.0
* @deprecated 2.0 * @deprecated 2.0.0
* @deprecated Use current_user_can() * @deprecated Use current_user_can()
* @see current_user_can() * @see current_user_can()
* *
@ -363,8 +363,8 @@ function user_can_delete_post_comments($user_id, $post_id, $blog_id = 1) {
/** /**
* Can user can edit other user. * Can user can edit other user.
* *
* @since 1.5 * @since 1.5.0
* @deprecated 2.0 * @deprecated 2.0.0
* @deprecated Use current_user_can() * @deprecated Use current_user_can()
* @see current_user_can() * @see current_user_can()
* *
@ -387,7 +387,7 @@ function user_can_edit_user($user_id, $other_user) {
* Gets the links associated with category $cat_name. * Gets the links associated with category $cat_name.
* *
* @since 0.71 * @since 0.71
* @deprecated 2.1 * @deprecated 2.1.0
* @deprecated Use get_bookmarks() * @deprecated Use get_bookmarks()
* @see get_bookmarks() * @see get_bookmarks()
* *
@ -421,7 +421,7 @@ function get_linksbyname($cat_name = "noname", $before = '', $after = '<br />',
* Gets the links associated with the named category. * Gets the links associated with the named category.
* *
* @since 1.0.1 * @since 1.0.1
* @deprecated 2.1 * @deprecated 2.1.0
* @deprecated Use wp_list_bookmarks() * @deprecated Use wp_list_bookmarks()
* @see wp_list_bookmarks() * @see wp_list_bookmarks()
* *
@ -459,7 +459,7 @@ function wp_get_linksbyname($category, $args = '') {
* </code> * </code>
* *
* @since 1.0.1 * @since 1.0.1
* @deprecated 2.1 * @deprecated 2.1.0
* @deprecated Use get_bookmarks() * @deprecated Use get_bookmarks()
* @see get_bookmarks() * @see get_bookmarks()
* *
@ -512,7 +512,7 @@ function get_linkobjectsbyname($cat_name = "noname" , $orderby = 'name', $limit
* </ol> * </ol>
* *
* @since 1.0.1 * @since 1.0.1
* @deprecated 2.1 * @deprecated 2.1.0
* @deprecated Use get_bookmarks() * @deprecated Use get_bookmarks()
* @see get_bookmarks() * @see get_bookmarks()
* *
@ -540,7 +540,7 @@ function get_linkobjects($category = 0, $orderby = 'name', $limit = 0) {
* Gets the links associated with category 'cat_name' and display rating stars/chars. * Gets the links associated with category 'cat_name' and display rating stars/chars.
* *
* @since 0.71 * @since 0.71
* @deprecated 2.1 * @deprecated 2.1.0
* @deprecated Use get_bookmarks() * @deprecated Use get_bookmarks()
* @see get_bookmarks() * @see get_bookmarks()
* *
@ -568,7 +568,7 @@ function get_linksbyname_withrating($cat_name = "noname", $before = '', $after =
* Gets the links associated with category n and display rating stars/chars. * Gets the links associated with category n and display rating stars/chars.
* *
* @since 0.71 * @since 0.71
* @deprecated 2.1 * @deprecated 2.1.0
* @deprecated Use get_bookmarks() * @deprecated Use get_bookmarks()
* @see get_bookmarks() * @see get_bookmarks()
* *
@ -596,7 +596,7 @@ function get_links_withrating($category = -1, $before = '', $after = '<br />', $
* Gets the auto_toggle setting. * Gets the auto_toggle setting.
* *
* @since 0.71 * @since 0.71
* @deprecated 2.1 * @deprecated 2.1.0
* @deprecated No alternative function available * @deprecated No alternative function available
* *
* @param int $id The category to get. If no category supplied uses 0 * @param int $id The category to get. If no category supplied uses 0
@ -609,7 +609,7 @@ function get_autotoggle($id = 0) {
/** /**
* @since 0.71 * @since 0.71
* @deprecated 2.1 * @deprecated 2.1.0
* @deprecated Use wp_list_categories() * @deprecated Use wp_list_categories()
* @see wp_list_categories() * @see wp_list_categories()
* *
@ -644,8 +644,8 @@ function list_cats($optionall = 1, $all = 'All', $sort_column = 'ID', $sort_orde
} }
/** /**
* @since 1.2 * @since 1.2.0
* @deprecated 2.1 * @deprecated 2.1.0
* @deprecated Use wp_list_categories() * @deprecated Use wp_list_categories()
* @see wp_list_categories() * @see wp_list_categories()
* *
@ -677,7 +677,7 @@ function wp_list_cats($args = '') {
/** /**
* @since 0.71 * @since 0.71
* @deprecated 2.1 * @deprecated 2.1.0
* @deprecated Use wp_dropdown_categories() * @deprecated Use wp_dropdown_categories()
* @see wp_dropdown_categories() * @see wp_dropdown_categories()
* *
@ -713,8 +713,10 @@ function dropdown_cats($optionall = 1, $all = 'All', $orderby = 'ID', $order = '
} }
/** /**
* @since 1.2 * List authors.
* @deprecated 2.1 *
* @since 1.2.0
* @deprecated 2.1.0
* @deprecated Use wp_list_authors() * @deprecated Use wp_list_authors()
* @see wp_list_authors() * @see wp_list_authors()
* *
@ -735,7 +737,7 @@ function list_authors($optioncount = false, $exclude_admin = true, $show_fullnam
/** /**
* @since 1.0.1 * @since 1.0.1
* @deprecated 2.1 * @deprecated 2.1.0
* @deprecated Use wp_get_post_categories() * @deprecated Use wp_get_post_categories()
* @see wp_get_post_categories() * @see wp_get_post_categories()
* *
@ -752,7 +754,7 @@ function wp_get_post_cats($blogid = '1', $post_ID = 0) {
* Sets the categories that the post id belongs to. * Sets the categories that the post id belongs to.
* *
* @since 1.0.1 * @since 1.0.1
* @deprecated 2.1 * @deprecated 2.1.0
* @deprecated Use wp_set_post_categories() * @deprecated Use wp_set_post_categories()
* @see wp_set_post_categories() * @see wp_set_post_categories()
* *
@ -768,7 +770,7 @@ function wp_set_post_cats($blogid = '1', $post_ID = 0, $post_categories = array(
/** /**
* @since 0.71 * @since 0.71
* @deprecated 2.1 * @deprecated 2.1.0
* @deprecated Use wp_get_archives() * @deprecated Use wp_get_archives()
* @see wp_get_archives() * @see wp_get_archives()
* *
@ -789,8 +791,8 @@ function get_archives($type='', $limit='', $format='html', $before = '', $after
/** /**
* Returns or Prints link to the author's posts. * Returns or Prints link to the author's posts.
* *
* @since 1.2 * @since 1.2.0
* @deprecated 2.1 * @deprecated 2.1.0
* @deprecated Use get_author_posts_url() * @deprecated Use get_author_posts_url()
* @see get_author_posts_url() * @see get_author_posts_url()
* *
@ -813,7 +815,7 @@ function get_author_link($echo, $author_id, $author_nicename = '') {
* Print list of pages based on arguments. * Print list of pages based on arguments.
* *
* @since 0.71 * @since 0.71
* @deprecated 2.1 * @deprecated 2.1.0
* @deprecated Use wp_link_pages() * @deprecated Use wp_link_pages()
* @see wp_link_pages() * @see wp_link_pages()
* *
@ -838,7 +840,7 @@ function link_pages($before='<br />', $after='<br />', $next_or_number='number',
* Get value based on option. * Get value based on option.
* *
* @since 0.71 * @since 0.71
* @deprecated 2.1 * @deprecated 2.1.0
* @deprecated Use get_option() * @deprecated Use get_option()
* @see get_option() * @see get_option()
* *
@ -855,7 +857,7 @@ function get_settings($option) {
* Print the permalink of the current post in the loop. * Print the permalink of the current post in the loop.
* *
* @since 0.71 * @since 0.71
* @deprecated 1.2 * @deprecated 1.2.0
* @deprecated Use the_permalink() * @deprecated Use the_permalink()
* @see the_permalink() * @see the_permalink()
*/ */
@ -868,7 +870,7 @@ function permalink_link() {
* Print the permalink to the RSS feed. * Print the permalink to the RSS feed.
* *
* @since 0.71 * @since 0.71
* @deprecated 2.3 * @deprecated 2.3.0
* @deprecated Use the_permalink_rss() * @deprecated Use the_permalink_rss()
* @see the_permalink_rss() * @see the_permalink_rss()
* *
@ -884,7 +886,7 @@ function permalink_single_rss($deprecated = '') {
* *
* @see get_links() for argument information that can be used in $args * @see get_links() for argument information that can be used in $args
* @since 1.0.1 * @since 1.0.1
* @deprecated 2.1 * @deprecated 2.1.0
* @deprecated Use wp_list_bookmarks() * @deprecated Use wp_list_bookmarks()
* @see wp_list_bookmarks() * @see wp_list_bookmarks()
* *
@ -924,7 +926,7 @@ function wp_get_links($args = '') {
* Gets the links associated with category by id. * Gets the links associated with category by id.
* *
* @since 0.71 * @since 0.71
* @deprecated 2.1 * @deprecated 2.1.0
* @deprecated Use get_bookmarks() * @deprecated Use get_bookmarks()
* @see get_bookmarks() * @see get_bookmarks()
* *
@ -1033,7 +1035,7 @@ function get_links($category = -1, $before = '', $after = '<br />', $between = '
* $wpdb->linkcategories and output it as a nested HTML unordered list. * $wpdb->linkcategories and output it as a nested HTML unordered list.
* *
* @since 1.0.1 * @since 1.0.1
* @deprecated 2.1 * @deprecated 2.1.0
* @deprecated Use wp_list_bookmarks() * @deprecated Use wp_list_bookmarks()
* @see wp_list_bookmarks() * @see wp_list_bookmarks()
* *
@ -1076,7 +1078,7 @@ function get_links_list($order = 'name') {
* Show the link to the links popup and the number of links. * Show the link to the links popup and the number of links.
* *
* @since 0.71 * @since 0.71
* @deprecated 2.1 * @deprecated 2.1.0
* @deprecated {@internal Use function instead is unknown}} * @deprecated {@internal Use function instead is unknown}}
* *
* @param string $text the text of the link * @param string $text the text of the link
@ -1091,7 +1093,7 @@ function links_popup_script($text = 'Links', $width=400, $height=400, $file='lin
/** /**
* @since 1.0.1 * @since 1.0.1
* @deprecated 2.1 * @deprecated 2.1.0
* @deprecated Use sanitize_bookmark_field() * @deprecated Use sanitize_bookmark_field()
* @see sanitize_bookmark_field() * @see sanitize_bookmark_field()
* *
@ -1107,7 +1109,7 @@ function get_linkrating($link) {
* Gets the name of category by id. * Gets the name of category by id.
* *
* @since 0.71 * @since 0.71
* @deprecated 2.1 * @deprecated 2.1.0
* @deprecated Use get_category() * @deprecated Use get_category()
* @see get_category() * @see get_category()
* *
@ -1137,7 +1139,7 @@ function get_linkcatname($id = 0) {
* Print RSS comment feed link. * Print RSS comment feed link.
* *
* @since 1.0.1 * @since 1.0.1
* @deprecated 2.5 * @deprecated 2.5.0
* @deprecated Use post_comments_feed_link() * @deprecated Use post_comments_feed_link()
* @see post_comments_feed_link() * @see post_comments_feed_link()
* *
@ -1151,8 +1153,8 @@ function comments_rss_link($link_text = 'Comments RSS') {
/** /**
* Print/Return link to category RSS2 feed. * Print/Return link to category RSS2 feed.
* *
* @since 1.2 * @since 1.2.0
* @deprecated 2.5 * @deprecated 2.5.0
* @deprecated Use get_category_feed_link() * @deprecated Use get_category_feed_link()
* @see get_category_feed_link() * @see get_category_feed_link()
* *
@ -1173,8 +1175,8 @@ function get_category_rss_link($echo = false, $cat_ID = 1) {
/** /**
* Print/Return link to author RSS feed. * Print/Return link to author RSS feed.
* *
* @since 1.2 * @since 1.2.0
* @deprecated 2.5 * @deprecated 2.5.0
* @deprecated Use get_author_feed_link() * @deprecated Use get_author_feed_link()
* @see get_author_feed_link() * @see get_author_feed_link()
* *
@ -1194,8 +1196,8 @@ function get_author_rss_link($echo = false, $author_id = 1) {
/** /**
* Return link to the post RSS feed. * Return link to the post RSS feed.
* *
* @since 1.5 * @since 1.5.0
* @deprecated 2.2 * @deprecated 2.2.0
* @deprecated Use get_post_comments_feed_link() * @deprecated Use get_post_comments_feed_link()
* @see get_post_comments_feed_link() * @see get_post_comments_feed_link()
* *
@ -1209,8 +1211,8 @@ function comments_rss() {
/** /**
* An alias of wp_create_user(). * An alias of wp_create_user().
* *
* @since 2.0 * @since 2.0.0
* @deprecated 2.0 * @deprecated 2.0.0
* @deprecated Use wp_create_user() * @deprecated Use wp_create_user()
* @see wp_create_user() * @see wp_create_user()
* *
@ -1227,7 +1229,7 @@ function create_user($username, $password, $email) {
/** /**
* Unused function. * Unused function.
* *
* @deprecated 2.5 * @deprecated 2.5.0
*/ */
function gzip_compression() { function gzip_compression() {
_deprecated_function( __FUNCTION__, '2.5' ); _deprecated_function( __FUNCTION__, '2.5' );
@ -1238,7 +1240,7 @@ function gzip_compression() {
* Retrieve an array of comment data about comment $comment_ID. * Retrieve an array of comment data about comment $comment_ID.
* *
* @since 0.71 * @since 0.71
* @deprecated 2.7 * @deprecated 2.7.0
* @deprecated Use get_comment() * @deprecated Use get_comment()
* @see get_comment() * @see get_comment()
* *
@ -1256,7 +1258,7 @@ function get_commentdata( $comment_ID, $no_cache = 0, $include_unapproved = fals
* Retrieve the category name by the category ID. * Retrieve the category name by the category ID.
* *
* @since 0.71 * @since 0.71
* @deprecated 2.8 * @deprecated 2.8.0
* @deprecated Use get_cat_name() * @deprecated Use get_cat_name()
* @see get_cat_name() * @see get_cat_name()
* *
@ -1272,7 +1274,7 @@ function get_catname( $cat_ID ) {
* Retrieve category children list separated before and after the term IDs. * Retrieve category children list separated before and after the term IDs.
* *
* @since 1.2.0 * @since 1.2.0
* @deprecated 2.8 * @deprecated 2.8.0
* @deprecated Use get_term_children() * @deprecated Use get_term_children()
* @see get_term_children() * @see get_term_children()
* *
@ -1309,8 +1311,8 @@ function get_category_children( $id, $before = '/', $after = '', $visited = arra
/** /**
* Retrieve the description of the author of the current post. * Retrieve the description of the author of the current post.
* *
* @since 1.5 * @since 1.5.0
* @deprecated 2.8 * @deprecated 2.8.0
* @deprecated Use get_the_author_meta('description') * @deprecated Use get_the_author_meta('description')
* @see get_the_author_meta() * @see get_the_author_meta()
* *
@ -1325,7 +1327,7 @@ function get_the_author_description() {
* Display the description of the author of the current post. * Display the description of the author of the current post.
* *
* @since 1.0.0 * @since 1.0.0
* @deprecated 2.8 * @deprecated 2.8.0
* @deprecated Use the_author_meta('description') * @deprecated Use the_author_meta('description')
* @see the_author_meta() * @see the_author_meta()
*/ */
@ -1337,8 +1339,8 @@ function the_author_description() {
/** /**
* Retrieve the login name of the author of the current post. * Retrieve the login name of the author of the current post.
* *
* @since 1.5 * @since 1.5.0
* @deprecated 2.8 * @deprecated 2.8.0
* @deprecated Use get_the_author_meta('login') * @deprecated Use get_the_author_meta('login')
* @see get_the_author_meta() * @see get_the_author_meta()
* *
@ -1353,7 +1355,7 @@ function get_the_author_login() {
* Display the login name of the author of the current post. * Display the login name of the author of the current post.
* *
* @since 0.71 * @since 0.71
* @deprecated 2.8 * @deprecated 2.8.0
* @deprecated Use the_author_meta('login') * @deprecated Use the_author_meta('login')
* @see the_author_meta() * @see the_author_meta()
*/ */
@ -1365,8 +1367,8 @@ function the_author_login() {
/** /**
* Retrieve the first name of the author of the current post. * Retrieve the first name of the author of the current post.
* *
* @since 1.5 * @since 1.5.0
* @deprecated 2.8 * @deprecated 2.8.0
* @deprecated Use get_the_author_meta('first_name') * @deprecated Use get_the_author_meta('first_name')
* @see get_the_author_meta() * @see get_the_author_meta()
* *
@ -1381,7 +1383,7 @@ function get_the_author_firstname() {
* Display the first name of the author of the current post. * Display the first name of the author of the current post.
* *
* @since 0.71 * @since 0.71
* @deprecated 2.8 * @deprecated 2.8.0
* @deprecated Use the_author_meta('first_name') * @deprecated Use the_author_meta('first_name')
* @see the_author_meta() * @see the_author_meta()
*/ */
@ -1393,8 +1395,8 @@ function the_author_firstname() {
/** /**
* Retrieve the last name of the author of the current post. * Retrieve the last name of the author of the current post.
* *
* @since 1.5 * @since 1.5.0
* @deprecated 2.8 * @deprecated 2.8.0
* @deprecated Use get_the_author_meta('last_name') * @deprecated Use get_the_author_meta('last_name')
* @see get_the_author_meta() * @see get_the_author_meta()
* *
@ -1409,7 +1411,7 @@ function get_the_author_lastname() {
* Display the last name of the author of the current post. * Display the last name of the author of the current post.
* *
* @since 0.71 * @since 0.71
* @deprecated 2.8 * @deprecated 2.8.0
* @deprecated Use the_author_meta('last_name') * @deprecated Use the_author_meta('last_name')
* @see the_author_meta() * @see the_author_meta()
*/ */
@ -1421,8 +1423,8 @@ function the_author_lastname() {
/** /**
* Retrieve the nickname of the author of the current post. * Retrieve the nickname of the author of the current post.
* *
* @since 1.5 * @since 1.5.0
* @deprecated 2.8 * @deprecated 2.8.0
* @deprecated Use get_the_author_meta('nickname') * @deprecated Use get_the_author_meta('nickname')
* @see get_the_author_meta() * @see get_the_author_meta()
* *
@ -1437,7 +1439,7 @@ function get_the_author_nickname() {
* Display the nickname of the author of the current post. * Display the nickname of the author of the current post.
* *
* @since 0.71 * @since 0.71
* @deprecated 2.8 * @deprecated 2.8.0
* @deprecated Use the_author_meta('nickname') * @deprecated Use the_author_meta('nickname')
* @see the_author_meta() * @see the_author_meta()
*/ */
@ -1449,8 +1451,8 @@ function the_author_nickname() {
/** /**
* Retrieve the email of the author of the current post. * Retrieve the email of the author of the current post.
* *
* @since 1.5 * @since 1.5.0
* @deprecated 2.8 * @deprecated 2.8.0
* @deprecated Use get_the_author_meta('email') * @deprecated Use get_the_author_meta('email')
* @see get_the_author_meta() * @see get_the_author_meta()
* *
@ -1465,7 +1467,7 @@ function get_the_author_email() {
* Display the email of the author of the current post. * Display the email of the author of the current post.
* *
* @since 0.71 * @since 0.71
* @deprecated 2.8 * @deprecated 2.8.0
* @deprecated Use the_author_meta('email') * @deprecated Use the_author_meta('email')
* @see the_author_meta() * @see the_author_meta()
*/ */
@ -1477,8 +1479,8 @@ function the_author_email() {
/** /**
* Retrieve the ICQ number of the author of the current post. * Retrieve the ICQ number of the author of the current post.
* *
* @since 1.5 * @since 1.5.0
* @deprecated 2.8 * @deprecated 2.8.0
* @deprecated Use get_the_author_meta('icq') * @deprecated Use get_the_author_meta('icq')
* @see get_the_author_meta() * @see get_the_author_meta()
* *
@ -1493,7 +1495,7 @@ function get_the_author_icq() {
* Display the ICQ number of the author of the current post. * Display the ICQ number of the author of the current post.
* *
* @since 0.71 * @since 0.71
* @deprecated 2.8 * @deprecated 2.8.0
* @deprecated Use the_author_meta('icq') * @deprecated Use the_author_meta('icq')
* @see the_author_meta() * @see the_author_meta()
*/ */
@ -1505,8 +1507,8 @@ function the_author_icq() {
/** /**
* Retrieve the Yahoo! IM name of the author of the current post. * Retrieve the Yahoo! IM name of the author of the current post.
* *
* @since 1.5 * @since 1.5.0
* @deprecated 2.8 * @deprecated 2.8.0
* @deprecated Use get_the_author_meta('yim') * @deprecated Use get_the_author_meta('yim')
* @see get_the_author_meta() * @see get_the_author_meta()
* *
@ -1521,7 +1523,7 @@ function get_the_author_yim() {
* Display the Yahoo! IM name of the author of the current post. * Display the Yahoo! IM name of the author of the current post.
* *
* @since 0.71 * @since 0.71
* @deprecated 2.8 * @deprecated 2.8.0
* @deprecated Use the_author_meta('yim') * @deprecated Use the_author_meta('yim')
* @see the_author_meta() * @see the_author_meta()
*/ */
@ -1533,8 +1535,8 @@ function the_author_yim() {
/** /**
* Retrieve the MSN address of the author of the current post. * Retrieve the MSN address of the author of the current post.
* *
* @since 1.5 * @since 1.5.0
* @deprecated 2.8 * @deprecated 2.8.0
* @deprecated Use get_the_author_meta('msn') * @deprecated Use get_the_author_meta('msn')
* @see get_the_author_meta() * @see get_the_author_meta()
* *
@ -1549,7 +1551,7 @@ function get_the_author_msn() {
* Display the MSN address of the author of the current post. * Display the MSN address of the author of the current post.
* *
* @since 0.71 * @since 0.71
* @deprecated 2.8 * @deprecated 2.8.0
* @deprecated Use the_author_meta('msn') * @deprecated Use the_author_meta('msn')
* @see the_author_meta() * @see the_author_meta()
*/ */
@ -1561,8 +1563,8 @@ function the_author_msn() {
/** /**
* Retrieve the AIM address of the author of the current post. * Retrieve the AIM address of the author of the current post.
* *
* @since 1.5 * @since 1.5.0
* @deprecated 2.8 * @deprecated 2.8.0
* @deprecated Use get_the_author_meta('aim') * @deprecated Use get_the_author_meta('aim')
* @see get_the_author_meta() * @see get_the_author_meta()
* *
@ -1578,7 +1580,7 @@ function get_the_author_aim() {
* *
* @since 0.71 * @since 0.71
* @see the_author_meta() * @see the_author_meta()
* @deprecated 2.8 * @deprecated 2.8.0
* @deprecated Use the_author_meta('aim') * @deprecated Use the_author_meta('aim')
*/ */
function the_author_aim() { function the_author_aim() {
@ -1590,7 +1592,7 @@ function the_author_aim() {
* Retrieve the specified author's preferred display name. * Retrieve the specified author's preferred display name.
* *
* @since 1.0.0 * @since 1.0.0
* @deprecated 2.8 * @deprecated 2.8.0
* @deprecated Use get_the_author_meta('display_name') * @deprecated Use get_the_author_meta('display_name')
* @see get_the_author_meta() * @see get_the_author_meta()
* *
@ -1605,8 +1607,8 @@ function get_author_name( $auth_id = false ) {
/** /**
* Retrieve the URL to the home page of the author of the current post. * Retrieve the URL to the home page of the author of the current post.
* *
* @since 1.5 * @since 1.5.0
* @deprecated 2.8 * @deprecated 2.8.0
* @deprecated Use get_the_author_meta('url') * @deprecated Use get_the_author_meta('url')
* @see get_the_author_meta() * @see get_the_author_meta()
* *
@ -1621,7 +1623,7 @@ function get_the_author_url() {
* Display the URL to the home page of the author of the current post. * Display the URL to the home page of the author of the current post.
* *
* @since 0.71 * @since 0.71
* @deprecated 2.8 * @deprecated 2.8.0
* @deprecated Use the_author_meta('url') * @deprecated Use the_author_meta('url')
* @see the_author_meta() * @see the_author_meta()
*/ */
@ -1633,8 +1635,8 @@ function the_author_url() {
/** /**
* Retrieve the ID of the author of the current post. * Retrieve the ID of the author of the current post.
* *
* @since 1.5 * @since 1.5.0
* @deprecated 2.8 * @deprecated 2.8.0
* @deprecated Use get_the_author_meta('ID') * @deprecated Use get_the_author_meta('ID')
* @see get_the_author_meta() * @see get_the_author_meta()
* *
@ -1649,7 +1651,7 @@ function get_the_author_ID() {
* Display the ID of the author of the current post. * Display the ID of the author of the current post.
* *
* @since 0.71 * @since 0.71
* @deprecated 2.8 * @deprecated 2.8.0
* @deprecated Use the_author_meta('ID') * @deprecated Use the_author_meta('ID')
* @see the_author_meta() * @see the_author_meta()
*/ */
@ -1785,7 +1787,7 @@ function _c( $text, $domain = 'default' ) {
* Translates $text like translate(), but assumes that the text * Translates $text like translate(), but assumes that the text
* contains a context after its last vertical bar. * contains a context after its last vertical bar.
* *
* @since 2.5 * @since 2.5.0
* @uses translate() * @uses translate()
* @deprecated 3.0.0 * @deprecated 3.0.0
* @deprecated Use _x() * @deprecated Use _x()
@ -1834,7 +1836,7 @@ function __ngettext() {
/** /**
* Register plural strings in POT file, but don't translate them. * Register plural strings in POT file, but don't translate them.
* *
* @since 2.5 * @since 2.5.0
* @deprecated 2.8.0 * @deprecated 2.8.0
* @deprecated Use _n_noop() * @deprecated Use _n_noop()
* @see _n_noop() * @see _n_noop()

8
wp-includes/feed.php
View File

@ -57,7 +57,7 @@ function bloginfo_rss($show = '') {
* *
* @package WordPress * @package WordPress
* @subpackage Feed * @subpackage Feed
* @since 2.5 * @since 2.5.0
* @uses apply_filters() Calls 'default_feed' hook on the default feed string. * @uses apply_filters() Calls 'default_feed' hook on the default feed string.
* *
* @return string Default feed, or for example 'rss2', 'atom', etc. * @return string Default feed, or for example 'rss2', 'atom', etc.
@ -446,7 +446,7 @@ function atom_enclosure() {
* *
* @package WordPress * @package WordPress
* @subpackage Feed * @subpackage Feed
* @since 2.5 * @since 2.5.0
* *
* @param string $data Input string * @param string $data Input string
* @return array array(type, value) * @return array array(type, value)
@ -484,7 +484,7 @@ function prep_atom_text_construct($data) {
* *
* @package WordPress * @package WordPress
* @subpackage Feed * @subpackage Feed
* @since 2.5 * @since 2.5.0
*/ */
function self_link() { function self_link() {
$host = @parse_url(home_url()); $host = @parse_url(home_url());
@ -518,7 +518,7 @@ function feed_content_type( $type = '' ) {
/** /**
* Build SimplePie object based on RSS or Atom feed from URL. * Build SimplePie object based on RSS or Atom feed from URL.
* *
* @since 2.8 * @since 2.8.0
* *
* @param mixed $url URL of feed to retrieve. If an array of URLs, the feeds are merged * @param mixed $url URL of feed to retrieve. If an array of URLs, the feeds are merged
* using SimplePie's multifeed feature. * using SimplePie's multifeed feature.

4
wp-includes/link-template.php
View File

@ -578,7 +578,7 @@ function get_category_feed_link($cat_id, $feed = '') {
* Returns a link to the feed for all posts in a given term. A specific feed * Returns a link to the feed for all posts in a given term. A specific feed
* can be requested or left blank to get the default feed. * can be requested or left blank to get the default feed.
* *
* @since 3.0 * @since 3.0.0
* *
* @param int $term_id ID of a category. * @param int $term_id ID of a category.
* @param string $taxonomy Optional. Taxonomy of $term_id * @param string $taxonomy Optional. Taxonomy of $term_id
@ -1711,7 +1711,7 @@ function previous_posts_link( $label = null ) {
/** /**
* Return post pages link navigation for previous and next pages. * Return post pages link navigation for previous and next pages.
* *
* @since 2.8 * @since 2.8.0
* *
* @param string|array $args Optional args. * @param string|array $args Optional args.
* @return string The posts link navigation. * @return string The posts link navigation.

2
wp-includes/nav-menu-template.php
View File

@ -385,7 +385,7 @@ function wp_nav_menu( $args = array() ) {
* Add the class property classes for the current context, if applicable. * Add the class property classes for the current context, if applicable.
* *
* @access private * @access private
* @since 3.0 * @since 3.0.0
* *
* @param array $menu_items The current menu item objects to which to add the class property information. * @param array $menu_items The current menu item objects to which to add the class property information.
*/ */

12
wp-includes/pluggable-deprecated.php
View File

@ -57,7 +57,7 @@ if ( !function_exists('get_user_by_email') ) :
/** /**
* Retrieve user info by email. * Retrieve user info by email.
* *
* @since 2.5 * @since 2.5.0
* @deprecated 3.3.0 * @deprecated 3.3.0
* @deprecated Use get_user_by('email') * @deprecated Use get_user_by('email')
* *
@ -74,8 +74,8 @@ if ( !function_exists('wp_setcookie') ) :
/** /**
* Sets a cookie for a user who just logged in. This function is deprecated. * Sets a cookie for a user who just logged in. This function is deprecated.
* *
* @since 1.5 * @since 1.5.0
* @deprecated 2.5 * @deprecated 2.5.0
* @deprecated Use wp_set_auth_cookie() * @deprecated Use wp_set_auth_cookie()
* @see wp_set_auth_cookie() * @see wp_set_auth_cookie()
* *
@ -99,8 +99,8 @@ if ( !function_exists('wp_clearcookie') ) :
/** /**
* Clears the authentication cookie, logging the user out. This function is deprecated. * Clears the authentication cookie, logging the user out. This function is deprecated.
* *
* @since 1.5 * @since 1.5.0
* @deprecated 2.5 * @deprecated 2.5.0
* @deprecated Use wp_clear_auth_cookie() * @deprecated Use wp_clear_auth_cookie()
* @see wp_clear_auth_cookie() * @see wp_clear_auth_cookie()
*/ */
@ -120,7 +120,7 @@ if ( !function_exists('wp_get_cookie_login') ):
* used anywhere in WordPress. Also, plugins shouldn't use it either. * used anywhere in WordPress. Also, plugins shouldn't use it either.
* *
* @since 2.0.3 * @since 2.0.3
* @deprecated 2.5 * @deprecated 2.5.0
* @deprecated No alternative * @deprecated No alternative
* *
* @return bool Always returns false * @return bool Always returns false

46
wp-includes/pluggable.php
View File

@ -506,7 +506,7 @@ if ( !function_exists('wp_validate_auth_cookie') ) :
* Makes sure the cookie is not expired. Verifies the hash in cookie is what is * Makes sure the cookie is not expired. Verifies the hash in cookie is what is
* should be and compares the two. * should be and compares the two.
* *
* @since 2.5 * @since 2.5.0
* *
* @param string $cookie Optional. If used, will validate contents instead of cookie's * @param string $cookie Optional. If used, will validate contents instead of cookie's
* @param string $scheme Optional. The cookie scheme to use: auth, secure_auth, or logged_in * @param string $scheme Optional. The cookie scheme to use: auth, secure_auth, or logged_in
@ -561,7 +561,8 @@ if ( !function_exists('wp_generate_auth_cookie') ) :
/** /**
* Generate authentication cookie contents. * Generate authentication cookie contents.
* *
* @since 2.5 * @since 2.5.0
*
* @uses apply_filters() Calls 'auth_cookie' hook on $cookie contents, User ID * @uses apply_filters() Calls 'auth_cookie' hook on $cookie contents, User ID
* and expiration of cookie. * and expiration of cookie.
* *
@ -588,7 +589,7 @@ if ( !function_exists('wp_parse_auth_cookie') ) :
/** /**
* Parse a cookie into its components * Parse a cookie into its components
* *
* @since 2.7 * @since 2.7.0
* *
* @param string $cookie * @param string $cookie
* @param string $scheme Optional. The cookie scheme to use: auth, secure_auth, or logged_in * @param string $scheme Optional. The cookie scheme to use: auth, secure_auth, or logged_in
@ -639,7 +640,7 @@ if ( !function_exists('wp_set_auth_cookie') ) :
* default the cookie is kept without remembering is two days. When $remember is * default the cookie is kept without remembering is two days. When $remember is
* set, the cookies will be kept for 14 days or two weeks. * set, the cookies will be kept for 14 days or two weeks.
* *
* @since 2.5 * @since 2.5.0
* *
* @param int $user_id User ID * @param int $user_id User ID
* @param bool $remember Whether to remember the user * @param bool $remember Whether to remember the user
@ -687,7 +688,7 @@ if ( !function_exists('wp_clear_auth_cookie') ) :
/** /**
* Removes all of the cookies associated with authentication. * Removes all of the cookies associated with authentication.
* *
* @since 2.5 * @since 2.5.0
*/ */
function wp_clear_auth_cookie() { function wp_clear_auth_cookie() {
do_action('clear_auth_cookie'); do_action('clear_auth_cookie');
@ -735,7 +736,7 @@ if ( !function_exists('auth_redirect') ) :
/** /**
* Checks if a user is logged in, if not it redirects them to the login page. * Checks if a user is logged in, if not it redirects them to the login page.
* *
* @since 1.5 * @since 1.5.0
*/ */
function auth_redirect() { function auth_redirect() {
// Checks if a user is logged in, if not redirects them to the login page // Checks if a user is logged in, if not redirects them to the login page
@ -903,7 +904,7 @@ if ( !function_exists('wp_sanitize_redirect') ) :
/** /**
* Sanitizes a URL for use in a redirect. * Sanitizes a URL for use in a redirect.
* *
* @since 2.3 * @since 2.3.0
* *
* @return string redirect-sanitized URL * @return string redirect-sanitized URL
**/ **/
@ -930,7 +931,8 @@ if ( !function_exists('wp_safe_redirect') ) :
* instead. This prevents malicious redirects which redirect to another host, * instead. This prevents malicious redirects which redirect to another host,
* but only used in a few places. * but only used in a few places.
* *
* @since 2.3 * @since 2.3.0
*
* @uses wp_validate_redirect() To validate the redirect is to an allowed host. * @uses wp_validate_redirect() To validate the redirect is to an allowed host.
* *
* @return void Does not return anything * @return void Does not return anything
@ -1165,7 +1167,8 @@ if ( !function_exists('wp_notify_moderator') ) :
/** /**
* Notifies the moderator of the blog about a new comment that is awaiting approval. * Notifies the moderator of the blog about a new comment that is awaiting approval.
* *
* @since 1.0 * @since 1.0.0
*
* @uses $wpdb * @uses $wpdb
* *
* @param int $comment_id Comment ID * @param int $comment_id Comment ID
@ -1251,7 +1254,7 @@ if ( !function_exists('wp_password_change_notification') ) :
/** /**
* Notify the blog admin of a user changing password, normally via email. * Notify the blog admin of a user changing password, normally via email.
* *
* @since 2.7 * @since 2.7.0
* *
* @param object $user User Object * @param object $user User Object
*/ */
@ -1272,7 +1275,7 @@ if ( !function_exists('wp_new_user_notification') ) :
/** /**
* Notify the blog admin of a new user, normally via email. * Notify the blog admin of a new user, normally via email.
* *
* @since 2.0 * @since 2.0.0
* *
* @param int $user_id User ID * @param int $user_id User ID
* @param string $plaintext_pass Optional. The user's plaintext password * @param string $plaintext_pass Optional. The user's plaintext password
@ -1309,7 +1312,7 @@ if ( !function_exists('wp_nonce_tick') ) :
* A nonce has a lifespan of two ticks. Nonces in their second tick may be * A nonce has a lifespan of two ticks. Nonces in their second tick may be
* updated, e.g. by autosave. * updated, e.g. by autosave.
* *
* @since 2.5 * @since 2.5.0
* *
* @return int * @return int
*/ */
@ -1401,7 +1404,7 @@ if ( !function_exists('wp_salt') ) :
* Salting passwords helps against tools which has stored hashed values of * Salting passwords helps against tools which has stored hashed values of
* common dictionary strings. The added values makes it harder to crack. * common dictionary strings. The added values makes it harder to crack.
* *
* @since 2.5 * @since 2.5.0
* *
* @link https://api.wordpress.org/secret-key/1.1/salt/ Create secrets for wp-config.php * @link https://api.wordpress.org/secret-key/1.1/salt/ Create secrets for wp-config.php
* *
@ -1485,7 +1488,8 @@ if ( !function_exists('wp_hash_password') ) :
* For integration with other applications, this function can be overwritten to * For integration with other applications, this function can be overwritten to
* instead use the other package password checking algorithm. * instead use the other package password checking algorithm.
* *
* @since 2.5 * @since 2.5.0
*
* @global object $wp_hasher PHPass object * @global object $wp_hasher PHPass object
* @uses PasswordHash::HashPassword * @uses PasswordHash::HashPassword
* *
@ -1517,7 +1521,8 @@ if ( !function_exists('wp_check_password') ) :
* For integration with other applications, this function can be overwritten to * For integration with other applications, this function can be overwritten to
* instead use the other package password checking algorithm. * instead use the other package password checking algorithm.
* *
* @since 2.5 * @since 2.5.0
*
* @global object $wp_hasher PHPass object used for checking the password * @global object $wp_hasher PHPass object used for checking the password
* against the $hash + $password * against the $hash + $password
* @uses PasswordHash::CheckPassword * @uses PasswordHash::CheckPassword
@ -1559,7 +1564,7 @@ if ( !function_exists('wp_generate_password') ) :
/** /**
* Generates a random password drawn from the defined set of characters. * Generates a random password drawn from the defined set of characters.
* *
* @since 2.5 * @since 2.5.0
* *
* @param int $length The length of password to generate * @param int $length The length of password to generate
* @param bool $special_chars Whether to include standard special characters. Default true. * @param bool $special_chars Whether to include standard special characters. Default true.
@ -1638,7 +1643,8 @@ if ( !function_exists('wp_set_password') ) :
* For integration with other applications, this function can be overwritten to * For integration with other applications, this function can be overwritten to
* instead use the other package password checking algorithm. * instead use the other package password checking algorithm.
* *
* @since 2.5 * @since 2.5.0
*
* @uses $wpdb WordPress database object for queries * @uses $wpdb WordPress database object for queries
* @uses wp_hash_password() Used to encrypt the user's password before passing to the database * @uses wp_hash_password() Used to encrypt the user's password before passing to the database
* *
@ -1659,7 +1665,8 @@ if ( !function_exists( 'get_avatar' ) ) :
/** /**
* Retrieve the avatar for a user who provided a user ID or email address. * Retrieve the avatar for a user who provided a user ID or email address.
* *
* @since 2.5 * @since 2.5.0
*
* @param int|string|object $id_or_email A user ID, email address, or comment object * @param int|string|object $id_or_email A user ID, email address, or comment object
* @param int $size Size of the avatar image * @param int $size Size of the avatar image
* @param string $default URL to a default image to use if no avatar is available * @param string $default URL to a default image to use if no avatar is available
@ -1773,7 +1780,8 @@ if ( !function_exists( 'wp_text_diff' ) ) :
* 'title_right' : Default is an empty string. Change the HTML to the right of * 'title_right' : Default is an empty string. Change the HTML to the right of
* the title. * the title.
* *
* @since 2.6 * @since 2.6.0
*
* @see wp_parse_args() Used to change defaults to user defined settings. * @see wp_parse_args() Used to change defaults to user defined settings.
* @uses Text_Diff * @uses Text_Diff
* @uses WP_Text_Diff_Renderer_Table * @uses WP_Text_Diff_Renderer_Table

48
wp-includes/plugin.php
View File

@ -16,7 +16,7 @@
* *
* @package WordPress * @package WordPress
* @subpackage Plugin * @subpackage Plugin
* @since 1.5 * @since 1.5.0
*/ */
// Initialize the filter globals. // Initialize the filter globals.
@ -93,7 +93,8 @@ function add_filter( $tag, $function_to_add, $priority = 10, $accepted_args = 1
* *
* @package WordPress * @package WordPress
* @subpackage Plugin * @subpackage Plugin
* @since 2.5 * @since 2.5.0
*
* @global array $wp_filter Stores all of the filters * @global array $wp_filter Stores all of the filters
* *
* @param string $tag The name of the filter hook. * @param string $tag The name of the filter hook.
@ -275,7 +276,8 @@ function apply_filters_ref_array($tag, $args) {
* *
* @package WordPress * @package WordPress
* @subpackage Plugin * @subpackage Plugin
* @since 1.2 *
* @since 1.2.0
* *
* @param string $tag The filter hook to which the function to be removed is hooked. * @param string $tag The filter hook to which the function to be removed is hooked.
* @param callback $function_to_remove The name of the function which should be removed. * @param callback $function_to_remove The name of the function which should be removed.
@ -301,7 +303,7 @@ function remove_filter( $tag, $function_to_remove, $priority = 10 ) {
/** /**
* Remove all of the hooks from a filter. * Remove all of the hooks from a filter.
* *
* @since 2.7 * @since 2.7.0
* *
* @param string $tag The filter to remove hooks from. * @param string $tag The filter to remove hooks from.
* @param int $priority The priority number to remove. * @param int $priority The priority number to remove.
@ -328,7 +330,7 @@ function remove_all_filters($tag, $priority = false) {
* *
* @package WordPress * @package WordPress
* @subpackage Plugin * @subpackage Plugin
* @since 2.5 * @since 2.5.0
* *
* @return string Hook name of the current filter or action. * @return string Hook name of the current filter or action.
*/ */
@ -349,7 +351,8 @@ function current_filter() {
* *
* @package WordPress * @package WordPress
* @subpackage Plugin * @subpackage Plugin
* @since 1.2 *
* @since 1.2.0
* *
* @param string $tag The name of the action to which the $function_to_add is hooked. * @param string $tag The name of the action to which the $function_to_add is hooked.
* @param callback $function_to_add The name of the function you wish to be called. * @param callback $function_to_add The name of the function you wish to be called.
@ -375,7 +378,9 @@ function add_action($tag, $function_to_add, $priority = 10, $accepted_args = 1)
* *
* @package WordPress * @package WordPress
* @subpackage Plugin * @subpackage Plugin
* @since 1.2 *
* @since 1.2.0
*
* @global array $wp_filter Stores all of the filters * @global array $wp_filter Stores all of the filters
* @global array $wp_actions Increments the amount of times action was triggered. * @global array $wp_actions Increments the amount of times action was triggered.
* *
@ -438,7 +443,8 @@ function do_action($tag, $arg = '') {
* *
* @package WordPress * @package WordPress
* @subpackage Plugin * @subpackage Plugin
* @since 2.1 * @since 2.1.0
*
* @global array $wp_actions Increments the amount of times action was triggered. * @global array $wp_actions Increments the amount of times action was triggered.
* *
* @param string $tag The name of the action hook. * @param string $tag The name of the action hook.
@ -461,7 +467,8 @@ function did_action($tag) {
* *
* @package WordPress * @package WordPress
* @subpackage Plugin * @subpackage Plugin
* @since 2.1 * @since 2.1.0
*
* @global array $wp_filter Stores all of the filters * @global array $wp_filter Stores all of the filters
* @global array $wp_actions Increments the amount of times action was triggered. * @global array $wp_actions Increments the amount of times action was triggered.
* *
@ -516,7 +523,8 @@ function do_action_ref_array($tag, $args) {
* *
* @package WordPress * @package WordPress
* @subpackage Plugin * @subpackage Plugin
* @since 2.5 * @since 2.5.0
*
* @see has_filter() has_action() is an alias of has_filter(). * @see has_filter() has_action() is an alias of has_filter().
* *
* @param string $tag The name of the action hook. * @param string $tag The name of the action hook.
@ -539,7 +547,8 @@ function has_action($tag, $function_to_check = false) {
* *
* @package WordPress * @package WordPress
* @subpackage Plugin * @subpackage Plugin
* @since 1.2 *
* @since 1.2.0
* *
* @param string $tag The action hook to which the function to be removed is hooked. * @param string $tag The action hook to which the function to be removed is hooked.
* @param callback $function_to_remove The name of the function which should be removed. * @param callback $function_to_remove The name of the function which should be removed.
@ -553,7 +562,7 @@ function remove_action( $tag, $function_to_remove, $priority = 10 ) {
/** /**
* Remove all of the hooks from an action. * Remove all of the hooks from an action.
* *
* @since 2.7 * @since 2.7.0
* *
* @param string $tag The action to remove hooks from. * @param string $tag The action to remove hooks from.
* @param int $priority The priority number to remove them from. * @param int $priority The priority number to remove them from.
@ -574,7 +583,8 @@ function remove_all_actions($tag, $priority = false) {
* *
* @package WordPress * @package WordPress
* @subpackage Plugin * @subpackage Plugin
* @since 1.5 *
* @since 1.5.0
* *
* @access private * @access private
* *
@ -598,7 +608,7 @@ function plugin_basename($file) {
* Gets the filesystem directory path (with trailing slash) for the plugin __FILE__ passed in * Gets the filesystem directory path (with trailing slash) for the plugin __FILE__ passed in
* @package WordPress * @package WordPress
* @subpackage Plugin * @subpackage Plugin
* @since 2.8 * @since 2.8.0
* *
* @param string $file The filename of the plugin (__FILE__) * @param string $file The filename of the plugin (__FILE__)
* @return string the filesystem path of the directory that contains the plugin * @return string the filesystem path of the directory that contains the plugin
@ -611,7 +621,7 @@ function plugin_dir_path( $file ) {
* Gets the URL directory path (with trailing slash) for the plugin __FILE__ passed in * Gets the URL directory path (with trailing slash) for the plugin __FILE__ passed in
* @package WordPress * @package WordPress
* @subpackage Plugin * @subpackage Plugin
* @since 2.8 * @since 2.8.0
* *
* @param string $file The filename of the plugin (__FILE__) * @param string $file The filename of the plugin (__FILE__)
* @return string the URL path of the directory that contains the plugin * @return string the URL path of the directory that contains the plugin
@ -635,7 +645,7 @@ function plugin_dir_url( $file ) {
* *
* @package WordPress * @package WordPress
* @subpackage Plugin * @subpackage Plugin
* @since 2.0 * @since 2.0.0
* *
* @param string $file The filename of the plugin including the path. * @param string $file The filename of the plugin including the path.
* @param callback $function the function hooked to the 'activate_PLUGIN' action. * @param callback $function the function hooked to the 'activate_PLUGIN' action.
@ -660,7 +670,7 @@ function register_activation_hook($file, $function) {
* *
* @package WordPress * @package WordPress
* @subpackage Plugin * @subpackage Plugin
* @since 2.0 * @since 2.0.0
* *
* @param string $file The filename of the plugin including the path. * @param string $file The filename of the plugin including the path.
* @param callback $function the function hooked to the 'deactivate_PLUGIN' action. * @param callback $function the function hooked to the 'deactivate_PLUGIN' action.
@ -690,7 +700,7 @@ function register_deactivation_hook($file, $function) {
* should always check for the 'WP_UNINSTALL_PLUGIN' constant, before * should always check for the 'WP_UNINSTALL_PLUGIN' constant, before
* executing. * executing.
* *
* @since 2.7 * @since 2.7.0
* *
* @param string $file * @param string $file
* @param callback $callback The callback to run when the hook is called. Must be a static method or function. * @param callback $callback The callback to run when the hook is called. Must be a static method or function.
@ -722,7 +732,7 @@ function register_uninstall_hook( $file, $callback ) {
* *
* @package WordPress * @package WordPress
* @subpackage Plugin * @subpackage Plugin
* @since 2.5 * @since 2.5.0
* @access private * @access private
* *
* @uses $wp_filter Used to process all of the functions in the 'all' hook * @uses $wp_filter Used to process all of the functions in the 'all' hook

2
wp-includes/post-thumbnail-template.php
View File

@ -49,7 +49,7 @@ function the_post_thumbnail( $size = 'post-thumbnail', $attr = '' ) {
/** /**
* Update cache for thumbnails in the current loop * Update cache for thumbnails in the current loop
* *
* @since 3.2 * @since 3.2.0
* *
* @param object $wp_query Optional. A WP_Query instance. Defaults to the $wp_query global. * @param object $wp_query Optional. A WP_Query instance. Defaults to the $wp_query global.
*/ */

14
wp-includes/script-loader.php
View File

@ -714,7 +714,7 @@ function wp_style_loader_src( $src, $handle ) {
* Postpones the scripts that were queued for the footer. * Postpones the scripts that were queued for the footer.
* print_footer_scripts() is called in the footer to print these scripts. * print_footer_scripts() is called in the footer to print these scripts.
* *
* @since 2.8 * @since 2.8.0
* *
* @see wp_print_scripts() * @see wp_print_scripts()
*/ */
@ -743,7 +743,7 @@ function print_head_scripts() {
/** /**
* Prints the scripts that were queued for the footer or too late for the HTML head. * Prints the scripts that were queued for the footer or too late for the HTML head.
* *
* @since 2.8 * @since 2.8.0
*/ */
function print_footer_scripts() { function print_footer_scripts() {
global $wp_scripts, $concatenate_scripts; global $wp_scripts, $concatenate_scripts;
@ -799,7 +799,7 @@ function _print_scripts() {
* Postpones the scripts that were queued for the footer. * Postpones the scripts that were queued for the footer.
* wp_print_footer_scripts() is called in the footer to print these scripts. * wp_print_footer_scripts() is called in the footer to print these scripts.
* *
* @since 2.8 * @since 2.8.0
*/ */
function wp_print_head_scripts() { function wp_print_head_scripts() {
if ( ! did_action('wp_print_scripts') ) { if ( ! did_action('wp_print_scripts') ) {
@ -828,7 +828,7 @@ function _wp_footer_scripts() {
/** /**
* Hooks to print the scripts and styles in the footer. * Hooks to print the scripts and styles in the footer.
* *
* @since 2.8 * @since 2.8.0
*/ */
function wp_print_footer_scripts() { function wp_print_footer_scripts() {
do_action('wp_print_footer_scripts'); do_action('wp_print_footer_scripts');
@ -840,7 +840,7 @@ function wp_print_footer_scripts() {
* Allows plugins to queue scripts for the front end using wp_enqueue_script(). * Allows plugins to queue scripts for the front end using wp_enqueue_script().
* Runs first in wp_head() where all is_home(), is_page(), etc. functions are available. * Runs first in wp_head() where all is_home(), is_page(), etc. functions are available.
* *
* @since 2.8 * @since 2.8.0
*/ */
function wp_enqueue_scripts() { function wp_enqueue_scripts() {
do_action('wp_enqueue_scripts'); do_action('wp_enqueue_scripts');
@ -849,7 +849,7 @@ function wp_enqueue_scripts() {
/** /**
* Prints the styles queue in the HTML head on admin pages. * Prints the styles queue in the HTML head on admin pages.
* *
* @since 2.8 * @since 2.8.0
*/ */
function print_admin_styles() { function print_admin_styles() {
global $wp_styles, $concatenate_scripts, $compress_css; global $wp_styles, $concatenate_scripts, $compress_css;
@ -923,7 +923,7 @@ function _print_styles() {
/** /**
* Determine the concatenation and compression settings for scripts and styles. * Determine the concatenation and compression settings for scripts and styles.
* *
* @since 2.8 * @since 2.8.0
*/ */
function script_concat_settings() { function script_concat_settings() {
global $concatenate_scripts, $compress_scripts, $compress_css; global $concatenate_scripts, $compress_scripts, $compress_css;

29
wp-includes/shortcodes.php
View File

@ -29,13 +29,14 @@
* *
* @package WordPress * @package WordPress
* @subpackage Shortcodes * @subpackage Shortcodes
* @since 2.5 * @since 2.5.0
*/ */
/** /**
* Container for storing shortcode tags and their hook to call for the shortcode * Container for storing shortcode tags and their hook to call for the shortcode
* *
* @since 2.5 * @since 2.5.0
*
* @name $shortcode_tags * @name $shortcode_tags
* @var array * @var array
* @global array $shortcode_tags * @global array $shortcode_tags
@ -84,7 +85,8 @@ $shortcode_tags = array();
* add_shortcode('baztag', 'baztag_func'); * add_shortcode('baztag', 'baztag_func');
* </code> * </code>
* *
* @since 2.5 * @since 2.5.0
*
* @uses $shortcode_tags * @uses $shortcode_tags
* *
* @param string $tag Shortcode tag to be searched in post content. * @param string $tag Shortcode tag to be searched in post content.
@ -100,7 +102,8 @@ function add_shortcode($tag, $func) {
/** /**
* Removes hook for shortcode. * Removes hook for shortcode.
* *
* @since 2.5 * @since 2.5.0
*
* @uses $shortcode_tags * @uses $shortcode_tags
* *
* @param string $tag shortcode tag to remove hook for. * @param string $tag shortcode tag to remove hook for.
@ -118,7 +121,8 @@ function remove_shortcode($tag) {
* shortcodes global by a empty array. This is actually a very efficient method * shortcodes global by a empty array. This is actually a very efficient method
* for removing all shortcodes. * for removing all shortcodes.
* *
* @since 2.5 * @since 2.5.0
*
* @uses $shortcode_tags * @uses $shortcode_tags
*/ */
function remove_all_shortcodes() { function remove_all_shortcodes() {
@ -171,7 +175,8 @@ function has_shortcode( $content, $tag ) {
* without any filtering. This might cause issues when plugins are disabled but * without any filtering. This might cause issues when plugins are disabled but
* the shortcode will still show up in the post or content. * the shortcode will still show up in the post or content.
* *
* @since 2.5 * @since 2.5.0
*
* @uses $shortcode_tags * @uses $shortcode_tags
* @uses get_shortcode_regex() Gets the search pattern for searching shortcodes. * @uses get_shortcode_regex() Gets the search pattern for searching shortcodes.
* *
@ -203,7 +208,8 @@ function do_shortcode($content) {
* 5 - The content of a shortcode when it wraps some content. * 5 - The content of a shortcode when it wraps some content.
* 6 - An extra ] to allow for escaping shortcodes with double [[]] * 6 - An extra ] to allow for escaping shortcodes with double [[]]
* *
* @since 2.5 * @since 2.5.0
*
* @uses $shortcode_tags * @uses $shortcode_tags
* *
* @return string The shortcode search regular expression * @return string The shortcode search regular expression
@ -250,7 +256,7 @@ function get_shortcode_regex() {
* Regular Expression callable for do_shortcode() for calling shortcode hook. * Regular Expression callable for do_shortcode() for calling shortcode hook.
* @see get_shortcode_regex for details of the match array contents. * @see get_shortcode_regex for details of the match array contents.
* *
* @since 2.5 * @since 2.5.0
* @access private * @access private
* @uses $shortcode_tags * @uses $shortcode_tags
* *
@ -284,7 +290,7 @@ function do_shortcode_tag( $m ) {
* attribute as the value in the key/value pair. This allows for easier * attribute as the value in the key/value pair. This allows for easier
* retrieval of the attributes, since all attributes have to be known. * retrieval of the attributes, since all attributes have to be known.
* *
* @since 2.5 * @since 2.5.0
* *
* @param string $text * @param string $text
* @return array List of attributes and their value. * @return array List of attributes and their value.
@ -322,7 +328,7 @@ function shortcode_parse_atts($text) {
* If the $atts list has unsupported attributes, then they will be ignored and * If the $atts list has unsupported attributes, then they will be ignored and
* removed from the final returned list. * removed from the final returned list.
* *
* @since 2.5 * @since 2.5.0
* *
* @param array $pairs Entire list of supported attributes and their defaults. * @param array $pairs Entire list of supported attributes and their defaults.
* @param array $atts User defined attributes in shortcode tag. * @param array $atts User defined attributes in shortcode tag.
@ -359,7 +365,8 @@ function shortcode_atts( $pairs, $atts, $shortcode = '' ) {
/** /**
* Remove all shortcode tags from the given content. * Remove all shortcode tags from the given content.
* *
* @since 2.5 * @since 2.5.0
*
* @uses $shortcode_tags * @uses $shortcode_tags
* *
* @param string $content Content to remove shortcode tags. * @param string $content Content to remove shortcode tags.

4
wp-includes/taxonomy.php
View File

@ -2337,7 +2337,7 @@ function wp_set_object_terms($object_id, $terms, $taxonomy, $append = false) {
* *
* @package WordPress * @package WordPress
* @subpackage Taxonomy * @subpackage Taxonomy
* @since 3.6 * @since 3.6.0
* @uses wp_set_object_terms() * @uses wp_set_object_terms()
* *
* @param int $object_id The ID of the object to which the terms will be added. * @param int $object_id The ID of the object to which the terms will be added.
@ -2354,7 +2354,7 @@ function wp_add_object_terms( $object_id, $terms, $taxonomy ) {
* *
* @package WordPress * @package WordPress
* @subpackage Taxonomy * @subpackage Taxonomy
* @since 3.6 * @since 3.6.0
* @uses $wpdb * @uses $wpdb
* *
* @uses apply_filters() Calls 'delete_term_relationships' hook with object_id and tt_ids as parameters. * @uses apply_filters() Calls 'delete_term_relationships' hook with object_id and tt_ids as parameters.

3
wp-includes/theme.php
View File

@ -1559,7 +1559,8 @@ add_action( 'wp_loaded', '_custom_header_background_just_in_time' );
/** /**
* Gets the theme support arguments passed when registering that support * Gets the theme support arguments passed when registering that support
* *
* @since 3.1 * @since 3.1.0
*
* @param string $feature the feature to check * @param string $feature the feature to check
* @return array The array of extra arguments * @return array The array of extra arguments
*/ */

8
wp-includes/widgets.php
View File

@ -19,7 +19,7 @@
* *
* @package WordPress * @package WordPress
* @subpackage Widgets * @subpackage Widgets
* @since 2.8 * @since 2.8.0
*/ */
class WP_Widget { class WP_Widget {
@ -311,7 +311,7 @@ class WP_Widget {
* *
* @package WordPress * @package WordPress
* @subpackage Widgets * @subpackage Widgets
* @since 2.8 * @since 2.8.0
*/ */
class WP_Widget_Factory { class WP_Widget_Factory {
var $widgets = array(); var $widgets = array();
@ -978,7 +978,7 @@ function is_dynamic_sidebar() {
/** /**
* Whether a sidebar is in use. * Whether a sidebar is in use.
* *
* @since 2.8 * @since 2.8.0
* *
* @param mixed $index Sidebar name, id or number to check. * @param mixed $index Sidebar name, id or number to check.
* @return bool true if the sidebar is in use, false otherwise. * @return bool true if the sidebar is in use, false otherwise.
@ -1124,7 +1124,7 @@ function wp_convert_widget_settings($base_name, $option_name, $settings) {
/** /**
* Output an arbitrary widget as a template tag * Output an arbitrary widget as a template tag
* *
* @since 2.8 * @since 2.8.0
* *
* @param string $widget the widget's PHP class name (see default-widgets.php) * @param string $widget the widget's PHP class name (see default-widgets.php)
* @param array $instance the widget's instance settings * @param array $instance the widget's instance settings