maven-issues mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Robert Scholte (JIRA)" <j...@apache.org>
Subject [jira] [Commented] (MJAVADOC-496) javadoc:fix creates invalid @param tags for "this"
Date Fri, 08 Sep 2017 13:47:00 GMT

    [ https://issues.apache.org/jira/browse/MJAVADOC-496?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=16158659#comment-16158659
] 

Robert Scholte commented on MJAVADOC-496:
-----------------------------------------

I would be very surprised if this code would compile, {{this}} cannot be a valid parameter
name.

> javadoc:fix creates invalid @param tags for "this"
> --------------------------------------------------
>
>                 Key: MJAVADOC-496
>                 URL: https://issues.apache.org/jira/browse/MJAVADOC-496
>             Project: Maven Javadoc Plugin
>          Issue Type: Bug
>    Affects Versions: 2.9.1
>         Environment: Ubuntu 14.04.3 LTS
>            Reporter: Chris Hennick
>
> I'm using the Checker Framework on Java 8, so I sometimes need to write method declarations
in a form like
> {code:java}
>   protected void initTransientFields(
>       @UnknownInitialization AesCounterRandom this) {/*...*/}
> {code}
> When I run mvn javadoc:fix on a code base where I'm doing that, the javadocs of such
methods gain tags beginning with {code:java}@param this{code}, which raise an error when mvn
javadoc:javadoc tries to process them.



--
This message was sent by Atlassian JIRA
(v6.4.14#64029)

Mime
View raw message