[
Date Prev][
Date Next][
Thread Prev][
Thread Next][
Date Index][
Thread Index]
[
List Home]
|
Re: [smarthome-dev] author tag
|
This is our agreed upon code style, see https://www.eclipse.org/smarthome/documentation/development/guidelines.html#a-code-style.
It is related to the discussion about the license headers: Since we do not list the code authors within the JavaDoc license header, we instead use the @author tag for this purpose (which makes it easy to do auto-updates of the license headers).
The VCS info is imho not enough as when you are distributing the source code, you do not necessarily also re-distribute the VCS history.
Regards,
Kai
> On 11 Apr 2016, at 08:54, Markus Rathgeb <maggu2810@xxxxxxxxx> wrote:
>
> Hi,
> our Java files contains @author tags in the class description.
> Is there really any need for this?
> Isn't that information already tracked by the VCS?
> I have to admit that I mostly never used that approach myself.
> Best regards,
> Markus
> _______________________________________________
> smarthome-dev mailing list
> smarthome-dev@xxxxxxxxxxx
> To change your delivery options, retrieve your password, or unsubscribe from this list, visit
> https://dev.eclipse.org/mailman/listinfo/smarthome-dev
