I’d like to propose that we standardized on using multiple @since tags for
multiple versions in order to be more semantic and not have to invent a syntax
(that then needs to be followed and parsed)
@since 8.4.5, 8.3RC1
This is supported by the javadoc, see
Also note that our Unstable annotation checker needs to be in sync (I’ve opened
http://jira.xwiki.org/browse/XCOMMONS-1071 in advance).
The main rationale is that it’s more semantic to have one since per version
(similar to having one author par author).
PS: I have already made changes for commons and waiting for agreement before
committing or discarding ;)
devs mailing list