[jira] [Commented] (THRIFT-681) The HTML generator does not handle JavaDoc style comments very well

["Akhtyam Sakaev (JIRA)" <ji...@apache.org>]

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

Akhtyam Sakaev commented on THRIFT-681:
---------------------------------------

0.9.3. HTML generator still doesn't parse @param correctly.

> The HTML generator does not handle JavaDoc style comments very well
> -------------------------------------------------------------------
>
>                 Key: THRIFT-681
>                 URL: https://issues.apache.org/jira/browse/THRIFT-681
>             Project: Thrift
>          Issue Type: Improvement
>          Components: Compiler (General)
>    Affects Versions: 0.2
>            Reporter: John Bartak
>            Assignee: Kevin Burnett
>             Fix For: 0.9
>
>         Attachments: Screenshot.png, screenshot-1.jpg, t_html_generator_JavaDoc.patch, t_html_generator_JavaDoc.v2.patch, thrift-681-inline-parameter-doc-generation.patch, thrift-681-inline-parameter-doc-generation.png, thrift-682-v2.patch
>
>
> If you create comments using the standard JavaDoc conventions of @param and @exception, the output that gets generated isn't the cleanest.  It would be better if the list of parameters and exceptions were placed in a table with the appropriate headers rather than just outputting the @param and @exception tags into the HTML output.



--
This message was sent by Atlassian JIRA
(v6.3.4#6332)