5.25. pod Filter


The general syntax is:

  !block pod[; parameters]

The parameters are:

Name Type Rule
main boolean  

See Understanding Filter Interfaces, if necessary.


The pod filter is used to nest POD text within an SDF document.

The main parameter is used to specify that the first paragraph after "=head1 NAME" is the document name. This parameter is used internally by the sdf program when it needs to convert a POD document to another format.


Some examples are:

    # Insert some pod
    !block pod
    A normal POD paragraph.

        And some verbatim text.

    # Get pod from a file
    !include "perlre.pod"; pod

    # Get pod from standard output
    !execute "getpod 'hello.c'"; pod