[texdoc] Weird behavior of `texdoc'

Yudai NAKATA yudai.nkt at gmail.com
Mon Feb 13 12:32:32 CET 2017

Dear Dr. Manuel Pégourié-Gonnard,

This is Yudai Nakata, a TeX Live user from Japan.

I am emailing you as I’ve found that texdoc seems to fail treating
character encoding properly
and hence some READMEs get corrupted on the terminal.

I take bxjalipsum package (https://www.ctan.org/pkg/bxjalipsum) as an
example here.
In README.md, you will find a line saying

> - `*.sty` → $TEXMF/tex/latex/BXjalipsum

This line contains non-ASCII characters (→: U+2192 RIGHTWARDS ARROW), and
`texdoc bxjalipsum` renders this line as follows.

> - `*.sty` <E2><86><92> $TEXMF/tex/latex/BXjalipsum

However, this should not happen because I set the LANG environment
variable as ja_JP.UTF-8
and all UTF-8-encoded files should be displayed as intended. In fact,
bxjalipsum’s README.md
doesn’t get corrupted if I explicitly pipe the stdout of `texdoc
bxjalipsum` to a pager, i.e., the command
`texdoc bxjalipsum | $PAGER` will work.

Is this a normal behavior? It seems like a bug IMHO, but I apologize
if this behavior is just as you expected.

Finally, I’ll note my environment:
- OS: OS X El Capitan
- TeX distribution: TeX Live 2016
- terminal emulator: iTerm and the built-in Terminal.app
- pager: less and more

Best regards,
Yudai Nakata

More information about the texdoc mailing list