如何在Javadoc中创建多个级别的缩进？

Question

假设,作为记录代码(Javadoc)的一部分,您希望使用深度缩进来指示元素之间的关系.

如何创建嵌套列表:

• 一些元素
  • 其他一些因素
    • 还有一些其他因素

Answer 1

<ul>
  <li>Element</li>
  <ul>
     <li>Subelement...</li>

您可以在javadoc注释中自由使用HTML.

更新:因为它出现了,我试过了

<ul>
    <li>one</li>
    <ul>
        <li>one point one</li>
    </ul>   
</ul>

得到

• 一
• 一点一点

我同意适当的嵌套更好.

Answer 2

正确的方法如下：

/**
 * <ul>
 *   <li>some element
 *   <li><ul>
 *     <li>some other element
 *     <li><ul>
 *       <li>yet some other element
 *     </ul>
 *   </ul>
 * </ul>
 */

尽管JavaDoc是从HTML借用的，但它不是HTML，因此您应该</li>像省略</p>标记一样省略标记。

Answer 3

嵌套列表应该在它自己的内部<li>. <ul>不是有效的子元素<ul>.

所以你的例子是:

<ul>
  <li>some element</li>
  <li>
    <ul>
      <li>some other element</li>
      <li>
        <ul>
          <li>yet some other element</li>
        </ul>
      </li>
    </ul>
  </li>
</ul>