@since

[Oleg]

(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?

[igorw]

Nice to have, no objections. Using it for new stuff should be sufficient.

[naderman]

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.

[Oleg]

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.

[igorw]

If we decide to use @since then we need to also adjust it whenever we change function signatures.

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.

[Oleg]

What is the benefit of such indication?

[igorw]

As per IRC, this is more consistent with the PHP manual.