Changeset 41161 for trunk/src/wp-admin/includes/class-plugin-upgrader.php

Timestamp:

07/27/2017 12:39:34 AM (7 years ago)

Author:

DrewAPicture

Message:

Docs: Remove @access notations from method DocBlocks in wp-admin/* classes.

Prior to about 2013, many class methods lacked even access modifiers which made the @access notations that much more useful. Now that we've gotten to a point where the codebase is more mature from a maintenance perspective and we can finally remove these notations. Notable exceptions to this change include standalone functions notated as private as well as some classes still considered to represent "private" APIs.

See #41452.

File:

• trunk/src/wp-admin/includes/class-plugin-upgrader.php (modified) (11 diffs)

trunk/src/wp-admin/includes/class-plugin-upgrader.php

@@ -25 +25 @@
      *
      * @since 2.8.0
-     * @access public
      * @var array|WP_Error $result
      *
@@ -36 +35 @@
      *
      * @since 2.9.0
-     * @access public
      * @var bool $bulk
      */
@@ -45 +43 @@
      *
      * @since 2.8.0
-     * @access public
      */
     public function upgrade_strings() {
@@ -63 +60 @@
      *
      * @since 2.8.0
-     * @access public
      */
     public function install_strings() {
@@ -80 +76 @@
      * @since 2.8.0
      * @since 3.7.0 The `$args` parameter was added, making clearing the plugin update cache optional.
-     * @access public
      *
      * @param string $package The full local path or URI of the package.
@@ -135 +130 @@
      * @since 2.8.0
      * @since 3.7.0 The `$args` parameter was added, making clearing the plugin update cache optional.
-     * @access public
      *
      * @param string $plugin The basename path to the main plugin file.
@@ -207 +201 @@
      * @since 2.8.0
      * @since 3.7.0 The `$args` parameter was added, making clearing the plugin update cache optional.
-     * @access public
      *
      * @param array $plugins Array of the basename paths of the plugins' main files.
@@ -326 +319 @@
      *
      * @since 3.3.0
-     * @access public
      *
      * @global WP_Filesystem_Base $wp_filesystem Subclass
@@ -369 +361 @@
      *
      * @since 2.8.0
-     * @access public
      *
      * @return string|false The full path to the main plugin file, or false.
@@ -395 +386 @@
      * @since 2.8.0
      * @since 4.1.0 Added a return value.
-     * @access public
      *
      * @param bool|WP_Error  $return Upgrade offer return.
@@ -429 +419 @@
      *
      * @since 2.8.0
-     * @access public
      *
      * @global WP_Filesystem_Base $wp_filesystem Subclass