diff --git a/wp-activate.php b/wp-activate.php index 226780c34e..5e9be6ea82 100644 --- a/wp-activate.php +++ b/wp-activate.php @@ -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' ); } diff --git a/wp-admin/admin-functions.php b/wp-admin/admin-functions.php index f596749089..11bd30cd19 100644 --- a/wp-admin/admin-functions.php +++ b/wp-admin/admin-functions.php @@ -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 */ diff --git a/wp-admin/custom-header.php b/wp-admin/custom-header.php index 7f222f7cb7..63a2e3313e 100644 --- a/wp-admin/custom-header.php +++ b/wp-admin/custom-header.php @@ -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(); diff --git a/wp-admin/includes/ajax-actions.php b/wp-admin/includes/ajax-actions.php index 02a0a4e074..ed4b66b06c 100644 --- a/wp-admin/includes/ajax-actions.php +++ b/wp-admin/includes/ajax-actions.php @@ -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 diff --git a/wp-admin/includes/class-ftp-pure.php b/wp-admin/includes/class-ftp-pure.php index c765d553eb..bb7742abec 100644 --- a/wp-admin/includes/class-ftp-pure.php +++ b/wp-admin/includes/class-ftp-pure.php @@ -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 diff --git a/wp-admin/includes/class-ftp-sockets.php b/wp-admin/includes/class-ftp-sockets.php index abdf0db682..f9ea6cd5d2 100644 --- a/wp-admin/includes/class-ftp-sockets.php +++ b/wp-admin/includes/class-ftp-sockets.php @@ -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 diff --git a/wp-admin/includes/class-wp-theme-install-list-table.php b/wp-admin/includes/class-wp-theme-install-list-table.php index 8934684c21..5fdce2a9a1 100644 --- a/wp-admin/includes/class-wp-theme-install-list-table.php +++ b/wp-admin/includes/class-wp-theme-install-list-table.php @@ -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. diff --git a/wp-admin/includes/file.php b/wp-admin/includes/file.php index 7b83ca5539..9d2cae9eb9 100644 --- a/wp-admin/includes/file.php +++ b/wp-admin/includes/file.php @@ -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 diff --git a/wp-admin/includes/misc.php b/wp-admin/includes/misc.php index 5adb20d606..86a679d794 100644 --- a/wp-admin/includes/misc.php +++ b/wp-admin/includes/misc.php @@ -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 ) ) { diff --git a/wp-admin/includes/plugin.php b/wp-admin/includes/plugin.php index 8095cd4330..21743e10f8 100644 --- a/wp-admin/includes/plugin.php +++ b/wp-admin/includes/plugin.php @@ -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 diff --git a/wp-admin/includes/template.php b/wp-admin/includes/template.php index 076638262a..f17c285e8f 100644 --- a/wp-admin/includes/template.php +++ b/wp-admin/includes/template.php @@ -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() { diff --git a/wp-admin/includes/user.php b/wp-admin/includes/user.php index 85939fa9ab..58122ed0fc 100644 --- a/wp-admin/includes/user.php +++ b/wp-admin/includes/user.php @@ -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 */ diff --git a/wp-admin/js/theme-install.js b/wp-admin/js/theme-install.js index f61e8a7fd4..41fa244f7b 100644 --- a/wp-admin/js/theme-install.js +++ b/wp-admin/js/theme-install.js @@ -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() { diff --git a/wp-admin/update-core.php b/wp-admin/update-core.php index 6153599689..95e9dd8e43 100644 --- a/wp-admin/update-core.php +++ b/wp-admin/update-core.php @@ -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 */ diff --git a/wp-admin/upgrade-functions.php b/wp-admin/upgrade-functions.php index 080d74d7c5..7be637c8fd 100644 --- a/wp-admin/upgrade-functions.php +++ b/wp-admin/upgrade-functions.php @@ -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 */ diff --git a/wp-includes/atomlib.php b/wp-includes/atomlib.php index 4dcddc99cb..9d34276a7e 100644 --- a/wp-includes/atomlib.php +++ b/wp-includes/atomlib.php @@ -7,7 +7,7 @@ * * @author Elias Torres * @version 0.4 - * @since 2.3 + * @since 2.3.0 */ /** diff --git a/wp-includes/author-template.php b/wp-includes/author-template.php index 557a1ab8c9..03b09432fc 100644 --- a/wp-includes/author-template.php +++ b/wp-includes/author-template.php @@ -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. diff --git a/wp-includes/cache.php b/wp-includes/cache.php index f517d12425..81a64c0aeb 100644 --- a/wp-includes/cache.php +++ b/wp-includes/cache.php @@ -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 { diff --git a/wp-includes/canonical.php b/wp-includes/canonical.php index 231855ea50..5aefe2ba09 100644 --- a/wp-includes/canonical.php +++ b/wp-includes/canonical.php @@ -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 diff --git a/wp-includes/category-template.php b/wp-includes/category-template.php index 6ffd9d35ef..26c82a0f76 100644 --- a/wp-includes/category-template.php +++ b/wp-includes/category-template.php @@ -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'. diff --git a/wp-includes/class-IXR.php b/wp-includes/class-IXR.php index f8fbc00b10..5a2893de6a 100644 --- a/wp-includes/class-IXR.php +++ b/wp-includes/class-IXR.php @@ -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 { diff --git a/wp-includes/class-http.php b/wp-includes/class-http.php index c75b47e230..1982cde383 100644 --- a/wp-includes/class-http.php +++ b/wp-includes/class-http.php @@ -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 */ diff --git a/wp-includes/class-phpass.php b/wp-includes/class-phpass.php index 2fed5d7685..1970ae9da4 100644 --- a/wp-includes/class-phpass.php +++ b/wp-includes/class-phpass.php @@ -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; diff --git a/wp-includes/class-wp-xmlrpc-server.php b/wp-includes/class-wp-xmlrpc-server.php index 1ab005b8d8..9287d39460 100644 --- a/wp-includes/class-wp-xmlrpc-server.php +++ b/wp-includes/class-wp-xmlrpc-server.php @@ -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 diff --git a/wp-includes/comment-template.php b/wp-includes/comment-template.php index 9e59ce9111..d265c47c4d 100644 --- a/wp-includes/comment-template.php +++ b/wp-includes/comment-template.php @@ -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. diff --git a/wp-includes/default-constants.php b/wp-includes/default-constants.php index 4f135c82eb..6be5dd0904 100644 --- a/wp-includes/default-constants.php +++ b/wp-includes/default-constants.php @@ -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' ); diff --git a/wp-includes/deprecated.php b/wp-includes/deprecated.php index 44bd316fc3..a557438e64 100644 --- a/wp-includes/deprecated.php +++ b/wp-includes/deprecated.php @@ -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 = '
', * 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 = '') { * * * @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 * * * @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 = '
', $ * 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='
', $after='
', $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 = '
', $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() diff --git a/wp-includes/feed.php b/wp-includes/feed.php index 99e2286ce1..0020d1b5c7 100644 --- a/wp-includes/feed.php +++ b/wp-includes/feed.php @@ -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. diff --git a/wp-includes/link-template.php b/wp-includes/link-template.php index 45e3ba2870..f64b38a66a 100644 --- a/wp-includes/link-template.php +++ b/wp-includes/link-template.php @@ -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. diff --git a/wp-includes/nav-menu-template.php b/wp-includes/nav-menu-template.php index 7aceb8f67a..b7683c3cd3 100644 --- a/wp-includes/nav-menu-template.php +++ b/wp-includes/nav-menu-template.php @@ -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. */ diff --git a/wp-includes/pluggable-deprecated.php b/wp-includes/pluggable-deprecated.php index 02733b2b0f..435e86920a 100644 --- a/wp-includes/pluggable-deprecated.php +++ b/wp-includes/pluggable-deprecated.php @@ -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 diff --git a/wp-includes/pluggable.php b/wp-includes/pluggable.php index aca94f3633..794565f1c5 100644 --- a/wp-includes/pluggable.php +++ b/wp-includes/pluggable.php @@ -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 diff --git a/wp-includes/plugin.php b/wp-includes/plugin.php index df4ba8d33e..08a0abd720 100644 --- a/wp-includes/plugin.php +++ b/wp-includes/plugin.php @@ -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 diff --git a/wp-includes/post-thumbnail-template.php b/wp-includes/post-thumbnail-template.php index 32ad86aad5..91201e7994 100644 --- a/wp-includes/post-thumbnail-template.php +++ b/wp-includes/post-thumbnail-template.php @@ -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. */ diff --git a/wp-includes/script-loader.php b/wp-includes/script-loader.php index 6e3244f263..78804e0037 100644 --- a/wp-includes/script-loader.php +++ b/wp-includes/script-loader.php @@ -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; diff --git a/wp-includes/shortcodes.php b/wp-includes/shortcodes.php index dafb3a1405..0b2b7327ff 100644 --- a/wp-includes/shortcodes.php +++ b/wp-includes/shortcodes.php @@ -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'); * * - * @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. diff --git a/wp-includes/taxonomy.php b/wp-includes/taxonomy.php index 2f2ba6f73e..1259d11c5e 100644 --- a/wp-includes/taxonomy.php +++ b/wp-includes/taxonomy.php @@ -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. diff --git a/wp-includes/theme.php b/wp-includes/theme.php index e109125901..0ae8a8ba36 100644 --- a/wp-includes/theme.php +++ b/wp-includes/theme.php @@ -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 */ diff --git a/wp-includes/widgets.php b/wp-includes/widgets.php index 9091d7b8b8..cc8d0a1186 100644 --- a/wp-includes/widgets.php +++ b/wp-includes/widgets.php @@ -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