How do I add formatting in a link in Perl Pod?

223 views Asked by At

I wonder: I have some POD with =items like this:

=item B<some-option=>I<some_value>

When I try to create a link in the text, none of those works:

L<B<some-option=>I<some_value>>, L<some-option=some_value>

Using pod2html I see that there are name= for the =items, but the L<..> command just produces <em>...</em> output.

How can I create a proper link for the =item?

Here's a short sample POD:

=pod

See L<B<--some-option=>I<some_value>> or L<--some-option=some_value>.

=over

=item B<--some-option=>I<some_value>

Blabla...

=back

Also podchecker --warnings --warnings --warnings says pod syntax OK..

1

There are 1 answers

5
haarg On BEST ANSWER

To nest formatting codes, the outer one needs an extra set of angle brackets and some white space. The white space is ignored in the output.

L<< /B<some-option=>I<some_value> >>

This is documented in the Formatting Codes section of perlpod after the list of codes.