On 15 August 2010 20:36, Aryeh Gregor Simetrical+wikilist@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