I think we may be reading too much into the ASF guidelines by
recommending we remove @author tags. I know for sure that Apache is
not enforcing this guideline very strictly. For example, look at the
author tags for this source file:
http://svn.apache.org/repos/asf/tomcat/container/tc5.5.x/catalina/src/share/org/apache/catalina/realm/JAASCallbackHandler.java
(heh)
I agree with Murray: @author tags are valuable because they help
identify expertise and knowledge associated with particular bits of
code. They are good for "archeology." Removing them would do more harm
than good.
On an upbeat note: congrats to the team, collectively, for the 2.6
release. Onwards and upwards to 2.8! I'm going to check in my first
bits (some auth code refactoring) today.
Andrew
On Mar 30, 2008, at 5:23 AM, Janne Jalkanen wrote:
That is my understanding, yes. Perhaps our mentors can tell us more?
(In any case, you should go to the -user and -dev mailing lists
instead of the people personally if there is a problem. These are
ASF projects, not any individual's. I tend to ignore personal
emails asking talking about JSPWiki these days. Most things are
better discussed on the mailing list.)
/Janne
On 30 Mar 2008, at 10:35, Murray Altheim wrote:
Janne Jalkanen wrote:
Hi ho folks!
[...]
* Code needs also to be attributed to the ASF - so no more @author
-tags.
Is this an Apache rule? If it isn't, I would *much* prefer to keep
the
author tags (which aren't a copyright issue, they provide necessary
and
often valuable attribution, e.g., who to go to when there's a
problem).
I think it'd be a real mistake to remove them if we didn't have to
(and
if we did, while I know it'd be pointless to argue with the Apache
Foundation over this, I do think it's a Bad Idea not to include
author
information.
Murray
...........................................................................
Murray Altheim <murray07 at altheim.com>
=== = =
http://www.altheim.com/murray/
= = ===
SGML Grease Monkey, Banjo Player, Wantanabe Zen Monk
= = = =
Boundless wind and moon - the eye within eyes,
Inexhaustible heaven and earth - the light beyond light,
The willow dark, the flower bright - ten thousand houses,
Knock at any door - there's one who will respond.
-- The Blue Cliff Record
