如何在Thrift IDL中编写"javadoc"语句？

Question

Thrift有一个html生成器:

(thrift --help)

html (HTML):
standalone:      Self-contained mode, includes all CSS in the HTML files.
                 Generates no style.css file, but HTML files will be larger.

如果写struct这样的话

/**
* This is description of struct MyStruct
**/
struct MyStruct {
    1: required i32 fieldOne = 2
}

运行thrift --gen html创建一个html页面,部分如下:

Struct MyStruct

|Key|Field   |Type|Description|Requiredness|Default value|
|---|--------|----|-----------|------------|-------------|
|1  |fieldOne|i32 |           |required    |2            |

This is description of struct MyStruct

但是我没有找到如何填补description场地？

Answer 1

很好的问题,这很难猜测,并没有超级记录(是的,我很慷慨).这是答案:

struct MyStruct {
     /** This is how you add a description to a struct field */
     1: required i32 fieldOne = 2
}