Oscar Westra van Holthe - Kind created AVRO-3239:
----------------------------------------------------
Summary: IDL parsing silently ignores dan going documentation
comments
Key: AVRO-3239
URL: https://issues.apache.org/jira/browse/AVRO-3239
Project: Apache Avro
Issue Type: Improvement
Components: java, tools
Affects Versions: 1.10.2, 1.9.2, 1.8.2
Reporter: Oscar Westra van Holthe - Kind
When parsing IDL, only the last documentation comment for a declaration is used.
Any previous documentation comments are silently ignored.
Proposed fix: while keeping the exact same parsing results, emit warnings for
each documentation comment that is ignored.
Additional suggestion: mention that a common cause for such a warning is using
a documentation comment instead of a multiline comment.
--
This message was sent by Atlassian Jira
(v8.3.4#803005)