Рассмотрим, как добавлять справку к маркерам утилиты readme. Для добавления справки к маркеру используется точка расширения org.eclipse.ui.ide.markerHelp. Эта точка расширения позволяет модулям связать ИД контекста справки с определенным типом маркера. Маркер может быть определен только по типу маркера или также и по значению одного их его атрибутов. Утилита readme объявляет несколько различных типов контекста справки:
<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>
...
Каждый контекст справки маркера задается для типа маркера readme. Однако каждый контекст справки связан с различной комбинацией значений атрибутов. Первый контекст справки для маркера будет использоваться для маркеров, атрибут id которых имеет значение "1234". Контексты справки задаются в файле HelpContexts.xml модуля:
<context id="marker_example1_context" > <description>Пример 1 для маркера Readme<b>Help</b> id = 1234 </description> </context>
Теперь при выборе маркера readme с id="1234" и вызове справки с помощью клавиши F1 будет показано описание справки.
