Till now, there was no connection between the PDT-Eclipse help system
and the real PDT help table of content (TOC).
I've made some changes that will enable easy connection to the existing
TOC by accessing an interface that contains all the existing topics in
the Help documentation. 
 
The interface name is IPHPHelpContextIds and it is located under
org.eclipse.php.internal.ui package.
This interface is the connecting part between the java code and the
help-context id's that are defined in the helpContexts.xml and directing
the help system to the correct page in the PDT help.
 
This interface and the helpContexts.xml files were auto-generated using
the HelpContextGenerator class that was added to the PDT's help plug-in
(The generation was done by traversing the toc.xml of the help plug-in).
Note that the IPHPHelpContextsIds interface is indented according to the
TOC and contains comments with the paths to the help pages for the
context id's.
 
In order to connect the help to your component (preferences page, dialog
or any other part) you should add a single line that will do the trick.
For example:
PlatformUI.getWorkbench().getHelpSystem().setHelp(composite,
IPHPHelpContextIds.INCLUDE_PATHS);
 
Please go over the components that are under your responsibilities and
add/update your help context id's.
 
Notes:

*       In case you are using a preferences block that extends that
AbstractConfigurationBlockPreferencePage you should change the
getHelpId() method to reflect the TOC help id in the IPHPHelpContextIds
interface.
*       Go over the IPHPHelpContextIds interface constants to see if
there are any missing TOC topics that you would like to add (notify
Keren).
*       Any change that you make in your code should be made to the HEAD
and to the R1_0_3_20080406 branch.

Thanks, 
Shalom Gibly
PDT
_______________________________________________
pdt-dev mailing list
[email protected]
https://dev.eclipse.org/mailman/listinfo/pdt-dev

Reply via email to