Some Eclipse Foundation services are deprecated, or will be soon. Please ensure you've read this important communication.

Bug 29390

Summary: Setting javadoc for swt.jar is a bit longwinded
Product: [Eclipse Project] PDE Reporter: Oyvind Harboe <oyvind.harboe>
Component: UIAssignee: PDE-UI-Inbox <pde-ui-inbox>
Status: RESOLVED DUPLICATE QA Contact:
Severity: enhancement    
Priority: P3 Keywords: helpwanted
Version: 2.1   
Target Milestone: ---   
Hardware: All   
OS: All   
Whiteboard:

Description Oyvind Harboe CLA 2003-01-13 10:28:44 EST 
I love the feature that I can link Javadoc to the .jars I use. This is 
particularly useful for complex libraries like SWT and the JRE.

However, I believe that setting up swt to look up javadocs could be more obvious
(better marketing of this excellent feature).

Here are the steps required today:

1. Create a docs directory on disk(e.g. c:\docs)
2. unzip  ..\m4\plugins\org.eclipse.platform.doc.isv_2.1.0\doc reference*
3. Right click on the swt.jar in the project to point to the unzipped javadocs. 
c:\docs\reference\api

The problem with the approach above is that it requires the user to "discover" 
a number of things before he gets up and running. Also, these steps have to be 
repeated on each developer machine participating in a project.

Possible enhancements?

- Add automagic setup of javadoc for JRE
- Add automagic setup of javadoc for SWT

Øyvind
Comment 1 Dirk Baeumer CLA 2003-01-13 12:10:55 EST 
No action planned for 2.1 (unless we get external support).
Comment 2 Oyvind Harboe CLA 2003-01-13 12:13:36 EST 
>No action planned for 2.1 (unless we get external support).

I would have made this a feature request for >2.1, but the enhancement request 
does not list include 2.2. 

Perhaps there should be "whenever" for feature requests?
Comment 3 Dirk Baeumer CLA 2003-04-02 08:46:34 EST 
Reopening...
Comment 4 Dirk Baeumer CLA 2003-04-02 08:48:09 EST 
For JRE this now can be done using the Installed JREs preference page. When 
importing Eclipse plug-ins this is best done by PDE since it knows about the 
layout of the Eclips installation. Moving to PDE.
Comment 5 Wassim Melhem CLA 2004-02-25 21:12:18 EST 

*** This bug has been marked as a duplicate of 52894 ***