I figured it out. Incredibly, you cannot get this guidance from any of the eclipse forums.
All comments and corrections will be appreciated.
Here is an excerpt from a guidelines document I am distributing to my developers. Sorry, the images did not survive, but I think the text may be good enough.
I don't think anybody should have to spend the time I did figuring this out. I would like to suggest that Instantiations post something like this on its website, or better, automate this whenever File, New, SWT/JFace Project is invoked. That would add a lot of value and differentiate you from competitors. How hard would this be for you to do? Yes, Eclipse is general purpose and so is Designer, so the excuses for not doing this are well understood. But just look at how utterly essential and useful this is for anyone who has not memorized the entire SWT/JFace API (>95% percent of your users?), and also consider this would nned to be done for each and every project.
These instructions are narrowed to my company's specific environment in which we always install eclipse into c:\eclipse on windows PC's.
1. Find the following file:
2. Create folder: c:\eclipse_doc. Making this independent from c:\eclipse avoids having to recreate it if eclipse is ever deleted. Unzip doc.zip into this folder.
3. In the Package Explorer window, find the SWT and JFace library jar files. Starting with Eclipse 3.1, swt.jar has been renamed to the file highlighted in the screenshot below. JFace, which is not machine dependent, is the file shown right below it.
4. For each of the above jar files:
Â· Right click, select Properties.
Â· Select Java Build Path.
Â· Click on Browse.
Â· Navigate to C:/eclipse_doc/reference/api/
Â· Click on OK.
5. Click on Validate. Success looks like the following.
6. Now do the real test. In the source editor, click on an SWT control class name such as Combo (you can simply declare one or make one visually using the designer). Press F1. A window should appear with Javadoc for 'org.eclipse.swt.widgets.Combo'
7. Don't forget to do the same for the JFace library as well. Test this with a JFace class such as ApplicationWindow.