Table of Contents

verbatim

  This is verbatim

     with spaces and odd indention, 
        and no <BR> interpolation 
And this is after the verbatim.

include_verbatim

Next, we do include_verbatim:

=include_verbatim dummy.pdx

line 1: This is I<included> from the dummy.pdx file.
line 2: An embedded include, to another dir:
=include ../../doc/dummy.pdx
line 4
line 5
line 6: final line

include

Next we do a pdx include. We mark before and after with "|". Notice that it recursively nests files 3 levels, leading to the closing series of "line 4...".

=include dummy.pdx | line 1: This is included from the dummy.pdx file. line 2: An embedded include, to another dir: line 1: This is included from the dummy.pdx file. line 2: An embedded include line 1: This is doc/dummy2.pdx, included from doc/dummy.pdx file. line 2: An embedded include, to another dir:

line 1: This is I<included> from the dummy.pdx file.
line 2: An embedded include, to another dir:
=include ../../doc/dummy.pdx
line 4
line 5
line 6: final line

line 4 line 5 line 6: final line

line 4 line 5 line 6: final line

line 4 line 5 line 6: final line

|

Driver-specific includes

include_for

This allows inclusion of a pdx file taliored to a given driver

=include_for html dummy_html.pdx This is a block of pdx to be included only in html files. Thus it could be used for autogenerated chunks of html, generated elsewhere and placed here in a begin block. E.g.,:

This is raw HTML

=include_for latex dummy_latex.pdx

=include_for docbook dummy_docbook.pdx

include_raw

This allows inclusion of a raw driver-style file, for that driver

=include_raw html dummy_raw_html.html

This is raw HTML

=include_raw latex dummy_raw_latex.tex

=include_raw docbook dummy_raw_docbook.sgml

Cuts

Pod uses =cut to shift from pod to raw programming code, and =pod to shift back. This allows embedded documentation in perl modules.

Here is a cut. We shouldn't see anything during the cut: And now we are back in business.