Embedded Documentation
Tools exist to extract embedded documentation and generate input suitable for several formatters like troff, LATEX, and HTML. The following commands can be used to control embedded documentation:
=backSee
=overon the next page.=beginfmtSets the subsequent text up to a matching
=endto be included only when processed for formatter fmt.=cutEnds a document section.
=endfmtSee
=begin.=forfmtRestricts the remainder of just this paragraph to be included only when processed for formatter fmt.
=headN headingProduces a heading. N must be 1, 2, 3, or 4.
=itemtextSee
=overbelow.=overNStarts an enumeration with indent N. Items are specified using
=item.The enumeration is ended with=back.=podIntroduces a document section. Any of the
=commands can be used to introduce a document section.
Each of the preceding commands applies to the paragraph of text that follows them; paragraphs are terminated by at least one empty line.
An indented paragraph is considered to be verbatim text and will be rendered as such.
Within normal paragraphs, markup sequences can be inserted:
B<text>Bold text (for switches and programs).
C<code>Literal code.
E<esc>A named character, e.g.,
E<lt>means a<andE<gt>means a>.F<file>Filename.I<text>Italic text (for emphasis and variables).
L<[ text|] [ ref ] [/section ]>A cross reference. text, if present, is used for output.
S<text>Text that cannot break on spaces.
X<idx>An index entry.
Z< >A zero-width character.
Markup sequences may be nested. ...