JDK documentation in IntelliJ IDEA on Mac OS X

JavaMacosIntellij IdeaJavadoc

Java Problem Overview


I'd like to know how to setup IntelliJ to point to the JDK documentation so the documentation popups that display during code completion will show me what the function I'm looking at is going to do. For some reason IntelliJ isn't able to find the JavaDocs by default.

I'm also not 100% sure that the documentation is installed with the JDK that's installed with the OS. I don't see them in /System/Library/Frameworks/JavaVM.framework/ but I may be looking in the wrong place. If it's not included, I'd also like to know what needs to be downloaded and where it needs to be installed to get the JavaDocs for the JDK to show up in IntelliJ.

Java Solutions


Solution 1 - Java

I had to combine the responses I got to this point and add a few extra details so I'm answering my own question.

  1. Search for "Java developer" from Downloads for Apple Developers

  2. Download and install "Java for Mac OS X 10.6 Update 9 Developer Package" (or later).

  3. In IntelliJ, open File -> Project Structure.

  4. Click on "SDKs" under "Platform Settings".

  5. Add the following paths under the "Documentation Paths" tab (the paths may be different based on which JDK you're using):

    /Library/Java/JavaVirtualMachines/1.6.0_29-b11-402.jdk/Contents/Home/docs.jar!/docs/api  
    /Library/Java/JavaVirtualMachines/1.6.0_29-b11-402.jdk/Contents/Home/appledocs.jar!/appledoc/api
    
  6. Add the following path under the Sourcepath tab:

    /Library/Java/JavaVirtualMachines/1.6.0_29-b11-402.jdk/Contents/Home/src.jar!/src
    

Thanks, @Yishai for the download location and @Gareth Davis for the location of the documentation after installing.

Update for 10.7/10.8 [Mountain] Lion:

Steps are the same except for these changes:

  1. In step 2, download "Java for OS X 2012-005 Developer Package" (or later).

  2. Use these paths instead in step 5.

    /Library/Java/JavaVirtualMachines/1.6.0_35-b10-428.jdk/Contents/Home/docs.jar!/docs/api  
    /Library/Java/JavaVirtualMachines/1.6.0_35-b10-428.jdk/Contents/Home/appledocs.jar!/appledoc/api
    
  3. Use these paths instead in step 7.

    /Library/Java/JavaVirtualMachines/1.6.0_35-b10-428.jdk/Contents/Home/src.jar!/src  
    

Solution 2 - Java

Quick (and dirty?) solution: Point IntelliJ to http://download.oracle.com/javase/6/docs/api/

Solution 3 - Java

have you installed the Apple Java Developer package?

It provides src.jar and docs.jar in /Library/Java/JavaVirtualMachines/1.6.0_22-b04-307.jdk/Contents/Home

Note this is since update 3. If these are present Intellij will just find them, or at least mine did.

details are in the Java update release notes

Solution 4 - Java

This should tell you what you need to know: Get local copies of Mac OS X Java source code and Javadoc – Concord Consortium wiki.

That page recommends going to https://connect.apple.com and downloading and installing “Java for Mac OS X 10.5 Update 2 Developer Documentation (Disk Image)” or the equivalent newer release. It describes a few ways to view the documentation, based on the Java jar file being located at a path like this:

/System/Library/Frameworks/JavaVM.framework/Versions/1.6.0/Home/src.jar

Attributions

All content for this solution is sourced from the original question on Stackoverflow.

The content on this page is licensed under the Attribution-ShareAlike 4.0 International (CC BY-SA 4.0) license.

Content TypeOriginal AuthorOriginal Content on Stackoverflow
QuestionChris WilliamsView Question on Stackoverflow
Solution 1 - JavaChris WilliamsView Answer on Stackoverflow
Solution 2 - JavaArne EvertssonView Answer on Stackoverflow
Solution 3 - JavaGareth DavisView Answer on Stackoverflow
Solution 4 - JavaYishaiView Answer on Stackoverflow