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