RE: [Fwd: Q on keyword substitution]

[Jim.Hyslop]

Thomas Marsh wrote:
> 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?
I suspect not. This will work for '@version', which I gather is similar in
concept to the $REvision$ keyword - i.e. it gets updated whenever the file
is checked out (I'm not familiar with phpDocumentor, I'm just guessing).

Walter wants to use the @since keyword, which I gather indicates when a
specific feature was added. This is *not* something you want updated each
time you check out the file.

-- 
Jim Hyslop
Senior Software Designer
Leitch Technology International Inc. ( http://www.leitch.com )
Columnist, C/C++ Users Journal ( http://www.cuj.com/experts )