-
1. Re: Removing @author from source files
rcernich Jul 16, 2012 6:31 PM (in response to kcbabo)0+
(I don't care either way, but lean toward removing them.)
-
2. Re: Removing @author from source files
igarashitm Jul 16, 2012 7:20 PM (in response to rcernich)+1
To be honest, I'm always wondering whether I should add me or not when modifying existing code.
-
3. Re: Removing @author from source files
mageshbk Jul 17, 2012 2:44 AM (in response to kcbabo)-1
The files when created may have an @author and later when modified need not necessarily have additional @author tags, unless extensive changes are made to the code. In an open source world, people could download code without the need for any SCM tool, a browser for example. A quick look at the source would say who authored the file and what license it carries. If the argument is to remove all @author tags, then why not the license headers too. Well I don't think that is good for open source. I feel the tradition of maintaining the license header as well as @author tag is significant for copyright purpose alone. When someone from the community contributes a file, it is worth to give him the credit via @author tag, rather than him asking his friends to dig through the git history.
I noticed before that you never added @author tag. I believed that like tags in post you never found it easy to add them
-
4. Re: Removing @author from source files
beve Jul 17, 2012 6:52 AM (in response to mageshbk)0+
(I'll update my code template according to what is decided)
-
5. Re: Removing @author from source files
dward Jul 17, 2012 8:35 AM (in response to kcbabo)+0
I don't really care. I've done it since it's in my template.
-
6. Re: Removing @author from source files
kcbabo Jul 17, 2012 9:24 AM (in response to mageshbk)I noticed before that you never added @author tag. I believed that like tags in post you never found it easy to add them
Ha! You got me there. I have some comments on your other points, but I'll save them until everyone else weighs in.
-
7. Re: Removing @author from source files
bfitzpat Jul 17, 2012 9:27 AM (in response to kcbabo)+0
Whatever is decided is fine. The Eclipse JavaDoc template automagically adds them, so like a trained monkey I just fill in the blanks...
Is there a Red Hat standard? What do they do in the Linux code?
-
8. Re: Removing @author from source files
dward Jul 17, 2012 9:30 AM (in response to mageshbk)I personally don't get why we hafta put license headers in each source file, either. Just a reference to the license would be good, then we could update the license in one place if we needed too.
-
9. Re: Removing @author from source files
mageshbk Jul 17, 2012 10:29 AM (in response to igarashitm)Psst! Tomo, change your vote, it's now or never
I would also like to vote +0, but hey, does that really change anything?
-
10. Re: Removing @author from source files
igarashitm Jul 17, 2012 10:47 AM (in response to mageshbk)hmm, actually the reason why I voted +1 is too trivial... let me say +0.1 :-P
Anyway, I may want to change to +0 with rounding off.
-
11. Re: Removing @author from source files
rcernich Jul 17, 2012 10:54 AM (in response to kcbabo)Wow! A bunch of strong opinions.
-
12. Re: Removing @author from source files
splatch Jul 29, 2012 6:43 AM (in response to kcbabo)+1 for removal of @author. We may not add @author in new files and keep @author tags in existing just to don't do a clean up job with value equals to zero.
Blame in git works great and I can always find who made particular sections in file.