Docs: Remove @access notations from method DocBlocks in wp-includes/* 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.


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

src/wp-includes/class-wp-taxonomy.php

@@ -17,7 +17,6 @@ final class WP_Taxonomy {
 	 * Taxonomy key.
 	 *
 	 * @since 4.7.0
-	 * @access public
 	 * @var string
 	 */
 	public $name;
@@ -26,7 +25,6 @@ final class WP_Taxonomy {
 	 * Name of the taxonomy shown in the menu. Usually plural.
 	 *
 	 * @since 4.7.0
-	 * @access public
 	 * @var string
 	 */
 	public $label;
@@ -35,7 +33,6 @@ final class WP_Taxonomy {
 	 * An array of labels for this taxonomy.
 	 *
 	 * @since 4.7.0
-	 * @access public
 	 * @var object
 	 */
 	public $labels = array();
@@ -44,7 +41,6 @@ final class WP_Taxonomy {
 	 * A short descriptive summary of what the taxonomy is for.
 	 *
 	 * @since 4.7.0
-	 * @access public
 	 * @var string
 	 */
 	public $description = '';
@@ -53,7 +49,6 @@ final class WP_Taxonomy {
 	 * Whether a taxonomy is intended for use publicly either via the admin interface or by front-end users.
 	 *
 	 * @since 4.7.0
-	 * @access public
 	 * @var bool
 	 */
 	public $public = true;
@@ -62,7 +57,6 @@ final class WP_Taxonomy {
 	 * Whether the taxonomy is publicly queryable.
 	 *
 	 * @since 4.7.0
-	 * @access public
 	 * @var bool
 	 */
 	public $publicly_queryable = true;
@@ -71,7 +65,6 @@ final class WP_Taxonomy {
 	 * Whether the taxonomy is hierarchical.
 	 *
 	 * @since 4.7.0
-	 * @access public
 	 * @var bool
 	 */
 	public $hierarchical = false;
@@ -80,7 +73,6 @@ final class WP_Taxonomy {
 	 * Whether to generate and allow a UI for managing terms in this taxonomy in the admin.
 	 *
 	 * @since 4.7.0
-	 * @access public
 	 * @var bool
 	 */
 	public $show_ui = true;
@@ -91,7 +83,6 @@ final class WP_Taxonomy {
 	 * If true, the taxonomy is shown as a submenu of the object type menu. If false, no menu is shown.
 	 *
 	 * @since 4.7.0
-	 * @access public
 	 * @var bool
 	 */
 	public $show_in_menu = true;
@@ -100,7 +91,6 @@ final class WP_Taxonomy {
 	 * Whether the taxonomy is available for selection in navigation menus.
 	 *
 	 * @since 4.7.0
-	 * @access public
 	 * @var bool
 	 */
 	public $show_in_nav_menus = true;
@@ -109,7 +99,6 @@ final class WP_Taxonomy {
 	 * Whether to list the taxonomy in the tag cloud widget controls.
 	 *
 	 * @since 4.7.0
-	 * @access public
 	 * @var bool
 	 */
 	public $show_tagcloud = true;
@@ -118,7 +107,6 @@ final class WP_Taxonomy {
 	 * Whether to show the taxonomy in the quick/bulk edit panel.
 	 *
 	 * @since 4.7.0
-	 * @access public
 	 * @var bool
 	 */
 	public $show_in_quick_edit = true;
@@ -127,7 +115,6 @@ final class WP_Taxonomy {
 	 * Whether to display a column for the taxonomy on its post type listing screens.
 	 *
 	 * @since 4.7.0
-	 * @access public
 	 * @var bool
 	 */
 	public $show_admin_column = false;
@@ -136,7 +123,6 @@ final class WP_Taxonomy {
 	 * The callback function for the meta box display.
 	 *
 	 * @since 4.7.0
-	 * @access public
 	 * @var bool|callable
 	 */
 	public $meta_box_cb = null;
@@ -145,7 +131,6 @@ final class WP_Taxonomy {
 	 * An array of object types this taxonomy is registered for.
 	 *
 	 * @since 4.7.0
-	 * @access public
 	 * @var array
 	 */
 	public $object_type = null;
@@ -154,7 +139,6 @@ final class WP_Taxonomy {
 	 * Capabilities for this taxonomy.
 	 *
 	 * @since 4.7.0
-	 * @access public
 	 * @var array
 	 */
 	public $cap;
@@ -163,7 +147,6 @@ final class WP_Taxonomy {
 	 * Rewrites information for this taxonomy.
 	 *
 	 * @since 4.7.0
-	 * @access public
 	 * @var array|false
 	 */
 	public $rewrite;
@@ -172,7 +155,6 @@ final class WP_Taxonomy {
 	 * Query var string for this taxonomy.
 	 *
 	 * @since 4.7.0
-	 * @access public
 	 * @var string|false
 	 */
 	public $query_var;
@@ -181,7 +163,6 @@ final class WP_Taxonomy {
 	 * Function that will be called when the count is updated.
 	 *
 	 * @since 4.7.0
-	 * @access public
 	 * @var callable
 	 */
 	public $update_count_callback;
@@ -193,7 +174,6 @@ final class WP_Taxonomy {
 	 * respect to $rest_base and $rest_controller_class.
 	 *
 	 * @since 4.7.4
-	 * @access public
 	 * @var bool $show_in_rest
 	 */
 	public $show_in_rest;
@@ -202,7 +182,6 @@ final class WP_Taxonomy {
 	 * The base path for this taxonomy's REST API endpoints.
 	 *
 	 * @since 4.7.4
-	 * @access public
 	 * @var string|bool $rest_base
 	 */
 	public $rest_base;
@@ -213,7 +192,6 @@ final class WP_Taxonomy {
 	 * Custom controllers must extend WP_REST_Controller.
 	 *
 	 * @since 4.7.4
-	 * @access public
 	 * @var string|bool $rest_controller_class
 	 */
 	public $rest_controller_class;
@@ -222,7 +200,6 @@ final class WP_Taxonomy {
 	 * Whether it is a built-in taxonomy.
 	 *
 	 * @since 4.7.0
-	 * @access public
 	 * @var bool
 	 */
 	public $_builtin;
@@ -231,7 +208,6 @@ final class WP_Taxonomy {
 	 * Constructor.
 	 *
 	 * @since 4.7.0
-	 * @access public
 	 *
 	 * @global WP $wp WP instance.
 	 *
@@ -250,7 +226,6 @@ final class WP_Taxonomy {
 	 * Sets taxonomy properties.
 	 *
 	 * @since 4.7.0
-	 * @access public
 	 *
 	 * @param array|string $object_type Name of the object type for the taxonomy object.
 	 * @param array|string $args        Array or query string of arguments for registering a taxonomy.
@@ -382,7 +357,6 @@ final class WP_Taxonomy {
 	 * Adds the necessary rewrite rules for the taxonomy.
 	 *
 	 * @since 4.7.0
-	 * @access public
 	 *
 	 * @global WP $wp Current WordPress environment instance.
 	 */
@@ -411,7 +385,6 @@ final class WP_Taxonomy {
 	 * Removes any rewrite rules, permastructs, and rules for the taxonomy.
 	 *
 	 * @since 4.7.0
-	 * @access public
 	 *
 	 * @global WP $wp Current WordPress environment instance.
 	 */
@@ -435,7 +408,6 @@ final class WP_Taxonomy {
 	 * Registers the ajax callback for the meta box.
 	 *
 	 * @since 4.7.0
-	 * @access public
 	 */
 	public function add_hooks() {
 		add_filter( 'wp_ajax_add-' . $this->name, '_wp_ajax_add_hierarchical_term' );
@@ -445,7 +417,6 @@ final class WP_Taxonomy {
 	 * Removes the ajax callback for the meta box.
 	 *
 	 * @since 4.7.0
-	 * @access public
 	 */
 	public function remove_hooks() {
 		remove_filter( 'wp_ajax_add-' . $this->name, '_wp_ajax_add_hierarchical_term' );