[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: [Fwd: Q on keyword substitution]
From: |
jsWalter |
Subject: |
Re: [Fwd: Q on keyword substitution] |
Date: |
Fri, 7 Jan 2005 10:36:52 -0600 (CST) |
User-agent: |
SquirrelMail/1.5.1 [CVS] |
> jsWalter wrote: |>jsWalter <address@hidden> wrote:
> |>
> |>
> |>>I'm using phpDocumentor and would like to have the '@since' tag auto
> |>>insert the CVS file version, but not change it the next time the file
> is |>> submitted.
> |>>
> |>>this... * @since $Version: $
> |>>
> |>>to become... * @since 1.24
> |>>
> |>>not... * @since $Version: 1.24$
>
>
> looking at an example of java code in the apache struts cvs repository,
> I see
>
> /**
> ~ * Custom FormBeanConfig to demonstrate usage.
> ~ *
> ~ * @version $Revision: 1.2 $ $Date: 2004/03/14 06:23:50 $
> ~ */
>
>
> Is this not the kind of documentation you want?
For @version, yes.
This "label' should not be changed at each iteration, as VERSION will be.
But not for @since.
It is a way of knowing when something was addedd or removed from a file
based upon the CVS tracking version number
Walter
RE: [Fwd: Q on keyword substitution], Jim.Hyslop, 2005/01/07
RE: [Fwd: Q on keyword substitution], Jim.Hyslop, 2005/01/07