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

WordPress Trac noreply at wordpress.org
Tue Feb 25 11:16:50 UTC 2014


#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        |  Resolution:
 Keywords:  has-patch     |     Focuses:  docs
--------------------------+------------------------------

Comment (by DrewAPicture):

 Replying to [comment:1 Rarst]:
 > Note that it is _valid_ for class (top level class phpdoc). It's only
 invalid for functions (and methods I assume since that doesn't make
 sense). Of course if file header has package already repeating it in class
 is just redundant.

 I talked to @kpdesign about this yesterday and we both agree the better
 option would be to only have package tags in the file headers, i.e. once
 per file.

 The consensus was to promote a clean, simple standard instead of "package
 tags go in the file header except in  (this), (this), or (this) instance.
 If we just stick with only using package tags in file headers I think it
 will create far less confusion going forward.

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


More information about the wp-trac mailing list