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

maxime mouial commented on THRIFT-3823:
---------------------------------------

No, It was a mistake on my side with github GUI. Sorry about that.
Thanks for the link to THRIFT-3826, I will wait for it to be fix then.

> Escape documentation while generating non escaped documetation
> --------------------------------------------------------------
>
>                 Key: THRIFT-3823
>                 URL: https://issues.apache.org/jira/browse/THRIFT-3823
>             Project: Thrift
>          Issue Type: Improvement
>          Components: Compiler (General)
>    Affects Versions: 0.9.3
>            Reporter: maxime mouial
>
> The HTML generated documentation from a .thrift don't format comments. They 
> all appears as a one-liner.
> When not using the "noescape" tag, documentation comments should be displayed 
> between "<pre>" tag to keep readability.
> This will allow comment such as this one to be displayed correctly (and not 
> on one line):
> {code}
>     /**
>      * This method is doing this and that.
>      *
>      * @param user
>      *   Current identifier of the user
>      *
>      * @param password
>      *   Some password
>      *
>      * @return
>      *   Some data
>      *
>      * @throws ExceptionA
>      * @throws ExceptionB
>      */
>     string doSomeStuff(
>         1: string user,
>         2: string pasword,
>     ) throws (
>         1: ExceptionA userException,
>         2: ExceptionB systemException,
>     )
> {code}



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

Reply via email to