NAME

Pod::Simple::Role::XHTML::RepairLinkEncoding - Repair encoding of section links

SYNOPSIS

package MyPodParser;
with 'Pod::Simple::Role::XHTML::RepairLinkEncoding';

my $parser = MyPodParser->new;
$parser->output_string(\my $html);
$parser->parse_string_document($pod);

DESCRIPTION

Pod::Simple (until at least 3.47) doesn't handle encoding of section link correctly if they contain non-ASCII characters. It will do "percent" encoding, but does not first encode as bytes, so it generates invalid sequences. The fragments generated from section links must be encoded as UTF-8 before being percent encoded.

Applying this role will repair this, generating the correct fragments.

This role should usually not be used directly. A future version of Pod::Simple will fix this, but until then it is used internally by Pod::Simple::Role::XHTML::WithAccurateTargets.

SUPPORT

See MetaCPAN::Pod::HTML for support and contact information.

AUTHORS

See MetaCPAN::Pod::HTML for authors.

COPYRIGHT AND LICENSE

See MetaCPAN::Pod::HTML for the copyright and license.