2015-04-25 46 views
1

我正在編寫一些.dox文件和魔杖中的某些軟件的文檔,以包含一些不會顯示在網頁中的評論。我正在使用\cond,但在撥打\endcond後我沒有收到任何輸出。Doxygen cond不工作

/// \section cuboids_sec Cuboids 
/// 
/// \cond 
/// [TODO] 
/// \endcond 
/// 
/// - \b Cuboid - Polyhedron bounded by six quadrilateral faces. 
/// - \b Rectangular \b Cuboid - Cuboid with rectangular faces. 
/// Then each pair of adjacent faces meet in a right angle. By 
/// definition, a rectangular cuboid is also a right rectangular 
/// prism. 

回答

3

\cond要在隱藏某些代碼時使用。

內部doxygen將在\cond處結束註釋並在\endcond後重新啓動新註釋塊。因此,您示例中的第二部分不再屬於任何頁面。

跳過\if評論使用的一部分:

/// \section cuboids_sec Cuboids 
/// 
/// \if HIDDEN 
/// [TODO] 
/// \endif 
/// 
/// - \b Cuboid - Polyhedron bounded by six quadrilateral faces. 
/// - \b Rectangular \b Cuboid - Cuboid with rectangular faces. 
/// Then each pair of adjacent faces meet in a right angle. By 
/// definition, a rectangular cuboid is also a right rectangular 
/// prism. 
1

你試過:

對於條件部分註釋塊中的一個應該使用\如果... \ ENDIF塊。

\cond的文檔所述?