Doxygen的：嵌套結構的命名

當doxygen的用於記錄一個嵌套的C結構類似於下面 -Doxygen的：嵌套結構的命名

struct level0 {   
    struct level1 {    
     struct level2 {    
      int data1;    
     } var_level2a;   

     struct level2b {  
      int data2;  
      int data3;  
     } var_level2b;  

    } var_level1;  
};

所生成的文檔結構命名爲這 -

結構0級1級:: :: level2a
結構0級1級:: :: level2b

我們可以簡單地將structu再名稱顯示（在內部它可能與範圍解析完整名稱「::」用於指事情）這樣的 -

結構level2a
結構level2b

請提供幫助。快速回復將非常有幫助。

來源

2013-03-06 Aritra Mukherjee

我相信這是毫不含糊的。你可以清楚地看到那裏的一個結構。 – 2013-03-06 12:41:04

感謝您的回覆。確實在模糊的問題上是安全的。我們有內部結構的獨特名稱，所以它不會發生衝突。但問題是，當doxygen讀取定義使用此'::'作用域分辨率的結構的嵌套樣式時。這使得結構名稱很長，並且讓不熟悉doxygen的普通讀者感到困惑。所以我們的要求是隻有RTF文檔中的結構短名稱。這可以通過任何方式實現嗎？ ...在@ref中，我們可以指定鏈接「標籤」;但這是自動生成的鏈接，我們似乎沒有任何控制。 – 2013-03-06 13:32:49

你試過設置HIDE_SCOPE_NAMES到YES？

來源

2013-03-07 19:03:21 doxygen

嗨Doxygen，感謝您的回覆。是的，我們嘗試過，但它不能解決問題。實際上，如果我們將此HIDE_SCOPE_NAMES設置爲YES或NO，我無法找到它在輸出文檔中所做的更改。我以我的經驗看到，在某些情況下，配置文件的設置參數並不總是像他們說的那樣工作。我正在使用Doxygen的最新版本，並且在Windows和Linux版本中都存在這個問題。既然你創建了這個工具，你能否建議如果有一個穩定（並具有幾乎相同的功能作爲最新）的版本，其中上述的東西將工作？ – 2013-03-11 10:02:02

如果您發現有些東西不能按照文檔或預期工作，請在doxygen的錯誤跟蹤器中爲其提供錯誤報告，幷包含一個自包含的示例（配置文件+源代碼爲zip或tar）。我只能解決可以重現的問題。 Doxygen有200多個選項，所以我不可能測試所有可能的設置。 – doxygen 2013-03-12 18:40:08

Doxygen的：嵌套結構的命名

回答

相關問題