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 >> >> > -- Matthias Wessendorf blog: http://matthiaswessendorf.wordpress.com/ sessions: http://www.slideshare.net/mwessendorf twitter: http://twitter.com/mwessendorf
