Frank Barnaby wrote:
I had tested the javadoc target after changing the headers and
api-copyright attribute, and my build worked well and continues to work
> well now. What platform did you use for your build?
I did try to build on Windows XP with J2SE 1.4.2 and 5.0 under the
windows shell and Cygwin, with the UK English locale. As you indicated
that your build (likely on a UNIX like OS) did work I thought it might
have to do with some limitation on the size of arguments but this is not
the case. It turns out when I change in the 'api-copyright' property
"AS IS" into 'AS IS' the javadoc generation works.
There is something with "AS IS" that makes it behave in a
strange way, and finally I found out that is doesn't like the whitespace
in between the quotes. If you rewrite it as "AS-IS" it
suddenly works on Windows.
But I wonder also whether we should keep the large license footer at the
bottom of the Javadoc. I did a quick look and it seems that at least
some Apache projects have only a short statement such as:
Copyright © 2001-2006 The Apache Software Foundation. All Rights
Reserved.
But I must admit I liked the old JTSK footer even better (more correct)
as it refers to the ALv2, which is:
Copyright 2005, Sun Microsystems, Inc.
Licensed under the Apache License, Version 2.0.
(hyperlink to ALv2)
So if possible I would go for something like:
Copyright 2007, The Apache Software Foundation.
Licensed under the Apache License, Version 2.0.
(hyperlink to ALv2)
--
Mark
