Common Desktop Environment: Help System Author's and Programmer's Guide

Formal Markup Caveats

Shorthand and formal markup share a common set of elements, such as chapter, section, head, list, paragraph, and so forth. However, formal markup differs from shorthand markup in these important ways:

Explicit Start and End Tags

Each element, its component parts, and elements it contains must be explicitly tagged. For example, here is the formal markup for a chapter head. To read this, and other markup examples easily, tags are indented. Indentation is not required in actual markup.

              <partext>Front Panel Help</partext>

Notice the additional tags, <head> and <partext>; these are subcomponents of the <chaphead> element. Each of these elements requires an explicit start and end tag.