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

ASF GitHub Bot commented on THRIFT-3823:
----------------------------------------

Github user jeking3 commented on the issue:

    https://github.com/apache/thrift/pull/1029
  
    I tested the download of openssl which was failing last night, it looks 
like the external site is up again and responsive, so if you rebase and push 
it'll kick another build that should succeed.


> 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