Re: Re: coding standards: Header Comment Blocks
| From: | Stefan Neufeind | Date: | Thu, 10 Jun 2004 08:17:03 +0000 |
| Subject: | Re: Re: coding standards: Header Comment Blocks | ||
| References: | 1 | Groups: | php.pear.dev |
| Request: | Send a blank email to pear-dev+get-30366@lists.php.net to get a copy of this message | ||
On 9 Jun 2004 at 20:12, Greg Beaver wrote:
> Tobias Schlitt wrote:
>
> > Daniel Convissor wrote:
> >
> >> /**
> >> * @version Release: @package_version@
> >> * @version CVS: $Revision$, $Date$
> >> */
> >
> >
> > As stated I would love to have something like the following included:
> >
> > * @package @package_name@
> >
> > Or similar. Having a @package tag in every file makes the documentation
> > build process much more comfortable.
>
> Package name doesn't change
>
> -1 for magic, make dem foos type out the full package name
>
> * @package Package_Name
>
> takes just as much effort as
>
> * @package @package_name@
>
> and is fewer keystrokes :)
*lol* This would make renaming the package/class for the next major
version easier.
class @package_name@
{
function @package_name@
{
...
}
...
}
class @package_name@_Child
{
function @package_name@_Child
{
...
}
...
}
ANYBODY please don't take this seriously. It's just to show where
this might lead :-))
Stefan