gnuherds-app-dev
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: Comments on the new architecture


From: Davi Leal
Subject: Re: Comments on the new architecture
Date: Tue, 8 May 2007 14:07:19 +0200
User-agent: KMail/1.9.5

We get a more readable code using // to comment. Besides it spend one line 
less than when we use /* */


// aaaaaa
// aaaaaa


/* bbbbbb
 * bbbbbb
 */


I think that:

 * The below line is not needed:
      * Our index file.

 * Not needed due to we all know we are using PHP 5
      * PHP version 5

 * I think it not needed
      * @category   Public Controller

 * Replace '@' by 'at' and '.' by 'dot' to make it more difficult
   the work of spam bots.

 * The license is exposed in the text, so it is not needed repeat it.
   Note the license is included in a file with the source code, so
   the link is not needed. Besides, the content of that link could
   change, but the content of the file which we attach to our
   source code is controlled by us.

      @license    http://www.affero.org/oagpl.html Affero GPL

 * The below line is not needed due to it is showed by the editors, as emacs.
      * @version    CVS: $Id:$



 * It is not needed. We can get that information form the SCM
   when it be needed.
      * @since      File available since version 1.5


I attach a file after removing the not needed information.

Davi




reply via email to

[Prev in Thread] Current Thread [Next in Thread]