Whole document tree
    

Whole document tree

Synopsis

Synopsis

Name

Synopsis -- Syntax of a command or function

Description

Syntax of a command or function. It appears within RefSynopsisDiv, and may occur elsewhere in a document, too. Synopsis has an optional Title, followed by one or more in-line elements and Graphics; within it, line breaks and white space are significant. It has common attributes. CmdSynopsis and FuncSynopsis are alternates to Synopsis, but they may not contain Graphics and within them line breaks and white space are not significant.

Processing Expectations

Synopsis should be displayed as a block-oriented element, not in-line.

Attributes

Label

Label holds an identifying number or string to be output in some manner when the element it is applied to is rendered.

Format

Line ends and leading white space must be preserved in output.

Examples

<SYNOPSIS>if (<REPLACEABLE>condition</REPLACEABLE>) {
    <REPLACEABLE>commands</REPLACEABLE>
} else {
    <REPLACEABLE>commands</REPLACEABLE>
}</SYNOPSIS>