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.

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

View File

@ -27,7 +27,7 @@ $wp_query->is_404 = false;
/**
* Fires before the Site Activation page is loaded.
*
* @since 3.0
* @since 3.0.0
*/
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.
*
* @since 3.0
* @since 3.0.0
*/
do_action( 'activate_wp_head' );
}

View File

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

View File

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

View File

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

View File

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

View File

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

View File

@ -358,7 +358,7 @@ class WP_Theme_Install_List_Table extends WP_Themes_List_Table {
/**
* Send required variables to JavaScript land
*
* @since 3.4
* @since 3.4.0
* @access private
*
* @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.
*
* @since 3.4
* @since 3.4.0
* @access private
*
* @param object $theme - A WordPress.org Theme API object.

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,
* 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 apply_filters

View File

@ -346,7 +346,7 @@ function wp_doc_link_parse( $content ) {
/**
* Saves option for number of rows when listing posts, pages, comments, etc.
*
* @since 2.8
* @since 2.8.0
**/
function set_screen_options() {
@ -648,7 +648,7 @@ add_action('admin_head', '_ipad_meta');
/**
* 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 ) {
$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
*
* @since 3.6
* @since 3.6.0
*/
function wp_refresh_post_lock( $response, $data, $screen_id ) {
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
*
* @since 3.6
* @since 3.6.0
*/
function wp_refresh_post_nonces( $response, $data, $screen_id ) {
if ( array_key_exists( 'wp-refresh-post-nonces', $data ) ) {

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
*
* @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 bool $echo Whether or not to echo the url - default is true

View File

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

View File

@ -9,7 +9,7 @@
/**
* 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.
*/
@ -22,7 +22,7 @@ function add_user() {
*
* 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.
* @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
* user management.
*
* @since 2.8
* @since 2.8.0
*
* @return unknown
*/

View File

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

View File

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

View File

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

View File

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

View File

@ -13,7 +13,8 @@
/**
* Retrieve the author of the current post.
*
* @since 1.5
* @since 1.5.0
*
* @uses $authordata The current author's DB object.
* @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.
*
* @since 2.8
* @since 2.8.0
*
* @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_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.
*
* @since 2.8
* @since 2.8.0
*
* @see get_the_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.
*
* @link http://codex.wordpress.org/Template_Tags/the_author_link
* @since 2.1
*
* @since 2.1.0
*
* @uses get_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.
*
* @since 1.5
* @since 1.5.0
*
* @uses $post The current post in the Loop's DB object.
* @uses count_user_posts()
* @return int The number of posts by the author.

View File

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

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
* DO NOT use this in plugin code.
*
* @since 3.4
* @since 3.4.0
* @access private
*
* @return string The altered query string

View File

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

View File

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

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/14636 Allow wildcard domains in WP_PROXY_BYPASS_HOSTS
* @since 2.8
* @since 2.8.0
*/
class WP_HTTP_Proxy {
/**
* Whether proxy connection should be used.
*
* @since 2.8
* @since 2.8.0
*
* @use WP_PROXY_HOST
* @use WP_PROXY_PORT
*
@ -1415,7 +1416,8 @@ class WP_HTTP_Proxy {
/**
* Whether authentication should be used.
*
* @since 2.8
* @since 2.8.0
*
* @use WP_PROXY_USERNAME
* @use WP_PROXY_PASSWORD
*
@ -1428,7 +1430,7 @@ class WP_HTTP_Proxy {
/**
* Retrieve the host for the proxy server.
*
* @since 2.8
* @since 2.8.0
*
* @return string
*/
@ -1442,7 +1444,7 @@ class WP_HTTP_Proxy {
/**
* Retrieve the port for the proxy server.
*
* @since 2.8
* @since 2.8.0
*
* @return string
*/
@ -1456,7 +1458,7 @@ class WP_HTTP_Proxy {
/**
* Retrieve the username for proxy authentication.
*
* @since 2.8
* @since 2.8.0
*
* @return string
*/
@ -1470,7 +1472,7 @@ class WP_HTTP_Proxy {
/**
* Retrieve the password for proxy authentication.
*
* @since 2.8
* @since 2.8.0
*
* @return string
*/
@ -1484,7 +1486,7 @@ class WP_HTTP_Proxy {
/**
* Retrieve authentication string for proxy authentication.
*
* @since 2.8
* @since 2.8.0
*
* @return string
*/
@ -1495,7 +1497,7 @@ class WP_HTTP_Proxy {
/**
* Retrieve header string for proxy authentication.
*
* @since 2.8
* @since 2.8.0
*
* @return string
*/
@ -1762,7 +1764,7 @@ class WP_Http_Cookie {
*
* Includes RFC 1950, RFC 1951, and RFC 1952.
*
* @since 2.8
* @since 2.8.0
* @package WordPress
* @subpackage HTTP
*/
@ -1773,7 +1775,7 @@ class WP_Http_Encoding {
*
* Supports the RFC 1951 standard.
*
* @since 2.8
* @since 2.8.0
*
* @param string $raw String to compress.
* @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
* original compressed string will be returned.
*
* @since 2.8
* @since 2.8.0
*
* @param string $compressed String to decompress.
* @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.
*
* @since 2.8
* @since 2.8.0
*
* @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.
*
* @since 2.8
* @since 2.8.0
*
* @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.
*
* @since 2.8
* @since 2.8.0
*
* @param array|string $headers All of the available headers.
* @return bool
@ -1944,7 +1946,7 @@ class WP_Http_Encoding {
* ensure that the functions all exist in the PHP version and aren't
* disabled.
*
* @since 2.8
* @since 2.8.0
*
* @return bool
*/

View File

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

View File

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

View File

@ -139,7 +139,7 @@ function comment_author_email_link( $linktext = '', $before = '', $after = '' )
*
* @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 $before Optional. The text or HTML to display before the email link. Default empty.

View File

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

View File

@ -53,7 +53,7 @@ function get_postdata($postid) {
* Sets up the WordPress Loop.
*
* @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}
*/
function start_wp() {
@ -121,8 +121,8 @@ function the_category_head($before='', $after='') {
/**
* Prints link to the previous post.
*
* @since 1.5
* @deprecated 2.0
* @since 1.5.0
* @deprecated 2.0.0
* @deprecated Use 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.
*
* @since 0.71
* @deprecated 2.0
* @deprecated 2.0.0
* @deprecated Use 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.
*
* @since 1.5
* @deprecated 2.0
* @since 1.5.0
* @deprecated 2.0.0
* @deprecated Use 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.
*
* @since 1.5
* @deprecated 2.0
* @since 1.5.0
* @deprecated 2.0.0
* @deprecated Use 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.
*
* @since 1.5
* @deprecated 2.0
* @since 1.5.0
* @deprecated 2.0.0
* @deprecated Use 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.
*
* @since 1.5
* @deprecated 2.0
* @since 1.5.0
* @deprecated 2.0.0
* @deprecated Use 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.
*
* @since 1.5
* @deprecated 2.0
* @since 1.5.0
* @deprecated 2.0.0
* @deprecated Use 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.
*
* @since 1.5
* @deprecated 2.0
* @since 1.5.0
* @deprecated 2.0.0
* @deprecated Use 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.
*
* @since 1.5
* @deprecated 2.0
* @since 1.5.0
* @deprecated 2.0.0
* @deprecated Use 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.
*
* @since 1.5
* @deprecated 2.0
* @since 1.5.0
* @deprecated 2.0.0
* @deprecated Use 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.
*
* @since 1.5
* @deprecated 2.0
* @since 1.5.0
* @deprecated 2.0.0
* @deprecated Use 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.
*
* @since 0.71
* @deprecated 2.1
* @deprecated 2.1.0
* @deprecated Use 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.
*
* @since 1.0.1
* @deprecated 2.1
* @deprecated 2.1.0
* @deprecated Use wp_list_bookmarks()
* @see wp_list_bookmarks()
*
@ -459,7 +459,7 @@ function wp_get_linksbyname($category, $args = '') {
* </code>
*
* @since 1.0.1
* @deprecated 2.1
* @deprecated 2.1.0
* @deprecated Use get_bookmarks()
* @see get_bookmarks()
*
@ -512,7 +512,7 @@ function get_linkobjectsbyname($cat_name = "noname" , $orderby = 'name', $limit
* </ol>
*
* @since 1.0.1
* @deprecated 2.1
* @deprecated 2.1.0
* @deprecated Use 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.
*
* @since 0.71
* @deprecated 2.1
* @deprecated 2.1.0
* @deprecated Use 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.
*
* @since 0.71
* @deprecated 2.1
* @deprecated 2.1.0
* @deprecated Use get_bookmarks()
* @see get_bookmarks()
*
@ -596,7 +596,7 @@ function get_links_withrating($category = -1, $before = '', $after = '<br />', $
* Gets the auto_toggle setting.
*
* @since 0.71
* @deprecated 2.1
* @deprecated 2.1.0
* @deprecated No alternative function available
*
* @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
* @deprecated 2.1
* @deprecated 2.1.0
* @deprecated Use 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
* @deprecated 2.1
* @since 1.2.0
* @deprecated 2.1.0
* @deprecated Use wp_list_categories()
* @see wp_list_categories()
*
@ -677,7 +677,7 @@ function wp_list_cats($args = '') {
/**
* @since 0.71
* @deprecated 2.1
* @deprecated 2.1.0
* @deprecated Use wp_dropdown_categories()
* @see wp_dropdown_categories()
*
@ -713,8 +713,10 @@ function dropdown_cats($optionall = 1, $all = 'All', $orderby = 'ID', $order = '
}
/**
* @since 1.2
* @deprecated 2.1
* List authors.
*
* @since 1.2.0
* @deprecated 2.1.0
* @deprecated Use 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
* @deprecated 2.1
* @deprecated 2.1.0
* @deprecated Use 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.
*
* @since 1.0.1
* @deprecated 2.1
* @deprecated 2.1.0
* @deprecated Use 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
* @deprecated 2.1
* @deprecated 2.1.0
* @deprecated Use 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.
*
* @since 1.2
* @deprecated 2.1
* @since 1.2.0
* @deprecated 2.1.0
* @deprecated Use 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.
*
* @since 0.71
* @deprecated 2.1
* @deprecated 2.1.0
* @deprecated Use 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.
*
* @since 0.71
* @deprecated 2.1
* @deprecated 2.1.0
* @deprecated Use get_option()
* @see get_option()
*
@ -855,7 +857,7 @@ function get_settings($option) {
* Print the permalink of the current post in the loop.
*
* @since 0.71
* @deprecated 1.2
* @deprecated 1.2.0
* @deprecated Use the_permalink()
* @see the_permalink()
*/
@ -868,7 +870,7 @@ function permalink_link() {
* Print the permalink to the RSS feed.
*
* @since 0.71
* @deprecated 2.3
* @deprecated 2.3.0
* @deprecated Use 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
* @since 1.0.1
* @deprecated 2.1
* @deprecated 2.1.0
* @deprecated Use wp_list_bookmarks()
* @see wp_list_bookmarks()
*
@ -924,7 +926,7 @@ function wp_get_links($args = '') {
* Gets the links associated with category by id.
*
* @since 0.71
* @deprecated 2.1
* @deprecated 2.1.0
* @deprecated Use 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.
*
* @since 1.0.1
* @deprecated 2.1
* @deprecated 2.1.0
* @deprecated Use 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.
*
* @since 0.71
* @deprecated 2.1
* @deprecated 2.1.0
* @deprecated {@internal Use function instead is unknown}}
*
* @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
* @deprecated 2.1
* @deprecated 2.1.0
* @deprecated Use sanitize_bookmark_field()
* @see sanitize_bookmark_field()
*
@ -1107,7 +1109,7 @@ function get_linkrating($link) {
* Gets the name of category by id.
*
* @since 0.71
* @deprecated 2.1
* @deprecated 2.1.0
* @deprecated Use get_category()
* @see get_category()
*
@ -1137,7 +1139,7 @@ function get_linkcatname($id = 0) {
* Print RSS comment feed link.
*
* @since 1.0.1
* @deprecated 2.5
* @deprecated 2.5.0
* @deprecated Use 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.
*
* @since 1.2
* @deprecated 2.5
* @since 1.2.0
* @deprecated 2.5.0
* @deprecated Use 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.
*
* @since 1.2
* @deprecated 2.5
* @since 1.2.0
* @deprecated 2.5.0
* @deprecated Use 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.
*
* @since 1.5
* @deprecated 2.2
* @since 1.5.0
* @deprecated 2.2.0
* @deprecated Use get_post_comments_feed_link()
* @see get_post_comments_feed_link()
*
@ -1209,8 +1211,8 @@ function comments_rss() {
/**
* An alias of wp_create_user().
*
* @since 2.0
* @deprecated 2.0
* @since 2.0.0
* @deprecated 2.0.0
* @deprecated Use wp_create_user()
* @see wp_create_user()
*
@ -1227,7 +1229,7 @@ function create_user($username, $password, $email) {
/**
* Unused function.
*
* @deprecated 2.5
* @deprecated 2.5.0
*/
function gzip_compression() {
_deprecated_function( __FUNCTION__, '2.5' );
@ -1238,7 +1240,7 @@ function gzip_compression() {
* Retrieve an array of comment data about comment $comment_ID.
*
* @since 0.71
* @deprecated 2.7
* @deprecated 2.7.0
* @deprecated Use 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.
*
* @since 0.71
* @deprecated 2.8
* @deprecated 2.8.0
* @deprecated Use 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.
*
* @since 1.2.0
* @deprecated 2.8
* @deprecated 2.8.0
* @deprecated Use 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.
*
* @since 1.5
* @deprecated 2.8
* @since 1.5.0
* @deprecated 2.8.0
* @deprecated Use get_the_author_meta('description')
* @see get_the_author_meta()
*
@ -1325,7 +1327,7 @@ function get_the_author_description() {
* Display the description of the author of the current post.
*
* @since 1.0.0
* @deprecated 2.8
* @deprecated 2.8.0
* @deprecated Use the_author_meta('description')
* @see the_author_meta()
*/
@ -1337,8 +1339,8 @@ function the_author_description() {
/**
* Retrieve the login name of the author of the current post.
*
* @since 1.5
* @deprecated 2.8
* @since 1.5.0
* @deprecated 2.8.0
* @deprecated Use get_the_author_meta('login')
* @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.
*
* @since 0.71
* @deprecated 2.8
* @deprecated 2.8.0
* @deprecated Use the_author_meta('login')
* @see the_author_meta()
*/
@ -1365,8 +1367,8 @@ function the_author_login() {
/**
* Retrieve the first name of the author of the current post.
*
* @since 1.5
* @deprecated 2.8
* @since 1.5.0
* @deprecated 2.8.0
* @deprecated Use get_the_author_meta('first_name')
* @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.
*
* @since 0.71
* @deprecated 2.8
* @deprecated 2.8.0
* @deprecated Use the_author_meta('first_name')
* @see the_author_meta()
*/
@ -1393,8 +1395,8 @@ function the_author_firstname() {
/**
* Retrieve the last name of the author of the current post.
*
* @since 1.5
* @deprecated 2.8
* @since 1.5.0
* @deprecated 2.8.0
* @deprecated Use get_the_author_meta('last_name')
* @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.
*
* @since 0.71
* @deprecated 2.8
* @deprecated 2.8.0
* @deprecated Use the_author_meta('last_name')
* @see the_author_meta()
*/
@ -1421,8 +1423,8 @@ function the_author_lastname() {
/**
* Retrieve the nickname of the author of the current post.
*
* @since 1.5
* @deprecated 2.8
* @since 1.5.0
* @deprecated 2.8.0
* @deprecated Use get_the_author_meta('nickname')
* @see get_the_author_meta()
*
@ -1437,7 +1439,7 @@ function get_the_author_nickname() {
* Display the nickname of the author of the current post.
*
* @since 0.71
* @deprecated 2.8
* @deprecated 2.8.0
* @deprecated Use the_author_meta('nickname')
* @see the_author_meta()
*/
@ -1449,8 +1451,8 @@ function the_author_nickname() {
/**
* Retrieve the email of the author of the current post.
*
* @since 1.5
* @deprecated 2.8
* @since 1.5.0
* @deprecated 2.8.0
* @deprecated Use get_the_author_meta('email')
* @see get_the_author_meta()
*
@ -1465,7 +1467,7 @@ function get_the_author_email() {
* Display the email of the author of the current post.
*
* @since 0.71
* @deprecated 2.8
* @deprecated 2.8.0
* @deprecated Use the_author_meta('email')
* @see the_author_meta()
*/
@ -1477,8 +1479,8 @@ function the_author_email() {
/**
* Retrieve the ICQ number of the author of the current post.
*
* @since 1.5
* @deprecated 2.8
* @since 1.5.0
* @deprecated 2.8.0
* @deprecated Use get_the_author_meta('icq')
* @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.
*
* @since 0.71
* @deprecated 2.8
* @deprecated 2.8.0
* @deprecated Use the_author_meta('icq')
* @see the_author_meta()
*/
@ -1505,8 +1507,8 @@ function the_author_icq() {
/**
* Retrieve the Yahoo! IM name of the author of the current post.
*
* @since 1.5
* @deprecated 2.8
* @since 1.5.0
* @deprecated 2.8.0
* @deprecated Use get_the_author_meta('yim')
* @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.
*
* @since 0.71
* @deprecated 2.8
* @deprecated 2.8.0
* @deprecated Use the_author_meta('yim')
* @see the_author_meta()
*/
@ -1533,8 +1535,8 @@ function the_author_yim() {
/**
* Retrieve the MSN address of the author of the current post.
*
* @since 1.5
* @deprecated 2.8
* @since 1.5.0
* @deprecated 2.8.0
* @deprecated Use get_the_author_meta('msn')
* @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.
*
* @since 0.71
* @deprecated 2.8
* @deprecated 2.8.0
* @deprecated Use the_author_meta('msn')
* @see the_author_meta()
*/
@ -1561,8 +1563,8 @@ function the_author_msn() {
/**
* Retrieve the AIM address of the author of the current post.
*
* @since 1.5
* @deprecated 2.8
* @since 1.5.0
* @deprecated 2.8.0
* @deprecated Use get_the_author_meta('aim')
* @see get_the_author_meta()
*
@ -1578,7 +1580,7 @@ function get_the_author_aim() {
*
* @since 0.71
* @see the_author_meta()
* @deprecated 2.8
* @deprecated 2.8.0
* @deprecated Use the_author_meta('aim')
*/
function the_author_aim() {
@ -1590,7 +1592,7 @@ function the_author_aim() {
* Retrieve the specified author's preferred display name.
*
* @since 1.0.0
* @deprecated 2.8
* @deprecated 2.8.0
* @deprecated Use get_the_author_meta('display_name')
* @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.
*
* @since 1.5
* @deprecated 2.8
* @since 1.5.0
* @deprecated 2.8.0
* @deprecated Use get_the_author_meta('url')
* @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.
*
* @since 0.71
* @deprecated 2.8
* @deprecated 2.8.0
* @deprecated Use the_author_meta('url')
* @see the_author_meta()
*/
@ -1633,8 +1635,8 @@ function the_author_url() {
/**
* Retrieve the ID of the author of the current post.
*
* @since 1.5
* @deprecated 2.8
* @since 1.5.0
* @deprecated 2.8.0
* @deprecated Use get_the_author_meta('ID')
* @see get_the_author_meta()
*
@ -1649,7 +1651,7 @@ function get_the_author_ID() {
* Display the ID of the author of the current post.
*
* @since 0.71
* @deprecated 2.8
* @deprecated 2.8.0
* @deprecated Use the_author_meta('ID')
* @see the_author_meta()
*/
@ -1785,7 +1787,7 @@ function _c( $text, $domain = 'default' ) {
* Translates $text like translate(), but assumes that the text
* contains a context after its last vertical bar.
*
* @since 2.5
* @since 2.5.0
* @uses translate()
* @deprecated 3.0.0
* @deprecated Use _x()
@ -1834,7 +1836,7 @@ function __ngettext() {
/**
* Register plural strings in POT file, but don't translate them.
*
* @since 2.5
* @since 2.5.0
* @deprecated 2.8.0
* @deprecated Use _n_noop()
* @see _n_noop()

View File

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

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
* 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 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.
*
* @since 2.8
* @since 2.8.0
*
* @param string|array $args Optional args.
* @return string The posts link navigation.

View File

@ -385,7 +385,7 @@ function wp_nav_menu( $args = array() ) {
* Add the class property classes for the current context, if applicable.
*
* @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.
*/

View File

@ -57,7 +57,7 @@ if ( !function_exists('get_user_by_email') ) :
/**
* Retrieve user info by email.
*
* @since 2.5
* @since 2.5.0
* @deprecated 3.3.0
* @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.
*
* @since 1.5
* @deprecated 2.5
* @since 1.5.0
* @deprecated 2.5.0
* @deprecated Use 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.
*
* @since 1.5
* @deprecated 2.5
* @since 1.5.0
* @deprecated 2.5.0
* @deprecated Use 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.
*
* @since 2.0.3
* @deprecated 2.5
* @deprecated 2.5.0
* @deprecated No alternative
*
* @return bool Always returns false

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
* 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 $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.
*
* @since 2.5
* @since 2.5.0
*
* @uses apply_filters() Calls 'auth_cookie' hook on $cookie contents, User ID
* and expiration of cookie.
*
@ -588,7 +589,7 @@ if ( !function_exists('wp_parse_auth_cookie') ) :
/**
* Parse a cookie into its components
*
* @since 2.7
* @since 2.7.0
*
* @param string $cookie
* @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
* 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 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.
*
* @since 2.5
* @since 2.5.0
*/
function wp_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.
*
* @since 1.5
* @since 1.5.0
*/
function auth_redirect() {
// 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.
*
* @since 2.3
* @since 2.3.0
*
* @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,
* 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.
*
* @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.
*
* @since 1.0
* @since 1.0.0
*
* @uses $wpdb
*
* @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.
*
* @since 2.7
* @since 2.7.0
*
* @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.
*
* @since 2.0
* @since 2.0.0
*
* @param int $user_id User ID
* @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
* updated, e.g. by autosave.
*
* @since 2.5
* @since 2.5.0
*
* @return int
*/
@ -1401,7 +1404,7 @@ if ( !function_exists('wp_salt') ) :
* Salting passwords helps against tools which has stored hashed values of
* 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
*
@ -1485,7 +1488,8 @@ if ( !function_exists('wp_hash_password') ) :
* For integration with other applications, this function can be overwritten to
* instead use the other package password checking algorithm.
*
* @since 2.5
* @since 2.5.0
*
* @global object $wp_hasher PHPass object
* @uses PasswordHash::HashPassword
*
@ -1517,7 +1521,8 @@ if ( !function_exists('wp_check_password') ) :
* For integration with other applications, this function can be overwritten to
* 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
* against the $hash + $password
* @uses PasswordHash::CheckPassword
@ -1559,7 +1564,7 @@ if ( !function_exists('wp_generate_password') ) :
/**
* 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 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
* instead use the other package password checking algorithm.
*
* @since 2.5
* @since 2.5.0
*
* @uses $wpdb WordPress database object for queries
* @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.
*
* @since 2.5
* @since 2.5.0
*
* @param int|string|object $id_or_email A user ID, email address, or comment object
* @param int $size Size of the avatar image
* @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
* the title.
*
* @since 2.6
* @since 2.6.0
*
* @see wp_parse_args() Used to change defaults to user defined settings.
* @uses Text_Diff
* @uses WP_Text_Diff_Renderer_Table

View File

@ -16,7 +16,7 @@
*
* @package WordPress
* @subpackage Plugin
* @since 1.5
* @since 1.5.0
*/
// Initialize the filter globals.
@ -93,7 +93,8 @@ function add_filter( $tag, $function_to_add, $priority = 10, $accepted_args = 1
*
* @package WordPress
* @subpackage Plugin
* @since 2.5
* @since 2.5.0
*
* @global array $wp_filter Stores all of the filters
*
* @param string $tag The name of the filter hook.
@ -275,7 +276,8 @@ function apply_filters_ref_array($tag, $args) {
*
* @package WordPress
* @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 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.
*
* @since 2.7
* @since 2.7.0
*
* @param string $tag The filter to remove hooks from.
* @param int $priority The priority number to remove.
@ -328,7 +330,7 @@ function remove_all_filters($tag, $priority = false) {
*
* @package WordPress
* @subpackage Plugin
* @since 2.5
* @since 2.5.0
*
* @return string Hook name of the current filter or action.
*/
@ -349,7 +351,8 @@ function current_filter() {
*
* @package WordPress
* @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 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
* @subpackage Plugin
* @since 1.2
*
* @since 1.2.0
*
* @global array $wp_filter Stores all of the filters
* @global array $wp_actions Increments the amount of times action was triggered.
*
@ -438,7 +443,8 @@ function do_action($tag, $arg = '') {
*
* @package WordPress
* @subpackage Plugin
* @since 2.1
* @since 2.1.0
*
* @global array $wp_actions Increments the amount of times action was triggered.
*
* @param string $tag The name of the action hook.
@ -461,7 +467,8 @@ function did_action($tag) {
*
* @package WordPress
* @subpackage Plugin
* @since 2.1
* @since 2.1.0
*
* @global array $wp_filter Stores all of the filters
* @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
* @subpackage Plugin
* @since 2.5
* @since 2.5.0
*
* @see has_filter() has_action() is an alias of has_filter().
*
* @param string $tag The name of the action hook.
@ -539,7 +547,8 @@ function has_action($tag, $function_to_check = false) {
*
* @package WordPress
* @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 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.
*
* @since 2.7
* @since 2.7.0
*
* @param string $tag The action to remove hooks from.
* @param int $priority The priority number to remove them from.
@ -574,7 +583,8 @@ function remove_all_actions($tag, $priority = false) {
*
* @package WordPress
* @subpackage Plugin
* @since 1.5
*
* @since 1.5.0
*
* @access private
*
@ -598,7 +608,7 @@ function plugin_basename($file) {
* Gets the filesystem directory path (with trailing slash) for the plugin __FILE__ passed in
* @package WordPress
* @subpackage Plugin
* @since 2.8
* @since 2.8.0
*
* @param string $file The filename of the plugin (__FILE__)
* @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
* @package WordPress
* @subpackage Plugin
* @since 2.8
* @since 2.8.0
*
* @param string $file The filename of the plugin (__FILE__)
* @return string the URL path of the directory that contains the plugin
@ -635,7 +645,7 @@ function plugin_dir_url( $file ) {
*
* @package WordPress
* @subpackage Plugin
* @since 2.0
* @since 2.0.0
*
* @param string $file The filename of the plugin including the path.
* @param callback $function the function hooked to the 'activate_PLUGIN' action.
@ -660,7 +670,7 @@ function register_activation_hook($file, $function) {
*
* @package WordPress
* @subpackage Plugin
* @since 2.0
* @since 2.0.0
*
* @param string $file The filename of the plugin including the path.
* @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
* executing.
*
* @since 2.7
* @since 2.7.0
*
* @param string $file
* @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
* @subpackage Plugin
* @since 2.5
* @since 2.5.0
* @access private
*
* @uses $wp_filter Used to process all of the functions in the 'all' hook

View File

@ -49,7 +49,7 @@ function the_post_thumbnail( $size = 'post-thumbnail', $attr = '' ) {
/**
* 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.
*/

View File

@ -714,7 +714,7 @@ function wp_style_loader_src( $src, $handle ) {
* Postpones the scripts that were queued for the footer.
* print_footer_scripts() is called in the footer to print these scripts.
*
* @since 2.8
* @since 2.8.0
*
* @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.
*
* @since 2.8
* @since 2.8.0
*/
function print_footer_scripts() {
global $wp_scripts, $concatenate_scripts;
@ -799,7 +799,7 @@ function _print_scripts() {
* Postpones the scripts that were queued for the footer.
* 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() {
if ( ! did_action('wp_print_scripts') ) {
@ -828,7 +828,7 @@ function _wp_footer_scripts() {
/**
* Hooks to print the scripts and styles in the footer.
*
* @since 2.8
* @since 2.8.0
*/
function 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().
* 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() {
do_action('wp_enqueue_scripts');
@ -849,7 +849,7 @@ function wp_enqueue_scripts() {
/**
* Prints the styles queue in the HTML head on admin pages.
*
* @since 2.8
* @since 2.8.0
*/
function print_admin_styles() {
global $wp_styles, $concatenate_scripts, $compress_css;
@ -923,7 +923,7 @@ function _print_styles() {
/**
* Determine the concatenation and compression settings for scripts and styles.
*
* @since 2.8
* @since 2.8.0
*/
function script_concat_settings() {
global $concatenate_scripts, $compress_scripts, $compress_css;

View File

@ -29,13 +29,14 @@
*
* @package WordPress
* @subpackage Shortcodes
* @since 2.5
* @since 2.5.0
*/
/**
* Container for storing shortcode tags and their hook to call for the shortcode
*
* @since 2.5
* @since 2.5.0
*
* @name $shortcode_tags
* @var array
* @global array $shortcode_tags
@ -84,7 +85,8 @@ $shortcode_tags = array();
* add_shortcode('baztag', 'baztag_func');
* </code>
*
* @since 2.5
* @since 2.5.0
*
* @uses $shortcode_tags
*
* @param string $tag Shortcode tag to be searched in post content.
@ -100,7 +102,8 @@ function add_shortcode($tag, $func) {
/**
* Removes hook for shortcode.
*
* @since 2.5
* @since 2.5.0
*
* @uses $shortcode_tags
*
* @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
* for removing all shortcodes.
*
* @since 2.5
* @since 2.5.0
*
* @uses $shortcode_tags
*/
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
* the shortcode will still show up in the post or content.
*
* @since 2.5
* @since 2.5.0
*
* @uses $shortcode_tags
* @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.
* 6 - An extra ] to allow for escaping shortcodes with double [[]]
*
* @since 2.5
* @since 2.5.0
*
* @uses $shortcode_tags
*
* @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.
* @see get_shortcode_regex for details of the match array contents.
*
* @since 2.5
* @since 2.5.0
* @access private
* @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
* retrieval of the attributes, since all attributes have to be known.
*
* @since 2.5
* @since 2.5.0
*
* @param string $text
* @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
* 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 $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.
*
* @since 2.5
* @since 2.5.0
*
* @uses $shortcode_tags
*
* @param string $content Content to remove shortcode tags.

View File

@ -2337,7 +2337,7 @@ function wp_set_object_terms($object_id, $terms, $taxonomy, $append = false) {
*
* @package WordPress
* @subpackage Taxonomy
* @since 3.6
* @since 3.6.0
* @uses wp_set_object_terms()
*
* @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
* @subpackage Taxonomy
* @since 3.6
* @since 3.6.0
* @uses $wpdb
*
* @uses apply_filters() Calls 'delete_term_relationships' hook with object_id and tt_ids as parameters.

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
*
* @since 3.1
* @since 3.1.0
*
* @param string $feature the feature to check
* @return array The array of extra arguments
*/

View File

@ -19,7 +19,7 @@
*
* @package WordPress
* @subpackage Widgets
* @since 2.8
* @since 2.8.0
*/
class WP_Widget {
@ -311,7 +311,7 @@ class WP_Widget {
*
* @package WordPress
* @subpackage Widgets
* @since 2.8
* @since 2.8.0
*/
class WP_Widget_Factory {
var $widgets = array();
@ -978,7 +978,7 @@ function is_dynamic_sidebar() {
/**
* Whether a sidebar is in use.
*
* @since 2.8
* @since 2.8.0
*
* @param mixed $index Sidebar name, id or number to check.
* @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
*
* @since 2.8
* @since 2.8.0
*
* @param string $widget the widget's PHP class name (see default-widgets.php)
* @param array $instance the widget's instance settings