Details
-
Improvement
-
Status: Closed
-
Minor
-
Resolution: Fixed
-
0.9.3
-
None
-
Patch Available
Description
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):
/** * 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, )