## Adding Plug-in Help

If you are creating a plug-in specifically for use with Carbide.c++ we recommend that any menu items you create be added to existing Eclipse menus or to the Carbide menu. The topics in this section include:

- Carbide Help Assistance
- Carbide Table of Contents Anchors
- Carbibe CSS
- Carbide F1 Help
- Carbide Cheatsheets

### Carbide Help Assistance

It is highly recommended that every plug-in that adds itself to the Carbide menu include help content. Except for highly unusual cases you can include the help content (html, xml, images, etc.) directly in the plug-in itself. This means that users only have a single plugin to install and the help comes along with it. In the event that your plugin involves several related plugins, as say, UI Designer does, then a separate help plugin may be the better solution.

### Carbide Table of Content Anchors

All plug-in tools that add themselves to the Carbide menu should install their help to the anchorCarbideMisc anchor point using the link_to command. This will correctly place the help content for the plug-in within the Carbide Help section of the Help window.

NOTE All other help content anchors are reserved for use by the Carbide team.

In the manuals main TOC file, for the <toc> keyword, add the command:

link_to="../com.nokia.carbide.help.common/carbideHelpTOC.xml#anchorCarbideMisc"

The complete line might look something like this:

<toc label="Carbide.c++ Plug-in Developer Guide" link_to="../com.nokia.carbide.help.common/carbideHelpTOC.xml#anchorCarbideMisc" >

See the Eclipse documentation Platform Plug-in Developer Guide > Programmer's Guide > User assistance support > Help > Help content for more information on content assist help.

### Carbide CSS

To enable your manual to match the style used by the Carbide documentation, use the book.css file as your style sheet. We recommend that you access the copy in the com.nokia.carbide.cpp.ui plug-in to ensure you are always using the latest version. In the <head> section of your HTML files, use the following line:

<link rel="StyleSheet" href="../book.css" type="text/css" />

If that is not possible, feel free to add a copy to your plug-in and call it from there.

### Carbide F1 Help

Your help content can also include F1 help using the Eclipse help system. All you need is the help menu ID of the window or view you want to attach F1 help to, an XML file containing the links to the help content, and the correct extension point additions to the plugin's plugin.xml file.

##### Help Menu IDs

Right now, the best way to get the help menu IDs for a specific Carbide view or wizard is to examine the xml files inside the html/context_help directory of official Carbide manuals.

##### Context Help XML Files

Every context help XML file in the various Carbide.c++ manuals contain the F1 help for a specific plugin. The XML file name identifies the specific Carbide plugin that help is associated with and all the help menu IDs you can use.

##### Plugin.xml Extensions

To add your context help to the F1 help simply add the reference to your context help xml file to the extension point "org.eclipse.help.contexts" as shown below:

<extension point="org.eclipse.help.contexts" >
<!-- CARBIDE DEBUG UI HELP (BRKPT, VAR, EXPR, etc) -->
<contexts file="html/context_help/org_eclipse_debug_ui.xml"
plugin="org.eclipse.debug.ui" />
</extension>

See the Eclipse documentation Platform Plug-in Developer Guide > Programmer's Guide > User assistance support > Help > Context sensitive help for more information on content assist help.

### Carbide Cheatsheets

Use the cheatsheet extension point to add any cheatsheet content to the cheatsheet list. Cheatsheets should be limited to very complex or long tasks. It is really not recommended for small tasks that a few tutorial steps can satisfy.

Currently, the categories you can link to when adding your cheatsheet include:

- IDE: <category id="com.nokia.carbide.ide.cheatsheets">
- TRK: <category id="com.nokia.carbide.trk.cheatsheets" >
- Tools: <category id="com.nokia.carbide.cpp.tools.cheatsheets" >

See the Eclipse documentation Platform Plug-in Developer Guide > Programmer's Guide > User assistance support > Cheat sheets for more information on cheatsheets.