SYNOPSIS

    In dist.ini:

     [InsertBlock]

    In lib/Foo/Base.pm:

     ...
    
     =head1 ATTRIBUTES
    
     =for BEGIN_BLOCK: attributes
    
     =head2 attr1
    
     =head2 attr2
    
     =for END_BLOCK: attributes
    
     ...

    In lib/Foo/Bar.pm:

     ...
    
     =head1 ATTRIBUTES
    
     # INSERT_BLOCK: lib/Foo/Bar.pm attributes
    
     =head2 attr3
    
     ...

DESCRIPTION

    This plugin finds <# INSERT_BLOCK: <file <name> >> directive in your
    POD/code, find the block of text named name in file, and inserts the
    block of text to replace the directive.

    Block of code is enclosed using either this syntax:

     # BEGIN_BLOCK: Name
     ...
     # END_BLOCK: Name

    or this syntax:

     # BEGIN_BLOCK: Name
     ...
     # END_BLOCK: Name

    Name is case-sensitive.

    This plugin can be useful to avoid repetition/manual copy-paste, e.g.
    you want to list POD attributes, methods, etc from a base class into a
    subclass.

SEE ALSO

    Dist::Zilla::Plugin::InsertCodeResult

    Dist::Zilla::Plugin::InsertCodeOutput

    Dist::Zilla::Plugin::InsertCommandOutput

    Dist::Zilla::Plugin::InsertExample - which basically insert whole files
    instead of just a block of text from a file