[wp-trac] Re: [WordPress Trac] #5225: plugins.php Documentation for adding new PHPdoc tags

WordPress Trac wp-trac at lists.automattic.com
Thu Oct 18 13:44:23 GMT 2007

#5225: plugins.php Documentation for adding new PHPdoc tags
 Reporter:  darkdragon    |        Owner:  anonymous
     Type:  enhancement   |       Status:  new      
 Priority:  normal        |    Milestone:  2.4      
Component:  Optimization  |      Version:  2.4      
 Severity:  normal        |   Resolution:           
 Keywords:                |  
Comment (by santosj):

 Yeah, I'd admit having the @internal function_name() is fairly redundant
 when you collapse phpdoc comments. The whole purpose is for those who
 don't have that feature and it would need to be the first line or it
 becomes worthless. You would then have

  * Short Description
  * {@internal function_name() }}
  * @access public|private
  * Long Description

 Which I don't know, it might not look so awful, but in any case it would
 also mean that the phpdocs that have the @access tag as the first line
 would also have to be moved down.

 I'll think about this and submit a new patch which resolves your

Ticket URL: <http://trac.wordpress.org/ticket/5225#comment:2>
WordPress Trac <http://trac.wordpress.org/>
WordPress blogging software

More information about the wp-trac mailing list