[development] QA: Consensus on comment formatting

Metzler, David metzlerd at evergreen.edu
Mon Jan 8 19:37:44 UTC 2007


IIRC:  //* @TODO is also supported by doxygen.  The extra * is what gets
doxygen to parse it. 

-----Original Message-----
From: development-bounces at drupal.org
[mailto:development-bounces at drupal.org] On Behalf Of Angela Byron
Sent: Monday, January 08, 2007 11:33 AM
To: development at drupal.org; dopry at thing.net
Subject: Re: [development] QA: Consensus on comment formatting


On 8-Jan-07, at 1:31 PM, Darrel O'Pry wrote:

> for phpdoc // @todo wouldn't work...  /** @todo would word */

OK. In that case, I'm going to need to -1 @todo. /** stuff **/ as  
inline comments sucks, because then you can't comment out large  
blocks of code easily, which is something essential to debugging.  
That coupled with everyone else saying that // TODO is supported in  
their editor of choice makes this a closed case, imo.

-Angie



More information about the development mailing list