Make WordPress Core


Ignore:
Timestamp:
07/27/2017 12:40:27 AM (7 years ago)
Author:
DrewAPicture
Message:

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.

File:
1 edited

Legend:

Unmodified
Added
Removed
  • trunk/src/wp-includes/rest-api/endpoints/class-wp-rest-comments-controller.php

    r40606 r41162  
    2121     *
    2222     * @since 4.7.0
    23      * @access protected
    2423     * @var WP_REST_Comment_Meta_Fields
    2524     */
     
    3029     *
    3130     * @since 4.7.0
    32      * @access public
    3331     */
    3432    public function __construct() {
     
    4341     *
    4442     * @since 4.7.0
    45      * @access public
    4643     */
    4744    public function register_routes() {
     
    112109     *
    113110     * @since 4.7.0
    114      * @access public
    115111     *
    116112     * @param WP_REST_Request $request Full details about the request.
     
    165161     *
    166162     * @since 4.7.0
    167      * @access public
    168163     *
    169164     * @param WP_REST_Request $request Full details about the request.
     
    340335     *
    341336     * @since 4.7.0
    342      * @access public
    343337     *
    344338     * @param WP_REST_Request $request Full details about the request.
     
    372366     *
    373367     * @since 4.7.0
    374      * @access public
    375368     *
    376369     * @param WP_REST_Request $request Full details about the request.
     
    393386     *
    394387     * @since 4.7.0
    395      * @access public
    396388     *
    397389     * @param WP_REST_Request $request Full details about the request.
     
    481473     *
    482474     * @since 4.7.0
    483      * @access public
    484475     *
    485476     * @param WP_REST_Request $request Full details about the request.
     
    649640     *
    650641     * @since 4.7.0
    651      * @access public
    652642     *
    653643     * @param WP_REST_Request $request Full details about the request.
     
    671661     *
    672662     * @since 4.7.0
    673      * @access public
    674663     *
    675664     * @param WP_REST_Request $request Full details about the request.
     
    768757     *
    769758     * @since 4.7.0
    770      * @access public
    771759     *
    772760     * @param WP_REST_Request $request Full details about the request.
     
    789777     *
    790778     * @since 4.7.0
    791      * @access public
    792779     *
    793780     * @param WP_REST_Request $request Full details about the request.
     
    858845     *
    859846     * @since 4.7.0
    860      * @access public
    861847     *
    862848     * @param WP_Comment      $comment Comment object.
     
    924910     *
    925911     * @since 4.7.0
    926      * @access protected
    927912     *
    928913     * @param WP_Comment $comment Comment object.
     
    993978     *
    994979     * @since 4.7.0
    995      * @access protected
    996980     *
    997981     * @param string $query_param Query parameter.
     
    10261010     *
    10271011     * @since 4.7.0
    1028      * @access protected
    10291012     *
    10301013     * @param string|int $comment_approved comment status.
     
    10581041     *
    10591042     * @since 4.7.0
    1060      * @access protected
    10611043     *
    10621044     * @param WP_REST_Request $request Request object.
     
    11541136     *
    11551137     * @since 4.7.0
    1156      * @access public
    11571138     *
    11581139     * @return array
     
    13141295     *
    13151296     * @since 4.7.0
    1316      * @access public
    13171297     *
    13181298     * @return array Comments collection parameters.
     
    14721452     *
    14731453     * @since 4.7.0
    1474      * @access protected
    14751454     *
    14761455     * @param string|int $new_status New comment status.
     
    15211500     *
    15221501     * @since 4.7.0
    1523      * @access protected
    15241502     *
    15251503     * @param WP_Post         $post    Post object.
     
    15591537     *
    15601538     * @since 4.7.0
    1561      * @access protected
    15621539     *
    15631540     * @param WP_Comment      $comment Comment object.
     
    15941571     *
    15951572     * @since 4.7.0
    1596      * @access protected
    15971573     *
    15981574     * @param object $comment Comment object.
     
    16191595     *
    16201596     * @since 4.7.0
    1621      * @access public
    16221597     *
    16231598     * @param string          $value   Author email value submitted.
Note: See TracChangeset for help on using the changeset viewer.