This Bugzilla instance is a read-only archive of historic NetBeans bug reports. To report a bug in NetBeans please follow the project's instructions for reporting issues.
The document content is copied to the javadoc comment in generated code. We have our documenatation in Chinese characters. Since javadoc comment is in HTML format, everything is escaped to character reference. The result document looks fine in generated javadoc html document and in navigation panel, but in java code, they are just bunch of character references, not readable by human. Only special characters should be escaped but not every character in the document.
a sample output /** * <p style="margin-top: 0"> * 成人影片演員 * </p> */
Documentation window uses HTMLEditorKit, so the JTextPane.getText() by default yields escaped html character, that translates mbyte characters into &#nnn; format. It works fine for saving and retrieving documentation text in project xml file, rending in documentation editor and html report. However, the downside is we need to process the character sequence before writing to source file in order to render the native characters correctly in Java source editor. Similarly, it is necessary to escape them during reverse engineering to maintain the current encoding scheme for documentation persistence. So the suggested fix is to add logic to encode/decode html strings for code generation and reverse engineering. Some potential issues in merging source code with mbyte documentation need to be investigated along with this approach, assign to Viktor.