[SourceJammer-devel] Javadoc Version Tag

[Eric <eri...@at...>]

It's great to hear that sourcejammer development has ramped up!  I was using 
it three years ago as a central means to work on code from several locations, 
and thought it was pretty cool.

I'm curious if any thought has been given regarding Javadoc versioning of 
files.  By this, I mean updating the version javadoc tags of each source 
file.  I realize that labels are used to version code in SJ, but was 
wondering if anyone had considered enhancing SJ to be able to update the 
source file's javadoc.  Do folks using SJ just manually keep the javadoc 
version tag up to date?  

Actually, I have a table in my javadoc sources which provides change date, 
version, developer initials, and a short description of the change.  While 
some may argue that such change details are best stored outside source code, 
it really does help with source code documentation.  Perhaps such 
functionality, e.g. updating javadoc tags, could be pluggable in SJ, so that 
if one wanted such functionality, they could implement it.  

Currently, the version of files is an integer which is incremented everytime a 
new version is created, in contrast to the usage of labels which usually 
possess a more detailed version-numbering scheme, e.g. major.minor.etc.    

Eric