refsyn

Darwin Information Typing Architecture (DITA) Version 1.3 Part 2: Technical Content Edition

version
1.3
author
OASIS DITA Technical Committee

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.

Inheritance

- topic/section reference/refsyn

Example

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

Attributes

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