[bduggan]

summary

Some UTF-8 characters in POD files are not rendering properly when rendered as HTML on GitHub.

fix

Add

binmode STDOUT, ':encoding(UTF-8)';

inside pod2html, so that output is properly utf8 encoded.

examples

https://github.com/Raku/old-design-docs/blob/master/S03-operators.pod

The text below is rendered as

X  Junctive and      & (&) ∩

but it should be

X  Junctive and      & (&) ∩

See #1637 for another example.

Note that both of these examples start with =encoding utf8 which indicates utf-8 encoded text.

testing

I added a test -- note that this test uses =begin html because Pod::Simple 3.48 escapes ordinary text to ASCII entities.

Sample local tests using that file:

before:

./pod2html /tmp/README.utf8.pod
<p>Latin-1 range:  </p>

Wide character in print at /Users/bduggan/perl5/perlbrew/perls/perl-5.44.0/lib/5.44.0/Pod/Simple/XHTML.pm line 737.
<p>Above Latin-1: ੦..੯ ٠..٩</p>

after:

./pod2html ../../../test/markups/README.utf8.pod
<p>Latin-1 range: «» é</p>

<p>Above Latin-1: ੦..੯ ٠..٩</p>

[Copilot]

🟢 Approval recommended

The review records no active issues with the UTF-8 conversion change or its regression-test fixtures.

No open issues 🎉

What changed in this PR

This pull request fixes UTF-8 encoding for .pod files converted to HTML, preventing non-ASCII characters from appearing as mojibake.

Changes:

• Enables UTF-8 encoding for pod2html output.
• Adds a POD fixture containing representative Unicode characters.
• Adds the expected UTF-8 HTML rendering.

File	Description
test/​markups/​README.utf8.pod.html	Adds expected UTF-8 HTML output.
test/​markups/​README.utf8.pod	Adds Unicode regression-test input.
lib/​github/​commands/​pod2html	Enables UTF-8 encoding for generated HTML output.

This pull request is too complex or risky for automated approval.

_{Review effort: Lite (auto)}