[erlang-questions] Documentation creation in Russian

Richard Carlsson <>
Tue Oct 28 10:15:33 CET 2008

Andrey Shnayder wrote:
> Hi,
> I need to generate the documentation on my erlang modules in russian. I
> try to use edoc and docbuilder (they use the same functions however),
> but I get the error:
> -------------------------------------------------------------------------
> ** exception exit: {badarg,[{io,put_chars,
> [<0.74.0>,
> ["<?xml version=\"1.0\" encoding=\"latin1\" ?>\n",
> "<!DOCTYPE erlref SYSTEM \"erlref.dtd\">\n",
> ........
> in function io:o_request/2
> in call from edoc_lib:write_file/4
> -------------------------------------------------------------------------
> If I write comments in English there are no errors, but I need
> documentation in russian. Can you help me? Files encoding is utf-8.

There is no real support for UTF-8 in Erlang right now (people
are working on it), so most things assume Latin-1 encoding in
input and output. If you can send me a minimal test case (a small
.erl file in UTF-8 that causes the crash) I can try and find a
workaround for edoc.


More information about the erlang-questions mailing list