You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@avro.apache.org by "Ismaël Mejía (Jira)" <ji...@apache.org> on 2026/07/19 15:05:00 UTC
[jira] [Created] (AVRO-4311) [java] Neutralize backslashes when escaping schema docs into generated Javadoc
Ismaël Mejía created AVRO-4311:
----------------------------------
Summary: [java] Neutralize backslashes when escaping schema docs into generated Javadoc
Key: AVRO-4311
URL: https://issues.apache.org/jira/browse/AVRO-4311
Project: Apache Avro
Issue Type: Bug
Components: java
Reporter: Ismaël Mejía
The Java code generator (avro-compiler / avro-maven-plugin) writes schema documentation strings into the Javadoc comments of generated Java sources. The `escapeForJavadoc` helper escapes the comment terminator (`*/`) and HTML metacharacters, but it does not neutralize backslashes.
The Java compiler translates Unicode escapes (`\uXXXX`) across the whole source file, including inside comments, before comments are recognized (JLS 3.3). As a result, a documentation string that contains backslash sequences can be reinterpreted by the compiler and change the generated source in unintended ways.
Fix: update `escapeForJavadoc` to also neutralize backslashes by encoding them as the HTML entity `\`, so documentation content is always emitted as inert text in the generated Javadoc. A regression test covering several escape forms is added.
The string-literal path (`escapeForJavaString`, used for the embedded schema) already doubles backslashes and is unaffected.
--
This message was sent by Atlassian Jira
(v8.20.10#820010)