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.


git-svn-id: https://develop.svn.wordpress.org/trunk@26868 602fd350-edb4-49c9-b593-d223f7449a82

src/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
  */

src/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();

src/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

src/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

src/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

src/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.

src/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

src/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 ) ) {

src/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

src/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() {

src/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
  */

src/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() {

src/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
  */

src/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
  */