/
Make use of @since comment
Make use of @since comment
I've just found, that @since comment can be used to define a version since when functionality is available. For example:
/** * [SCHEDULED TASK] Deletes expired sessions * * @param kEvent $event * @since 5.1.0 */ function OnDeleteExpiredSessions($event) { if (defined('IS_INSTALL') && IS_INSTALL) { return ; } $this->Application->Session->DeleteExpired(); }
When next time developer will look at that method he can clearly see, that before In-Portal 5.1.0 this method wasn't available.
This would also help, when documentation is generated, because just looking at method comment we can understand if functionality is present in a given version.
To figure out when each of methods/classes is added we need to inspect SVN commit history.