[jira] [Updated] (AVRO-3239) IDL parsing silently ignores dan going documentation comments

["Oscar Westra van Holthe - Kind (Jira)" <ji...@apache.org>]

     [ https://issues.apache.org/jira/browse/AVRO-3239?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Oscar Westra van Holthe - Kind updated AVRO-3239:
-------------------------------------------------
    Attachment: comments.avpr

> 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.8.2, 1.9.2, 1.10.2
>            Reporter: Oscar Westra van Holthe - Kind
>            Priority: Minor
>         Attachments: comments.avdl, comments.avpr
>
>
> 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)