For defining context-sensitive help for an individual plug-in.

Configuration Markup:

<!ELEMENT extension (contexts | contextProvider)+>

<!ATTLIST extension





<!ELEMENT contexts EMPTY>

<!ATTLIST contexts




a context-sensitive help contribution made by supplying an XML file

<!ELEMENT contextProvider EMPTY>

<!ATTLIST contextProvider



(since 3.3) a context-sensitive help contribution made by supplying a java class to generate the content at run-time

The following is an example of using the contexts extension point:
(in file plugin.xml)

   <extension point=""> 
      <contexts file="xyzContexts.xml"/> 

(in file xyzContexts.xml)

      <context  id="generalContextId">
        <description> This is a sample F1 help string.</description>
        <topic href="contexts/RelatedContext1.html"  label="Help Related Topic 1"/>
        <topic href="contexts/RelatedContext2.html"  label="Help Related Topic 2"/>

Externalizing Strings The Context XML files can be translated and the resulting copy (with translated descriptions labels) should be placed in nl/<language>/<country> or nl/<language> directory.  The <language> and <country> stand for two letter language and country codes as used in locale codes.  For example, Traditional Chinese translations should be placed in the nl/zh/TW directory.  The nl/<language>/<country> directory has a higher priority than nl/<language>.  Only if no file is found in the nl/<language>/<country>, the file residing in nl/<language> will be used.  The the root directory of a plugin will be searched last.

The related topics contained in can be localized by creating a file with translated version of documents, and placing in
nl/<language>/<country> or nl/<language> directory. The help system will look for the files under this directories before defaulting to plugin directory.

API Information:
An implementation of must be supplied if a contextProvider is used.

Supplied Implementation:
The default implementation of the help system UI supplied with the Eclipse platform fully supports this extension point.

Copyright (c) 2000, 2006 IBM Corporation and others.
All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at