An dieser Stelle soll nun erläutert werden, wie eine Hilfefunktion zu den Markierungen des Tools für Readme-Dateien hinzugefügt werden kann. Markierungshilfen werden über den Erweiterungspunkt org.eclipse.ui.ide.markerHelp hinzugefügt. Über diesen Erweiterungspunkt können Plug-ins einen bestimmten Markierungstyp der ID eines Hilfekontexts zuordnen. Die Markierung kann nur über den Markierungstyp oder über den Wert eines oder mehrerer der zugehörigen Attribute qualifiziert werden. Das Tool für die Readme-Dateien deklariert mehrere verschiedene Hilfekontexte:
<extension point="org.eclipse.ui.ide.markerHelp"> <markerHelp markerType="org.eclipse.ui.examples.readmetool.readmemarker" helpContextId="org.eclipse.ui.examples.readmetool.marker_example1_context"> <attribute name="org.eclipse.ui.examples.readmetool.id" value= "1234"/> </markerHelp> <markerHelp markerType="org.eclipse.ui.examples.readmetool.readmemarker" helpContextId="org.eclipse.ui.examples.readmetool.marker_example2_context"> <attribute name="org.eclipse.ui.examples.readmetool.level" value= "7"/> </markerHelp> <markerHelp markerType="org.eclipse.ui.examples.readmetool.readmemarker" helpContextId="org.eclipse.ui.examples.readmetool.marker_example3_context"> <attribute name="org.eclipse.ui.examples.readmetool.level" value= "7"/> <attribute name="org.eclipse.ui.examples.readmetool.department" value= "infra"/> </markerHelp> ...
Jeder Markierungshilfekontext wird für den Readme-Markierungstyp definiert. Jedem Hilfekontext wird jedoch eine andere Kombination von Attributswerten zugeordnet. Der erste Markierungshilfekontext wird für Markierungen verwendet, deren Attribut id auf "1234" eingestellt ist. Die Hilfekontexte werden in der Datei HelpContexts.xml des Plug-ins definiert:
<context id="marker_example1_context" > <description>Readme marker example 1 <b>Help</b> id = 1234 </description> </context>
Auf diese Weise kann durch Auswahl einer Readme-Markierung mit der Einstellung id="1234" und durch anschließende Auswahl der Hilfetexte über F1 die Hilfebeschreibung angezeigt werden.