I want to write one Pod file for perlop
and perlopref
. My gut instinct is to 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 have 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