2013-02-26 61 views
0

我正在嘗試根據Best Tips for documenting code using doxygen?中的頂級建議爲我的應用程序編寫獨立的Doxygen文件。獨立Doxygen文件中沒有自動鏈接

在我的概述中,我引用了類文件,但鏈接不顯示。

文件A.cs:

namespace NoAutoLinks 
{ 
    public class A 
    { 
    } 
    public class B 
    { 
     public A A { get; set; } 
    } 
} 

文件Doxygen.cs:

/// @file Doxygen.cs 
/// @mainpage No Auto Links 
/// I want to link to A and B here. Even explicit @ref A and \ref B links don't show up here. 

主要就是頁面呈現,但也有A或B.沒有任何聯繫。在對於B類頁,A的自動鏈接確實顯示出來。

的Doxyfile確實包含AUTOLINK_SUPPORT = YES

我看到有關關閉autolinking幾篇文章,但沒有關於自動連接失敗的這一特殊情況。

+0

注意,如果我創建B的類定義錨'@anchor C',然後把一個明確的'@ref C'上炫魅,然後該鏈接確實轉到了類B上。但即使明確指出該類的「@ref A」也不起作用。 – 2013-02-26 17:54:46

+0

如果我嘗試用'@link B B @ endlink'強制鏈接,我會得到index.html的鏈接。 http://stackoverflow.com/questions/9098680/doxygen-link-to-a-url-doesnt-generate-the-link-正確表明這可能是因爲B是一個無效的鏈接對象 – 2013-02-26 23:03:35

+0

添加一個公共函數上課沒有任何區別。 (在這裏黑暗中拍攝。) – 2013-02-26 23:07:10

回答

0

這是一個命名空間問題。以下作品。

namespace NoAutoLinks 
{ 
    /// @file Doxygen.cs 
    /// @mainpage No Auto Links 
    /// I want to link to A and B here. 
} 

不幸的是,這個例子比實際問題簡單。在實際的問題中有兩個命名空間,這個解決方案只修復其中的一個。添加一個using otherNamespace似乎沒有幫助。類文檔似乎沒有任何橋接命名空間的麻煩。

當然,一旦你知道答案,找到引用很容易,但它看起來並不像其他任何人有第二個命名空間的解決方案。

的解答。

0

明確的鏈接,包括命名空間的工作:

@link Namespace.C C @endlink