Greg Stein schrieb:
> On Thu, Aug 09, 2001 at 05:24:41PM -0000, XelaRellum@tigris.org wrote:
> >...
> > Index: Client.java
> > ===================================================================
> > package org.tigris.subversion.lib;
> >
> > /**
> > * public interface for libsvn_client
> > *
> > * ====================================================================
> > * Copyright (c) 2000-2001 CollabNet. All rights reserved.
> > *
> > * This software is licensed as described in the file COPYING, which
> > * you should have received as part of this distribution. The terms
> > * are also available at http://subversion.tigris.org/license-1.html.
> > * If newer versions of this license are posted there, you may use a
> > * newer version instead, at your option.
> > * ====================================================================
> > *
> > * @author Alexander.Mueller@littleblue.de
> > * @version 0.0
>
> We normally do not attribute specific authors in the SVN files. Personally,
> I would be more comfortable to stick with that precedent.
Hmm. Personally I do share the opinion of Andrew Hunt and David Thomas, authors of the
great book "The Pragmatic Programmer". The opinion is, it is important to label files and
methods with author's name. So everybody knows who to ask, for the programmer to feel
more responsible for the code and last but not least to have something to be proud of!
> I'm not sure what the @version is about, but I would think it could it go
> to(?) I know that we don't have anything to look for it now. Is there some
> other kind of packager or something that looks for that?
The "@" tags are javadoc tags which are used by the "javadoc" tool which is used to
generate the automatic documentation system.
> [ if some kind of packager requires @author, then you could put "the
> Subversion team" or somesuch ]
>
> Cheers,
> -g
Alex
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@subversion.tigris.org
For additional commands, e-mail: dev-help@subversion.tigris.org
Received on Sat Oct 21 14:36:35 2006