Opening external documentation on macosx Follow
MacOSX 10.5.5
java version "1.5.0_16"
Got the following error trying to open external documentation:
Cannot show "jar:///System/Library/Frameworks/JavaVM.framework/Versions/1.5/Home/docs.jar!/doc/api/java/lang/String.html" in external browser
I've checked JavaDoc Paths in Platform Settings and the paths are correct.
Btw, if I let JavaDoc Paths points to the online documentation "http://java.sun.com/j2se/1.5.0/docs/api", external documentation open up perfectly on the browser.
Thanks for your help,
Mauro
--
Please sign in to leave a comment.
Hello berta,
Probably the browser cannot open files from jar archives. (I suppose all
browsers can't.) You can try to open one manually in the browser to check,
is that true or not.
Alexander.
Alexander,
I forget to say that the same thing works perfectly with Idea 7, I believe it's an issue with Idea 8
I see the same browser error in versions 7 and 8.
When version 7 successfully shows the docs to you, what is the URL in browser
address field?
Alexander.
This issue annoyed me also. None of these web browsers worked: the latest versions of Safari, Firefox, and Opera (when defined as the default web browser for the OS). I tried this in IDEA 7 and 8. In fact, the failure occurs so fast that it seems possible that the web browser is not involved in the failure.
Can't IntelliJ default to the on-line API docs instead? If not, it would be more "pleasurable" to have a more informative error message for us Mac OS X users.
BTW, is the URI that IntelliJ uses even formally correct? If the URI jar:///Library/Java/Home/docs.jar!/doc/api/java/lang/String.html is rewritten to jar:file:/Library/Java/Home/docs.jar!/doc/api/java/lang/String.html, then it works with Firefox but not the other browsers. If the jar:file: syntax works with IE, then maybe IntelliJ could adopt this convention, and the error message could be changed to add "If this doesn't work with your default web browser, try making Firefox your default browser".
Just for the record, I'm using Mac OS X 10.5.5.
Sorry Alexander you're right, it's the same issue with Idea 7 and 8.
My Idea 7 docs path was pointing to a local directory, that's why it works.
Hello Kevin,
"jar:file:" URL does not work in IE 7.
You can create an issue in JIRA with request to change the error message.
Alexander.
Such URLs should work in Firefox. For browsers not supporting jar URLs one should specify JavaDoc URL on the server or local directory with unpacked html files.
There is already JIRA issue: http://jetbrains.net/jira/browse/IDEABKL-4768 .