[bduggan]

Add

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

inside pod2html, so that output is properly utf8 encoded.

Currently, some UTF-8 characters in pod files are producing mojibake when rendered as HTML on GitHub.

Example:

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

X  Junctive and      & (&) ∩

but this should be

X  Junctive and      & (&) ∩

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

See #1637 for another example.

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

[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)}