You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@thrift.apache.org by "Hudson (JIRA)" <ji...@apache.org> on 2012/05/03 00:24:50 UTC

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

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

Hudson commented on THRIFT-681:
-------------------------------

Integrated in Thrift #448 (See [https://builds.apache.org/job/Thrift/448/])
    THRIFT-681. The HTML generator does not handle JavaDoc style comments very well

Patch: Kevin Burnett (Revision 1333222)

     Result = FAILURE
bryanduxbury : http://svn.apache.org/viewvc/?view=rev&rev=1333222
Files : 
* /thrift/trunk/compiler/cpp/src/generate/t_html_generator.cc
* /thrift/trunk/compiler/cpp/src/generate/t_java_generator.cc

                
> 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 is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators: https://issues.apache.org/jira/secure/ContactAdministrators!default.jspa
For more information on JIRA, see: http://www.atlassian.com/software/jira