Help Data


The help data XML file is used by products to control the order of books in the help table of contents, as well whether or not books or keyword index sets should be displayed at all. The file must be referenced in the product's plugin_customization.ini file using the property.

Configuration Markup:

<!ELEMENT extensions (tocOrder? , hidden?)>

The extension data for Help.

<!ELEMENT tocOrder (toc | category)*>

Specifies the order in which top-level table of contents entries (also called "books") or categories of books should appear in Help. If one of the items listed is not available, it is ignored. If there are items available that are not listed and not hidden, they will be displayed after the ones listed here.




A reference to a top-level table of contents (TOC) entry, also called a "book".

<!ELEMENT category EMPTY>

<!ATTLIST category


A reference to a category of top-level table of contents (TOC) entries (books). Categories are implicitly created when a table of contents contribution declares itself to be of that category, for example, by specifying a category attribute for the toc element in the extension point.

<!ELEMENT hidden (toc | category | index)*>

Contains a set of help items that should be hidden from the user.


<!ATTLIST index


A reference to a contribution of help index keywords.


The following example shows how to arrange the following books in the order shown:

As well as hide the following books/categories and related keyword indexes:

The markup would be the following:

      <toc id="/"/>

      <category id="user.content"/>
      <toc id="/"/>
      <toc id="/"/>

      <category id="isv.reference"/>
      <index id="/"/>
      <index id="/com.def.doc.isv/index.xml"/>

Supplied Implementation:
This API is supported by any help implementation that is based on, including the default help implementation provided by Eclipse.

Copyright (c) 2006, 2011 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