javadoc tag: @(#)

[Nathan Levi]

Hi.

Always wanted to know but was afraid to ask:

what these javadoc tags do: @(#) ?

for example, line 2 here:

/*
* @(#)Semaphore.java 1.13 06/03/30
*
* Copyright 2006 Sun Microsystems, Inc. All rights reserved.
* SUN PROPRIETARY/CONFIDENTIAL. Use is subject to license terms.
*/

Thanks.

[Campbell Ritchie]

There is a Javadoc reference: here is the Windows version. It's not easy reading, but there is a list of tags about half-way down.

[Nathan Levi]

Campbell, hi;

Thank you for your note;

YES, I went through the spec already couple of times,
still have no clue what '@(#)' means.

And '@(#)' is all over the Sun API;
Sun API people, anyone? :-)

Thanks.

[Paul Sturrock]

Its not a standard JavaDoc tag as far as I am aware. Run it through JavaDoc, see what it sayd - my guess is it will compain about an uynrecognised tag. Maybe they are using some other metadata parser in addition to JavaDoc? A guess would be some sort of release management tool given the example you show highlights version number and date.

[Rob Spoor]

Also note that that "tag" is not inside a Javadoc comment - it's a regular comment.

[Nathan Levi]

Paul, Rob, thank you for your notes;

YES, you are both right:

1) this is not having any effect on generated javadoc ...

2) ... because this is not a part of javadoc comment!

Still, the mystery remains: what the heck Sun was doing
and still doing with these comments? :-)

Thanks!

[Bauke Scholtz]

It is part of some content version system.

[Bert Bates]

intermediate

[Nathan Levi]

Bauke, Bert, thanks!

Any links, references, by chance? :-)