On Wed, Aug 11, 2010 at 9:31 AM, Matthias Wessendorf <[email protected]> wrote: > On Wed, Aug 11, 2010 at 9:21 AM, Ganesh <[email protected]> wrote: >> I'd like to keep the @author tags. Isn't the spirit of the meritocracy >> involved with making authors visible? > > Actually not... > There are a ton of discussions on this in the archives. > > Fact: there is no code ownership...
http://mail-archives.apache.org/mod_mbox/jakarta-jmeter-dev/200402.mbox/%[email protected]%3e quote: - author tags are officially discouraged. these create difficulties in establishing the proper ownership and the protection of our committers. there are other social issues dealing with collaborative development, but the Board is concerned about the legal ramifications around the use of author tags (Greg Stein, formal ASF VP) > > > >> Shouldn't personal merit for a project >> be made visible in the code? I think it's great to see Manfred Geiler as the >> orginal author of most MyFaces parts. Many people download the source code >> without connecting to SVN, so SVN information may be unsufficient, also >> repackaging would delete original authorship. >> >> Matthias Wessendorf schrieb: >>> >>> On Wed, Aug 11, 2010 at 8:40 AM, Michael Kurz <[email protected]> wrote: >>>> >>>> I would also get rid of the author tags too. I guess that in many cases >>>> they >>>> are not correct anyway as files are constantly changed. >>> >>> exactly, and still svn (blame) knows everything... Original committer >>> and who introduced all the bugs ;-) >>> >>>> Michael >>>> >>>> Am 11.08.2010 08:22, schrieb Matthias Wessendorf: >>>>> >>>>> On Tue, Aug 10, 2010 at 11:55 PM, Bernd Bohmann >>>>> <[email protected]> wrote: >>>>>> >>>>>> Hello, >>>>>> >>>>>> why we need the @author tag? >>>>>> I don't like code owner ship. >>>>> >>>>> well, some do. I am fine without. In fact a lot of Apache project do so, >>>>> since >>>>> there is no "code-ownership". SVN has still all the information >>>>> >>>>>> Does your request mean we don't allow the svn:keywords=Date Author Id >>>>>> Revision HeadURL >>>>>> in the Subversion config file? >>>>> >>>>> I am sure the talk is *only* inside the Java files, and not removing >>>>> the metadata of the file. >>>>> >>>>> -M >>>>> >>>>>> Regards >>>>>> >>>>>> Bernd >>>>>> >>>>>> On Tue, Aug 10, 2010 at 10:00 PM, Jan-Kees van Andel >>>>>> <[email protected]> wrote: >>>>>>> >>>>>>> Hi, >>>>>>> >>>>>>> Sure. For example, take a look >>>>>>> at: >>>>>>> >>>>>>> http://svn.apache.org/repos/asf/myfaces/core/trunk/api/src/main/java/javax/faces/FacesException.java >>>>>>> If we remove the SVN stuff, we'll end up with this JavaDoc comment: >>>>>>> /** >>>>>>> * see Javadoc of<a >>>>>>> >>>>>>> >>>>>>> href="http://java.sun.com/javaee/javaserverfaces/1.2/docs/api/index.html";>JSF >>>>>>> Specification</a> >>>>>>> * >>>>>>> * @author Manfred Geiler >>>>>>> */ >>>>>>> >>>>>>> Or for >>>>>>> example: >>>>>>> >>>>>>> http://svn.apache.org/repos/asf/myfaces/core/trunk/api/src/main/java/javax/faces/application/Application.java >>>>>>> This would become: >>>>>>> /** >>>>>>> * ..... >>>>>>> * >>>>>>> * @author Manfred Geiler >>>>>>> * @author Stan Silvert >>>>>>> */ >>>>>>> >>>>>>> One last example, a class added in >>>>>>> 2.0: >>>>>>> >>>>>>> http://svn.apache.org/repos/asf/myfaces/core/trunk/api/src/main/java/javax/faces/application/ResourceHandler.java >>>>>>> Which would end up like: >>>>>>> /** >>>>>>> * @author Simon Lessard >>>>>>> * @since 2.0 >>>>>>> */ >>>>>>> >>>>>>> What do you think? >>>>>>> BTW. I'm thinking of the best way to do this. I guess the best bet is >>>>>>> to >>>>>>> do a massive find-replace on one project at a time. Generating a patch >>>>>>> file >>>>>>> would be a nice way to check for possible errors... >>>>>>> Regards, >>>>>>> Jan-Kees >>>>>>> >>>>>>> >>>>>>> >>>>>>> 2010/8/10 Leonardo Uribe<[email protected]> >>>>>>>> >>>>>>>> Hi >>>>>>>> >>>>>>>> Could you provide an explicit example about how the header of java >>>>>>>> files >>>>>>>> should be? >>>>>>>> >>>>>>>> best regards, >>>>>>>> >>>>>>>> Leonardo >>>>>>> >>>>> >>>>> >>> >>> >>> >> >> -- >> "There are two kinds of people in the world, those who believe there are two >> kinds of people and those who don't." >> — Robert Benchley >> > > > > -- > Matthias Wessendorf > > blog: http://matthiaswessendorf.wordpress.com/ > sessions: http://www.slideshare.net/mwessendorf > twitter: http://twitter.com/mwessendorf > -- Matthias Wessendorf blog: http://matthiaswessendorf.wordpress.com/ sessions: http://www.slideshare.net/mwessendorf twitter: http://twitter.com/mwessendorf
