Javadoc @param与 -

Question

我正在制作javadoc：

/**
 * make Something
 *
 * @param value - blabla( I´m using @param value - blabla, instead @param
 * value blabla)
 * @return something
 */
public String makeSomething(String value) {

    return "";
}

我应该使用@param value - 还是只使用@param value？

Answer 1

大多数doclet在@param标记和参数名称之间引入了一个夸大其词。自己添加另一个爆炸将导致一个丑陋的，双重的高手被渲染。