maven-issues mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "jieryn (JIRA)" <j...@codehaus.org>
Subject [jira] Commented: (MJAVADOC-249) javadoc:fix should wrap existing comments in <p></p>
Date Mon, 03 Aug 2009 12:59:59 GMT

    [ http://jira.codehaus.org/browse/MJAVADOC-249?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=185719#action_185719
] 

jieryn commented on MJAVADOC-249:
---------------------------------

Yep, I like that it collapses the {@inheritDoc} down to one line. :-) I wanted to have <p>
tags added to existing documentation simply for consistency.

> javadoc:fix should wrap existing comments in <p></p>
> ----------------------------------------------------
>
>                 Key: MJAVADOC-249
>                 URL: http://jira.codehaus.org/browse/MJAVADOC-249
>             Project: Maven 2.x Javadoc Plugin
>          Issue Type: New Feature
>    Affects Versions: 2.6
>            Reporter: jieryn
>            Priority: Minor
>
> When I run the javadoc:fix mojo, freshly generated comments are wrapped inside <p>
</p> tags. However, comments which existed prior to the run are not wrapped in such
tags, even when they do not exist. This mojo does more than just add missing javadoc comments,
but also tries to fix them up (for example, /**\n* {@inheritDoc}\n*/ gets transformed to /**
{@inheritDoc} */ ... which sets the precedent that the mojo is at least open to the idea of
fixing existing comments.
> Thanks!

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: http://jira.codehaus.org/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira

        

Mime
View raw message