Free Trial

Safari Books Online is a digital library providing on-demand subscription access to thousands of learning resources.

  • Create BookmarkCreate Bookmark
  • Create Note or TagCreate Note or Tag
  • PrintPrint
Share this Page URL
Help

Chapter 4. Embedded Documentation

Chapter 4. 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:


=back

See =over below.


=begin fmt

Sets the subsequent text up to a matching =end to be included only when processed for formatter fmt.


=cut

Ends a document section.


=end fmt

See =begin.


=for fmt

Restricts the remainder of just this paragraph to be included only when processed for formatter fmt.


=headN heading

Produces a heading. N must be 1, 2, 3, or 4.


=item text

See =over below.


=over N

Starts an enumeration with indent N. Items are specified using =item. The enumeration is ended with =back.


=pod

Introduces 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<escape>

A named character, e.g., E<lt> means a < and E<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<index>

An index entry.


Z<>

A zero-width character.

Markup sequences may be nested. If a markup sequence has to contain > characters, use C<< ... >> or C<<< . . . >>>, etc. The last of the opening < must be followed by whitespace, and whitespace must precede the first of the closing >.

perlpod, perlpodspec.

  • Safari Books Online
  • Create BookmarkCreate Bookmark
  • Create Note or TagCreate Note or Tag
  • PrintPrint