RE: [Springframework-developer] @since and @version tags

SourceForge Headquarters 1320 Columbia Street Suite 310 San Diego, CA 92101 +1 (858) 422-6466

Hi,

Sending again....
---------------------------

I don=92t vote often, but -1 for using $Id$ in @version.  I don't think =
end
users really care to see the CVS id in the javadocs, it just adds noise.
Maybe a non javadoc style comment in the code with $Id$ is a reasonable
compromise?  I'd like to see @since be the release # of spring since it =
is
more meaningful to users. =20

- Mark

> -----Original Message-----
> From: spr...@li...=20
> [mailto:spr...@li...]
>  On Behalf Of Dmitriy Kopylenko
> Sent: Thursday, July 29, 2004 11:36 AM
> To: spr...@li...
> Subject: Re: [Springframework-developer] @since and @version tags
>=20
>=20
> Let's give others a chance ;-)
>=20
> Alef, Keith, Mark, Bill.... what's your vote?
>=20
>=20
> Rob Harrop wrote:
>=20
> >Nothing like a good old fashioned standoff :)
> >
> >Shootout at noon?
> >
> >Rob
> >
> >-----Original Message-----
> >From: spr...@li...
> >[mailto:spr...@li...] On=20
> >Behalf Of Dmitriy Kopylenko
> >Sent: 29 July 2004 16:16
> >To: spr...@li...
> >Subject: Re: [Springframework-developer] @since and @version tags
> >
> >3 for (Rod, Dmitriy, Rob)
> >3 against  (Juergen, Thomas, Colin)
> >1 neutral (Darren)
> >
> >
> >Colin Sampaleanu wrote:
> >
> > =20
> >
> >>I do like $Id tags to be able to look at files and see who to blame
> >>for the last changes :-), but I would rather be able to=20
> branch/merge=20
> >>comfortably in the future. With Tortoise and Eclipse, I can see the=20
> >>revision history _very_ easily anyways, wherever I am.
> >>
> >>So -1 for using them from now on (i.e let's get rid of them)...
> >>
> >>
> >>Dmitriy Kopylenko wrote:
> >>
> >>   =20
> >>
> >>>Well, let's take a vote. I'm for $Id tags (+1)
> >>>
> >>>Regards,
> >>>Dmitriy.
> >>>
> >>>
> >>>j=FCrgen h=F6ller [werk3AT] wrote:
> >>>
> >>>     =20
> >>>
> >>>>I'd actually prefer if we drop $Id tags from all files. I=20
> personally
> >>>>don't think that they add much value. Of course, if a democratic=20
> >>>>decision goes in favor of those tags, well, I'll concede ;-)
> >>>>
> >>>>Regarding @since tags, we're currently using them with=20
> the creation
> >>>>date. That has been quite nice during our agile way=20
> towards 1.0. We=20
> >>>>could indeed reconsider to use version numbers there now.
> >>>>
> >>>>Any suggestions on how to apply a consistent style for all source
> >>>>files in a batch, without messing them up? $Id is probably easy,=20
> >>>>@since nearly impossible, parameter alignment easy again.
> >>>>
> >>>>Juergen
> >>>>
> >>>>
> >>>>________________________________
> >>>>
> >>>>Von: spr...@li... im
> >>>>Auftrag von Colin Sampaleanu
> >>>>Gesendet: Mi 28.07.2004 20:38
> >>>>An: spr...@li...
> >>>>Betreff: Re: [Springframework-developer] @since and @version tags
> >>>>
> >>>>
> >>>>
> >>>>Dmitriy Kopylenko wrote:
> >>>>
> >>>>=20
> >>>>
> >>>>       =20
> >>>>
> >>>>>>I like id keywords...they're mainly in the code through=20
> my classes=20
> >>>>>>or classes I've edited... (Damn, if it's standardized, I won't=20
> >>>>>>know if I've worked on a particular file any more :-)
> >>>>>>
> >>>>>>
> >>>>>>   =20
> >>>>>>           =20
> >>>>>>
> >>>>>I also insert $Id:$ when I work on existing classes or=20
> create new=20
> >>>>>ones
> >>>>>;-)
> >>>>>
> >>>>>Dmitriy.
> >>>>> =20
> >>>>>         =20
> >>>>>
> >>>>
> >>>>I personally like $Id tags. But they do suck big time=20
> when trying to=20
> >>>>merge files back in after a branch, causing a conflict/change to=20
> >>>>exist when there shouldn't be any... There seems to be a trend to=20
> >>>>going away from using them in files, by some people, for this=20
> >>>>reason.
> >>>>
> >>>>Colin
> >>>>       =20
> >>>>
> >>>     =20
> >>>
> >>
> >>
> >>-------------------------------------------------------
> >>This SF.Net email is sponsored by BEA Weblogic Workshop
> >>FREE Java Enterprise J2EE developer tools!
> >>Get your free copy of BEA WebLogic Workshop 8.1 today.=20
> >>http://ads.osdn.com/?ad_id=3D4721&alloc_id=3D10040&op=3Dclick
> >>_______________________________________________
> >>Springframework-developer mailing list=20
> >>Spr...@li...
> >>https://lists.sourceforge.net/lists/listinfo/springframework
> -developer
> >>   =20
> >>
> >
> >
> >
> >
> >-------------------------------------------------------
> >This SF.Net email is sponsored by BEA Weblogic Workshop
> >FREE Java Enterprise J2EE developer tools!
> >Get your free copy of BEA WebLogic Workshop 8.1 today.=20
> >http://ads.osdn.com/?ad_id=3D4721&alloc_id=3D10040&op=3Dclick
> >_______________________________________________
> >Springframework-developer mailing list=20
> >Spr...@li...
> >https://lists.sourceforge.net/lists/listinfo/springframework-
developer
>
>
>
>
>-------------------------------------------------------
>This SF.Net email is sponsored by OSTG. Have you noticed the changes on =

>Linux.com, ITManagersJournal and NewsForge in the past few weeks? Now,=20
>one more big change to announce. We are now OSTG- Open Source=20
>Technology Group. Come see the changes on the new OSTG site.=20
>www.ostg.com _______________________________________________
>Springframework-developer mailing list=20
>Spr...@li...
>https://lists.sourceforge.net/lists/listinfo/springframework-developer
> =20
>

-------------------------------------------------------
This SF.Net email is sponsored by OSTG. Have you noticed the changes on
Linux.com, ITManagersJournal and NewsForge in the past few weeks? Now, =
one
more big change to announce. We are now OSTG- Open Source Technology =
Group.
Come see the changes on the new OSTG site. www.ostg.com
_______________________________________________
Springframework-developer mailing list
Spr...@li...
https://lists.sourceforge.net/lists/listinfo/springframework-developer