Make WordPress Core


Ignore:
Timestamp:
07/27/2017 12:40:27 AM (8 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/widgets/class-wp-widget-media.php

    r41028 r41162  
    4646     *
    4747     * @since 4.8.0
    48      * @access public
    4948     *
    5049     * @param string $id_base         Base ID for the widget, lowercase and unique.
     
    9493     *
    9594     * @since 4.8.0
    96      * @access public
    9795     *
    9896     * @param integer $number Optional. The unique order number of this widget instance
     
    123121     *
    124122     * @since  4.8.0
    125      * @access public
    126123     *
    127124     * @see WP_REST_Controller::get_item_schema()
     
    159156     *
    160157     * @since 4.8.0
    161      * @access public
    162158     *
    163159     * @param int|WP_Post $attachment Attachment post ID or object.
     
    183179     *
    184180     * @since 4.8.0
    185      * @access public
    186181     *
    187182     * @link http://w3c.github.io/html/infrastructure.html#space-separated-tokens
     
    203198     *
    204199     * @since 4.8.0
    205      * @access public
    206200     *
    207201     * @see WP_Widget::widget()
     
    247241     *
    248242     * @since 4.8.0
    249      * @access public
    250243     *
    251244     * @see WP_Widget::update()
     
    293286     *
    294287     * @since 4.8.0
    295      * @access public
    296288     *
    297289     * @param array $instance Widget instance props.
     
    306298     *
    307299     * @since 4.8.0
    308      * @access public
    309300     *
    310301     * @see \WP_Widget_Media::render_control_template_scripts() Where the JS template is located.
     
    336327     *
    337328     * @since 4.8.0
    338      * @access public
    339329     *
    340330     * @param array   $states An array of media states.
     
    373363     *
    374364     * @since 4.8.0
    375      * @access public
    376365     */
    377366    public function enqueue_preview_scripts() {}
     
    381370     *
    382371     * @since 4.8.0
    383      * @access public
    384372     */
    385373    public function enqueue_admin_scripts() {
     
    392380     *
    393381     * @since 4.8.0
    394      * @access public
    395382     */
    396383    public function render_control_template_scripts() {
     
    426413     *
    427414     * @since 4.8.0
    428      * @access protected
    429415     *
    430416     * @param array $instance Widget instance props.
Note: See TracChangeset for help on using the changeset viewer.