[ https://issues.apache.org/jira/browse/AVRO-3239?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17454460#comment-17454460 ]
Oscar Westra van Holthe - Kind commented on AVRO-3239: ------------------------------------------------------ A recent addition to this issue is a separate class to handle documentation comments. This also strips indents, as suggested by [~mgrigorov] in [PR #1407|https://github.com/apache/avro/pull/1407#discussion_r754204005] > IDL parsing silently ignores dangling documentation comments > ------------------------------------------------------------ > > Key: AVRO-3239 > URL: https://issues.apache.org/jira/browse/AVRO-3239 > Project: Apache Avro > Issue Type: Improvement > Components: java, spec, tools > Affects Versions: 1.8.2, 1.9.2, 1.10.2 > Reporter: Oscar Westra van Holthe - Kind > Priority: Minor > Labels: pull-request-available > Fix For: 1.11.1 > > Attachments: comments.avdl, comments.avpr > > Time Spent: 1.5h > Remaining Estimate: 0h > > 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.20.1#820001)