Re: [Fwd: Q on keyword substitution]

[jsWalter]

> 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