จะสร้างการเยื้องหลายระดับใน Javadoc ได้อย่างไร?

สมมติว่าเป็นส่วนหนึ่งของการบันทึกโค้ดของคุณ (Javadoc) คุณต้องการระบุว่าความสัมพันธ์ระหว่างองค์ประกอบที่ใช้การเยื้องลึก

ฉันจะสร้างรายการที่ซ้อนกันเป็น:

• องค์ประกอบบางอย่าง
  • องค์ประกอบอื่น ๆ
    • แต่องค์ประกอบอื่น ๆ

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

คุณสามารถใช้ HTML ในความคิดเห็นของ javadoc ได้อย่างอิสระ

อัปเดต: เพราะมันเกิดขึ้นฉันจึงพยายาม

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

และรับ

• หนึ่ง
• หนึ่งจุดหนึ่ง

ฉันเห็นด้วยว่าการทำรังที่เหมาะสมนั้นดีกว่า

วิธีที่ถูกต้องมีดังนี้:

/**
 * <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>แท็ก

<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>