Opening external documentation on macosx

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
--

7 comments
Comment actions Permalink

Hello berta,

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/d
ocs.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
--


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.


0
Comment actions Permalink

Alexander,

I forget to say that the same thing works perfectly with Idea 7, I believe it's an issue with Idea 8

0
Comment actions Permalink

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.


0
Comment actions Permalink

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.

0
Comment actions Permalink

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.

0
Comment actions Permalink

Hello Kevin,

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.


"jar:file:" URL does not work in IE 7.

You can create an issue in JIRA with request to change the error message.

Alexander.


0
Comment actions Permalink

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 .

0

Please sign in to leave a comment.