(Inspired by cs278's timezone diffs.)
What about using @since to indicate which version a feature was introduced in? Useful? Not useful since nothing but the latest version is ever supported for anything?
@since
Re: @since
Nice to have, no objections. Using it for new stuff should be sufficient.
Re: @since
Agreed, would be nice if someone could add this to new stuff already added in 3.1 and add a rule to coding guidelines for both 3.0 & 3.1.
Re: @since
If we decide to use @since then we need to also adjust it whenever we change function signatures.
I think we should only use @since if we find an actual use for it. It sure is pretty but I don't think prettiness alone warrants the upkeep.
I think we should only use @since if we find an actual use for it. It sure is pretty but I don't think prettiness alone warrants the upkeep.
Re: @since
I'd rather use it to indicate when a class or method was introduced. And potentially add a "(introduced in 3.0.x)" to the @param if it's significant.nn- wrote:If we decide to use @since then we need to also adjust it whenever we change function signatures.
Re: @since
What is the benefit of such indication?
Re: @since
As per IRC, this is more consistent with the PHP manual.