@since

Discuss general development subjects that are not specific to a particular version like the versioning control system we use or other infrastructure.
Post Reply
Oleg
Posts: 1150
Joined: Tue Feb 23, 2010 2:38 am
Contact:

@since

Post by 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
Registered User
Posts: 500
Joined: Thu Jan 04, 2007 11:47 pm

Re: @since

Post by igorw »

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

User avatar
naderman
Consultant
Posts: 1727
Joined: Sun Jan 11, 2004 2:11 am
Location: Karlsruhe, Germany
Contact:

Re: @since

Post by 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
Posts: 1150
Joined: Tue Feb 23, 2010 2:38 am
Contact:

Re: @since

Post by 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
Registered User
Posts: 500
Joined: Thu Jan 04, 2007 11:47 pm

Re: @since

Post by igorw »

nn- wrote: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
Posts: 1150
Joined: Tue Feb 23, 2010 2:38 am
Contact:

Re: @since

Post by Oleg »

What is the benefit of such indication?

igorw
Registered User
Posts: 500
Joined: Thu Jan 04, 2007 11:47 pm

Re: @since

Post by igorw »

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

Post Reply