Re: [PATCH 1/2] docs: kernel-doc comments are ASCII

From: Jonathan Corbet
Date: Wed Aug 30 2017 - 18:31:46 EST


On Wed, 30 Aug 2017 19:15:53 -0300
Mauro Carvalho Chehab <mchehab@xxxxxxxxxxxxxxxx> wrote:

> I suspect that the problem is not related to the version, but to
> what you might have set on LANG.
>
> Maybe if we add something like:
> LANG=C.utf-8
>
> to the Documentation/Makefile

That's worth a try; Randy, can you give it a quick go?

> or adding:
>
> .. -*- coding: utf-8; mode: rst -*-
>
> as the first line on the *.rst file that include the kernel-doc
> directive would solve the issue.

I guess I don't see how that would help, instead. Emacs reads that line,
but it's not involved in the problem.

I wish I could reproduce this, then we could see what in that massive
try..except block in kerneldoc.py is throwing the exception. Putting in
an explicit decode call might be enough to make the problem go away.

Thanks,

jon