[wp-trac] [WordPress Trac] #27200: Remove all non-file-level @package/@subpackage tags

[WordPress Trac]

#27200: Remove all non-file-level @package/@subpackage tags
--------------------------+-----------------------------
 Reporter:  DrewAPicture  |      Owner:
     Type:  defect (bug)  |     Status:  new
 Priority:  normal        |  Milestone:  Awaiting Review
Component:  General       |    Version:
 Severity:  normal        |   Keywords:  has-patch
  Focuses:  docs          |
--------------------------+-----------------------------
 As has been [https://github.com/rmccue/WP-
 Parser/issues/21#issuecomment-21329386 pointed out] by duck_, Rarst, and
 others, `@package` and `@subpackage` tags not found in file-header-level
 doc blocks can cause those and other functions/classes to be skipped by
 the parser. This is expected behavior in regard to the phpDoc spec.

 The proposal is to remove all `@package`/`@subpackage` PHPDoc tags that
 fall below the file header level of any given file. This of course would
 exclude of the numerous external libraries bundled with core.

--
Ticket URL: <https://core.trac.wordpress.org/ticket/27200>
WordPress Trac <https://core.trac.wordpress.org/>
WordPress publishing platform