Changeset 5951 for trunk/src/bbpress.php

Timestamp:

10/28/2015 04:07:50 AM (10 years ago)

Author:

netweb

Message:

Standardize @since PHPDoc tags style and format

• e.g. @since 2.6.0 bbPress (r5951) YOLO
• See ​http://phpdoc.org/docs/latest/references/phpdoc/tags/since.html

This changeset updates the style and formatting of all of our @since instances for compatibility with phpDocumentor 2 and WP-Parser as we move toward implementing the bbPress developer code reference.

Props thebrandonallen
Fixes #2879

File:

• trunk/src/bbpress.php (modified) (25 diffs)

trunk/src/bbpress.php

@@ -33 +33 @@
  * "How doth the little busy bee, improve each shining hour..."
  *
- * @since bbPress (r2464)
+ * @since 2.0.0 bbPress (r2464)
  */
 final class bbPress {
@@ -91 +91 @@
      * time. Also prevents needing to define globals all over the place.
      *
-     * @since bbPress (r3757)
+     * @since 2.1.0 bbPress (r3757)
+     *
      * @staticvar object $instance
      * @uses bbPress::setup_globals() Setup the globals needed
@@ -121 +122 @@
      * A dummy constructor to prevent bbPress from being loaded more than once.
      *
-     * @since bbPress (r2464)
+     * @since 2.0.0 bbPress (r2464)
+     *
      * @see bbPress::instance()
      * @see bbpress();
@@ -130 +132 @@
      * A dummy magic method to prevent bbPress from being cloned
      *
-     * @since bbPress (r2464)
+     * @since 2.0.0 bbPress (r2464)
      */
     public function __clone() { _doing_it_wrong( __FUNCTION__, __( 'Cheatin’ huh?', 'bbpress' ), '2.1' ); }
@@ -137 +139 @@
      * A dummy magic method to prevent bbPress from being unserialized
      *
-     * @since bbPress (r2464)
+     * @since 2.0.0 bbPress (r2464)
      */
     public function __wakeup() { _doing_it_wrong( __FUNCTION__, __( 'Cheatin’ huh?', 'bbpress' ), '2.1' ); }
@@ -144 +146 @@
      * Magic method for checking the existence of a certain custom field
      *
-     * @since bbPress (r3951)
+     * @since 2.1.0 bbPress (r3951)
      */
     public function __isset( $key ) { return isset( $this->data[ $key ] ); }
@@ -151 +153 @@
      * Magic method for getting bbPress variables
      *
-     * @since bbPress (r3951)
+     * @since 2.1.0 bbPress (r3951)
      */
     public function __get( $key ) { return isset( $this->data[ $key ] ) ? $this->data[ $key ] : null; }
@@ -158 +160 @@
      * Magic method for setting bbPress variables
      *
-     * @since bbPress (r3951)
+     * @since 2.1.0 bbPress (r3951)
      */
     public function __set( $key , $value ) { $this->data[ $key ] = $value; }
@@ -165 +167 @@
      * Magic method for unsetting bbPress variables
      *
-     * @since bbPress (r4628)
+     * @since 2.3.0 bbPress (r4628)
      */
     public function __unset( $key ) {
@@ -176 +178 @@
      * Magic method to prevent notices and errors from invalid method calls
      *
-     * @since bbPress (r4252)
+     * @since 2.2.0 bbPress (r4252)
      */
     public function __call( $name = '', $args = array() ) { unset( $name, $args ); return null; }
@@ -186 +188 @@
      * filtered to allow for early overriding.
      *
-     * @since bbPress (r2626)
+     * @since 2.0.0 bbPress (r2626)
+     *
      * @access private
      * @uses plugin_dir_path() To generate bbPress plugin path
@@ -287 +290 @@
      * Include required files
      *
-     * @since bbPress (r2626)
+     * @since 2.0.0 bbPress (r2626)
+     *
      * @access private
      * @uses is_admin() If in WordPress admin, load additional file
@@ -360 +364 @@
      * Setup the default hooks and actions
      *
-     * @since bbPress (r2644)
+     * @since 2.0.0 bbPress (r2644)
+     *
      * @access private
      * @uses add_action() To add various actions
@@ -409 +414 @@
      * later date we need to automate this, and API will need to be built.
      *
-     * @since bbPress (r3829)
+     * @since 2.1.0 bbPress (r3829)
      */
     public function register_theme_packages() {
@@ -431 +436 @@
      * Setup the default bbPress theme compatibility location.
      *
-     * @since bbPress (r3778)
+     * @since 2.1.0 bbPress (r3778)
      */
     public function setup_theme() {
@@ -453 +458 @@
      * translation files, please use the global language folder.
      *
-     * @since bbPress (r2596)
+     * @since 2.0.0 bbPress (r2596)
      *
      * @uses apply_filters() Calls 'plugin_locale' with {@link get_locale()} value
@@ -481 +486 @@
      * Setup the post types for forums, topics and replies
      *
-     * @since bbPress (r2597)
+     * @since 2.0.0 bbPress (r2597)
+     *
      * @uses register_post_type() To register the post types
      * @uses apply_filters() Calls various filters to modify the arguments
@@ -570 +576 @@
      * replies can be viewed from within the theme.
      *
-     * @since bbPress (r2727)
+     * @since 2.0.0 bbPress (r2727)
+     *
      * @uses register_post_status() To register post statuses
      * @uses $wp_post_statuses To modify trash and private statuses
@@ -655 +662 @@
      * Register the topic tag and forum moderator taxonomies
      *
-     * @since bbPress (r2464) Added bbp_get_topic_tag_tax_id() taxonomy
-     * @since bbPress (r5834) Added bbp_get_forum_mod_tax_id() taxonomy
+     * @since 2.0.0 bbPress (r2464) Added bbp_get_topic_tag_tax_id() taxonomy
+     * @since 2.6.0 bbPress (r5834) Added bbp_get_forum_mod_tax_id() taxonomy
      *
      * @uses register_taxonomy() To register the taxonomy
@@ -713 +720 @@
      * Register the bbPress views
      *
-     * @since bbPress (r2789)
+     * @since 2.0.0 bbPress (r2789)
+     *
      * @uses bbp_register_view() To register the views
      */
@@ -749 +757 @@
      * Register the bbPress shortcodes
      *
-     * @since bbPress (r3031)
+     * @since 2.0.0 bbPress (r3031)
      *
      * @uses BBP_Shortcodes
@@ -765 +773 @@
      * avoid xmlrpc errors.
      *
-     * @since bbPress (r2697)
+     * @since 2.0.0 bbPress (r2697)
+     *
      * @uses wp_get_current_user()
      */
@@ -777 +786 @@
      * Add the bbPress-specific rewrite tags
      *
-     * @since bbPress (r2753)
+     * @since 2.0.0 bbPress (r2753)
+     *
      * @uses add_rewrite_tag() To add the rewrite tags
      */
@@ -798 +808 @@
      * - User profiles
      *
-     * @since bbPress (r2688)
+     * @since 2.0.0 bbPress (r2688)
+     *
      * @todo Extract into an API
      */
@@ -897 +908 @@
      * - Search
      *
-     * @since bbPress (r4930)
+     * @since 2.4.0 bbPress (r4930)
      */
     public static function add_permastructs() {