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: dev-unsubscribe lenya.apache.org
For additional commands, e-mail: dev-helplenya.apache.org
|