SYNOPSIS

    In dist.ini:

     [InsertBlock]

    In lib/Foo/Base.pm:

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

    In lib/Foo/Bar.pm:

     ...
    
     =head1 ATTRIBUTES
    
     # INSERT_BLOCK: lib/Foo/Bar.pm base_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 is marked/defined using either this syntax:

     =for BEGIN_BLOCK: Name
    
     ...
    
     =for END_BLOCK: Name

    or this syntax:

     # BEGIN_BLOCK: Name
     ...
     # END_BLOCK: Name

    Block 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