3.12.4 <refsyn>

The <refsyn> element is a special section inside a reference topic. The section often contains syntax or signature content (for example, the calling syntax for a command-line utility or an API signature). The <refsyn> contains a brief, possibly diagrammatic description of the subject's interface or high-level structure.

Content models

See appendix for information about this element in OASIS document type shells.


- topic/section reference/refsyn


Figure 1. Reference topic for software material
<reference id="MyAPI">
    <refsyn>Describe the MyAPI syntax here, possibly
using synph or syntax elements markup for explicit 
definition of syntax or prototype construction.</refsyn>


The following attributes are available on this element: Universal attribute group, outputclass, and spectitle.

Return to main page.