Javadoc 结束标记
Javadoc closing tags
阅读Oracle's Javadoc Documentation,发现作者没有关闭<p>
标签
/**
* The method used for creating the tree. Any structural
* modifications to the display of the Jtree should be done
* by overriding this method.
* <p>
* This method adds an anonymous TreeSelectionListener to
* the returned JTree. Upon receiving TreeSelectionEvents,
* this listener calls refresh with the selected node as a
* parameter.
*/
public JTree makeTree(AreaInfo ai){
}
文档指出:
If you have more than one paragraph in the doc comment, separate the paragraphs with a <p>
paragraph tag, as shown.
在 Eclipse 中,Javadoc 的格式正确,但仅仅因为它有效,是否意味着它是 "correct"?
是的,没错。引自 the specifications:
Some HTML element types allow authors to omit end tags (e.g., the P and LI element types)
阅读Oracle's Javadoc Documentation,发现作者没有关闭<p>
标签
/**
* The method used for creating the tree. Any structural
* modifications to the display of the Jtree should be done
* by overriding this method.
* <p>
* This method adds an anonymous TreeSelectionListener to
* the returned JTree. Upon receiving TreeSelectionEvents,
* this listener calls refresh with the selected node as a
* parameter.
*/
public JTree makeTree(AreaInfo ai){
}
文档指出:
If you have more than one paragraph in the doc comment, separate the paragraphs with a
<p>
paragraph tag, as shown.
在 Eclipse 中,Javadoc 的格式正确,但仅仅因为它有效,是否意味着它是 "correct"?
是的,没错。引自 the specifications:
Some HTML element types allow authors to omit end tags (e.g., the P and LI element types)