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

[WordPress Trac]

#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
 suggestion.

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