ah fsck... we are wrong.
Jörn Nettingsmeier wrote:
now the javadoc compiler is very very unhappy with our module names (i
guess it's the hyphen):
<snip>
are we outside the java specs with our hyphens?
i don't think so, because package names are meant to be mapped on
inverted URLs, and hyphens are legal in domain names.
yes we are:
http://java.sun.com/docs/books/jls/second_edition/html/packages.doc.html#40169
<quote>
In some cases, the internet domain name may not be a valid package name.
Here are some suggested conventions for dealing with these situations:
* If the domain name contains a hyphen, or any other special
character not allowed in an identifier (§3.8), convert it into an
underscore.
* If any of the resulting package name components are keywords
(§3.9) then append underscore to them.
* If any of the resulting package name components start with a
digit, or any other character that is not allowed as an initial
character of an identifier, have an underscore prefixed to the component.
</quote>
but if we are, the stuff needs to be renamed. which is a pity since it
can easily lead to all kinds of bugs and will royally screw up our svn
history with nonfunctional changes.
looks like we have to go through the mess...
i just wonder why the java compiler does not complain and the javadocs
generator does. anyway, unless someone digs up a more recent specs
document that explicitly declares hyphens legal in identifiers, we
should change our code to be compliant.
wdot?
--
jörn nettingsmeier
home://germany/45128 essen/lortzingstr. 11/
http://spunk.dnsalias.org
phone://+49/201/491621
if you are a free (as in "free speech") software developer
and you happen to be travelling near my home, drop me a line
and come round for a free (as in "free beer") beer. :-D
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
