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

[WordPress Trac]

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

Comment (by mrahmadawais):

 Replying to [comment:32 westonruter]:
 > 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].

 Great! I think we can address the `@access` tag along with JS files in
 WordPress 4.9 then.

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