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)

Reply via email to