Where can I specify the charset of a javadoc document?

Question

I write javadoc in Polish and I want to define the UTF-8 encoding for my javadoc documentation created by eclipse - how and where can I do this?

Answer 1

There are three relevant options for Javadoc:

• The -encoding parameter indicates the encoding of the source files. This should be regardless of which files your sources are actually encoded (and the compiler should use the same -encoding ). You can encode characters that are not part of the character set of this encoding using the \uXXXX convention. (And there are some people who claim that you should never use characters outside of US-ASCII in your source code to make it portable. I think UTF-8 is okay at the moment.)

• The -docencoding parameter specifies which encoding to use when writing HTML files. Characters that are used in prepared HTML, and not in the character set, are replaced by their equivalent &#...; .

• The -charset parameter specifies what to write in the <META http-equiv="Content-Type" content="text/html; charset=..."> in the header of the generated HTML files.

You should almost never use the same value for -docencoding and -charset , and I don't know why there are two different options for them. Using a different value results in invalid HTML or at least incorrect characters.

Answer 2

Right click on your project
Export ...> javadoc
In the third panel write this

-encoding utf8 -docencoding utf8 -charset utf8