Providing online, context-sensitive help

Some UP.Phone models provide a HELP key. By default, when the user presses this key, the phone displays a message indicating that no help is available.

You can define HELP actions at the deck or the card level to provide context-sensitive help when the user presses the HELP key. A card-level HELP action supersedes a deck-level HELP action.

To keep navigation intuitive, you should always use the GOSUB task in HELP actions.

For example, the following deck provides context-sensitive help at the deck and the card level:

<HDML VERSION=3.0>
    <ACTION TYPE=HELP TASK=GOSUB DEST=#help1>
    <DISPLAY NAME=card1>
        <ACTION TYPE=ACCEPT TASK=GO DEST=#card2>
        This card does something obvious.
    </DISPLAY>
    <DISPLAY NAME=card2>
        <ACTION TYPE=HELP TASK=GOSUB DEST=#help2>
        This card does something really difficult.
    </DISPLAY>
    <DISPLAY NAME=help1>
        This is how you do the really obvious thing...
    </DISPLAY>
    <DISPLAY NAME=help2>
        Read the manual...
    </DISPLAY>
</HDML>

FIGURE  2-15.     Context-sensitive help