[jira] [Commented] (ACCUMULO-2734) javadoc bug with multi-line @code tag

["ASF subversion and git services (JIRA)" <ji...@apache.org>]

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

ASF subversion and git services commented on ACCUMULO-2734:
-----------------------------------------------------------

Commit 83ef6b8433e25477993308cb5a2acc30d9c26246 in accumulo's branch refs/heads/1.5.2-SNAPSHOT from [~ctubbsii]
[ https://git-wip-us.apache.org/repos/asf?p=accumulo.git;h=83ef6b8 ]

ACCUMULO-2734 Fix trivial javadoc bug


> javadoc bug with multi-line @code tag
> -------------------------------------
>
>                 Key: ACCUMULO-2734
>                 URL: https://issues.apache.org/jira/browse/ACCUMULO-2734
>             Project: Accumulo
>          Issue Type: Task
>         Environment: Eclipse Kepler SR2
>            Reporter: Christopher Tubbs
>            Assignee: Christopher Tubbs
>            Priority: Trivial
>              Labels: javadoc, warning
>             Fix For: 1.5.2, 1.6.0
>
>
> This is an extremely trivial bug, but it's the last remaining javadoc warning showing up in Eclipse with pretty pedantic settings, so I'd like it removed.
> TableOperations.java has a javadoc which uses a multi-line javadoc code tag. Eclipse does not properly handle this. It's also not clear to me that the inner braces ending brace inside the code block shouldn't close the javadoc tag.
> https://bugs.eclipse.org/bugs/show_bug.cgi?id=206345
> This javadoc can easily use html escapes to render the special characters that the code tag is intending to prevent parsing of. I've already verified that this renders correctly with both javadoc 1.6 and 1.7.



--
This message was sent by Atlassian JIRA
(v6.2#6252)