[wp-trac] Re: [WordPress Trac] #7526: WP-Config-Sample.php inline documentation

WordPress Trac wp-trac at lists.automattic.com
Mon Sep 1 09:16:27 GMT 2008


#7526: WP-Config-Sample.php inline documentation
------------------------------+---------------------------------------------
 Reporter:  santosj           |        Owner:  anonymous
     Type:  enhancement       |       Status:  reopened 
 Priority:  low               |    Milestone:  2.7      
Component:  Optimization      |      Version:           
 Severity:  minor             |   Resolution:           
 Keywords:  phpdoc has-patch  |  
------------------------------+---------------------------------------------
Comment (by caesarsgrunt):

 Replying to [comment:24 jacobsantos]:

 > I keep trying to add #7397, but the core developer team is smarter than
 that. I think it belongs in its own ticket, so we can debate it for
 another week or so, then get bored and then bring it up in another 3 or 4
 months or so.
 It's just that it's more 'enhancement' of the `wp-config-sample.php`
 inline documentation, which this ticket is enhancing anyway. But whatever.

 > {{{/**#@+*/}}} and {{{/**#@-*/}}} are attempts to keep the long winded
 patch even less long winded. There are several converters used by
 phpDocumentor that will apply the phpdoc comment to every documentable
 element between those two. Basically, if they get the unique phrases from
 the web site like they should, then they will replace all of the hard work
 (not that it matters once it goes into {{{wp-config.php}}}, people
 shouldn't be applying phpDocumentor to their live sites anyway, because
 the constants' value might be picked up).
 Ah, clever.[[BR]]
 In that case yes, I think `7526.r8793.diff` is good - commit?

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


More information about the wp-trac mailing list