Re: CVS update: ADDED: subversion/bindings/java/jni/org/tigris/subversion REMOVED: subversion/bindings/java/jni/org/tigris/subversion

[cm...@collab.net]

Alexander Mueller <al...@littleblue.de> writes:

> 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!

While I agree with the sentiment behind Hunt/Thomas' alleged
statements, I think 'cvs annotate' (and soon, 'svn blame')
accomplishes the task without violating the policies in place for this
project.

> The "@" tags are javadoc tags which are used by the "javadoc" tool
> which is used to generate the automatic documentation system.

Hee hee...I knew this one!  I knew this one!

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@subversion.tigris.org
For additional commands, e-mail: dev-help@subversion.tigris.org

Re: CVS update: ADDED: subversion/bindings/java/jni/org/tigris/subversion REMOVED: subversion/bindings/java/jni/org/tigris/subversion

[Alexander Mueller <al...@littleblue.de>]

cmpilato@collab.net schrieb:

> Alexander Mueller <al...@littleblue.de> writes:
>
> > 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!
>
> While I agree with the sentiment behind Hunt/Thomas' alleged
> statements, I think 'cvs annotate' (and soon, 'svn blame')
> accomplishes the task without violating the policies in place for this
> project.

but this way the comments are "only" in the repository. When I am offline with
my notebook; having a look at a file; no repository access. The I really
enjoy having comments in the file itself including as much information as
possible.

The file itself is one dimension, the repository information is another dimension.
Having access to both gives you all the information you need and
a "two dimensional" system.

Having no annotation in the file or wherever leaves you out in the rain.
But I guess this discussion is pretty philosophical and so the
opinions are quite personal...

>
>
> > The "@" tags are javadoc tags which are used by the "javadoc" tool
> > which is used to generate the automatic documentation system.
>
> Hee hee...I knew this one!  I knew this one!
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@subversion.tigris.org
> For additional commands, e-mail: dev-help@subversion.tigris.org

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@subversion.tigris.org
For additional commands, e-mail: dev-help@subversion.tigris.org