[Mulgara-general] javadoc build fails

[Paul Gearon]

On Jun 16, 2007, at 4:26 PM, thomas wrote:
>> I'm assuming you ran this under jdk 1.5?
>
> yep, on mac os x 10.4.9
>
>> And didn't you get something
>> like
>>
>>   java.util.MissingResourceException: Can't find resource for bundle
>> com.sun.tools.doclets.formats.html.resources.standard, key
>> doclet.malformed_html_link_tag
>>
>> ? This ones is a bug in java 1.5's javadoc:
>> http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=5082928
>
> yep again!
>
>> Anyway, I've just ended up using java 1.6 to build the javadocs (it's
>> also noticeably faster).
>
> uhaa, installing a new sdk just for the compilation of javadocs?  
> couldn't that easily ruin my weekend...? well, i'll see. are you on  
> a mac? seems to me like there is no jdk available, but i might be  
> wrong. i find the download section quite confusing

Maybe we should adjust our javadoc to not trigger this bug.  After  
all, it's being caused by a malformed link.  (Or does "malformed" in  
this case simply refer to the "missing" links in the local jdk?)

As for the next email....

>> uhaa, installing a new sdk just for the compilation of javadocs?  
>> couldn't
>> that easily ruin my weekend...? well, i'll see. are you on a mac?  
>> seems to
>> me like there is no jdk available, but i might be wrong. i find the
>> download section quite confusing
>
> No, sorry, I'm on Linux But I'm quite sure there's a 1.6 jdk for the
> Mac.
>
> Alternatively you could try and find what exactly it's choking on -
> tried the regexp in that bug report and found one potential candidate
> in MimeMessageToPart.java, but changing that didn't seem to help.

There is a 1.6 jdk, and it's a simple install.

The problems here are twofold:
1. You can't build "dist" target on 1.6.  I've been meaning to get to  
this, but it got pushed to the backburner while I worked on other  
issues.
2. You really don't want to use 1.6 on a Mac yet, as there is no  
JIT!  Yes, you read that right.  It's over a year later, and Apple  
only makes computers with Intel chips in them (the same chip that has  
a JIT in 2 other major operating systems), and yet the JIT hasn't  
been ported.  I spoke with a manager at Sun at SemTech, and he seemed  
quite frustrated with Apple (as am I!).  It's almost enough to make  
me install Linux on this iMac.

This said, I've installed Java 1.6 on a Mac, and it works fine.  Just  
make sure that it isn't your "current" JDK.  (make sure /System/ 
Library/Frameworks/JavaVM.framework/Versions/CurrentJDK points at / 
System/Library/Frameworks/JavaVM.framework/Versions/1.5 and not / 
System/Library/Frameworks/JavaVM.framework/Versions/1.6)

You can then set your JAVA_HOME to /System/Library/Frameworks/ 
JavaVM.framework/Versions/1.6:

$ export JAVA_HOME=System/Library/Frameworks/JavaVM.framework/ 
Versions/1.6
$ ./build.sh javadoc

Regards,
Paul