Re: [Phpgroupware-developers] Standard source code header and phpDocumentor

[Dave Hall]

Kai,

There are several issues with this.  

Firstly, we do not use phpdoc as our inline documentation.  We use this
http://developer.apple.com/darwin/projects/headerdoc/

This duplicates most of the information already in the standard header.

The license link is incorrect it should be
http://www.gnu.org/licenses/gpl.html

Also the email address is perfect for spam harvesting.

If you really want to move to new documentation standard, then propose
it to the project, not submit a patch - without consultataion.  Also you
might want to outline what your plans are for moving to the new
standard, ie who is going to make the changes, what time lines, etc.

Cheers

Dave

Kai Hofmann <address@hidden> wrote:

> I just have read abou the http://phpgroupware.org/wiki/Standard+Header
> and would like to ask if it would be possible add another one
> for the purpose of documenting the whole source code via phpDocumentor
> (www.phpdoc.org)
> 
>  /**
>   * @author Firstname Lastname <address@hidden>
>   * @copyright Copyright (c) 2000-2003 Free Software Foundation, Inc.
>   * @license http://www.opensource.org/licenses/lgpl-license.php 
> GNU Lesser
> General Public License
>   * @version $Id: class.accounts_contacts.inc.php,v 1.13 2002/09/21
> 05:15:31 Zone Exp $
>   * @package phpgwapi
>   * @subpackage access
>   */
> 
> an example of documentation generated with phpDocumentor can be 
> found at:
> http://www.probusiness.de/projekte/phpgroupware/phpdoc/index.html
> 
> 
> Greetings
> 
>   Kai Hofmann
> 
> -- 
> *****    Open Source und Linux im professionellen Einsatz    *****
> **  komplexe Mailserver, Groupware, Office: sprechen Sie uns an **
> Dipl.-Inform. Kai Hofmann                    Team Softwarelösungen
> pro|business AG, EXPO Plaza 1 (Deutscher Pavillon), 30539 Hannover
> E-Mail: address@hidden,   Tel.: 0511/60066-332, Fax: -355
> WWW: http://www.probusiness.de/
> 
> 
> _______________________________________________
> Phpgroupware-developers mailing list
> address@hidden
> http://mail.gnu.org/mailman/listinfo/phpgroupware-developers
>

dave.hall.vcf
Description: Card for <dave.hall@mbox.com.au>