On 15 August 2010 20:36, Aryeh Gregor <Simetrical+wikilist(a)gmail.com> wrote:
If you do want to find out if a method is in the
version you're
targeting, there's a very easy way: check out the branch in SVN and
look in the file. Or use ViewVC. It's not really harder than looking
in the source code. On the other hand, manually adding @since
clutters the comments, makes that much less code fit on one screen,
and will create zillions of cleanup commits (which we already have too
many of).
While developing, I open the source file anyway to check the method
name and order of parameters. Some people may use documentation for
that. For both cases the @since tag is useful while opening the same
file in different branches is waste of time. Same applies for ViewCV.
You might not care about them, but how about the many extension
developers, including me?
Moreover, I don't see a problem with cleanup commits. They are
inevitable given our old and crufty codebase and lack of conventions
in past. I don't believe this will introduce more of those, since
usually only new methods are marked, only old ones only when needed.
So I think we shouldn't use @since at all,
personally.
Since no other acceptable solution is proposed, I disagree.
-Niklas
--
Niklas Laxström