Рассмотрим, как добавлять справку к маркерам утилиты 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 будет показано описание справки.