[wp-trac] [WordPress Trac] #39671: Customize: Further improve inline documentation

[WordPress Trac]

#39671: Customize: Further improve inline documentation
------------------------------+-------------------
 Reporter:  westonruter       |       Owner:
     Type:  defect (bug)      |      Status:  new
 Priority:  normal            |   Milestone:  4.8
Component:  Customize         |     Version:
 Severity:  normal            |  Resolution:
 Keywords:  has-patch commit  |     Focuses:  docs
------------------------------+-------------------
Changes (by westonruter):

 * keywords:  good-first-bug has-patch => has-patch commit


Comment:

 Also just came across this:
 > Incidentally, the @access tag has no context with regard to a class
 itself. Visibility scope of public/protected/private only applies to class
 methods and class properties, not to a class itself. Further, it was added
 to phpDocumentor 1.x back in the PHP4 days, before such visibility scope
 was available in PHP at all (that was added in PHP5). Therefore, it's not
 actually useful anymore. Even in 1.x, if run using PHP5 against code
 written for PHP5, the code scope keywords would override whatever an
 @access tag said. I don't believe that phpDocumentor 2.x even bothered
 implementing the @access tag, and rightly so.
 http://stackoverflow.com/a/20148459/93579

 I'm going to commit [attachment:39671.9.diff].

--
Ticket URL: <https://core.trac.wordpress.org/ticket/39671#comment:32>
WordPress Trac <https://core.trac.wordpress.org/>
WordPress publishing platform