Is there a Perl module that can split one file of the main file into several types?

Question

I want to write one Pod file for perlop and perlopref . My gut instinct should say something like

 =head1 PRECEDENCE blah =head1 OPERATORS =head2 "X" =for short The double quote circumflex operator surrounds an interpolating string. See L<perlop/"X">. =for long -head3 Description blah blah blah -head3 Example blah blah blah -head3 See Also blah blah blah =head2 qq(X) =for short The generalized double quote circumflex operator surrounds an interpolating string. See L<perlop/qq(X)> =for long -head3 Description blah blah blah -head3 Example blah blah blah -head3 See Also blah blah blah 

And let it produce (perlopref)

 =head1 PRECEDENCE blah =head1 OPERATORS =head2 "X" The double quote circumflex operator surrounds an interpolating string. See L<perlop/"X">. =head2 qq(X) The double quote circumflex operator surrounds an interpolating string. See L<perlop/"X">. 

and (perlop)

 =head1 PRECEDENCE blah =head1 OPERATORS =head2 "X" =head3 Description blah blah blah =head3 Example blah blah blah =head3 See Also blah blah blah =head2 qq(X) =head3 Description blah blah blah =head3 Example blah blah blah =head3 See Also blah blah blah 

Answer 1

I don’t think so, but I have a suggestion for a couple of places that you could start. The first is Pod :: Inherit , which is the tool that DBIx :: Class uses to create a POD that includes documentation of inherited methods from superclasses. The second is Pod :: Weaver , which is a universal POD munger used by Dist :: Zilla, which has its own flavor of rule-based configuration, and maybe it could do what you need without much work, but now he covers the documentation a bit.