I'm not sure how widespread the problem is, but certain classes misuse the
docblock's @access declaration. That is, if the access restrictions were to
translate straight to actual language level declarations in PHP5, you'd break a
lot of functionality. For now, I just know that HTMLForm.php couldn't possibly
be a class of only private methods (and nothing else). That would be quite
useless. I think they're supposed to be protected, but public would be even nicer.
A related bug would also ask for certain interfaces that were originally private
to be made public for extensions to use.
Assigned as blocker to Brion's "Our docs are teh suck" bug and added to the code
quality tracking bug.