Link einfügen, um in einer anderen Datei mit Doxygen zu funktionieren?

Question

Ich habe zwei C-Quelldateien. Ein Kommentar zu einer Funktion bar() in Datei A muss sich auf eine Funktion foo() in Datei B beziehen. Wie kann ich diesen Link erstellen?

Ich habe versucht:

1. Schreiben so etwas wie: B.c::foo() dass doxygen der Hoffnung gehen würde, um B und finden foo dort Funktion Datei.

2. Auch versucht einfach ::foo(), aber das hat nicht geholfen.

3. Dann habe ich versucht Datei B.c eine spezielle tagname wie dabei //! @file specialtag auf erste Zeile B.c geben und dann specialtag::foo() in meinem Kommentar zu tun, aber nicht viel geändert hat.

4. Ich versuchte, die Verbindung mit \ref und \link zu erzwingen, aber selbst das half nicht.

Die //! @file Linie ist in beiden A.c und B.c so doxygen des Codes bewusst sein sollten.

EDIT

versuchte ich, was @doxygen vorgeschlagen, aber ohne Glück. Ich machte ein Beispielprojekt, um zu zeigen, wo ich in Probleme laufe, sein hier: http://www.filedropper.com/testdoxygen2tar

Ich benutzte die Standardeinstellungsdatei, die mit doxygen -g gemacht wurde. Der Ausgang, den ich bekomme:

Sie können sehen, dass die Foobar-Funktion nicht verknüpft ist.

EDIT 2

das Problem gefunden. Die Funktion foo war undokumentiert und daher wurde keine Seite generiert, also hatte doxygen natürlich keine Seite zum verlinken. (Ich erzeugte Dokumentation mit der aktivierten SOURCE_BROWSER Option und hoffte, dass eine Verbindung zur Funktionsdefinition erzeugt würde)

Answer 1

Dieses ist ziemlich direkt. Hier ist ein minimales Beispiel, das mit einer Standard-Konfigurationsdatei arbeitet (doxygen -g):

Erste Datei foo.c mit folgendem Inhalt:

/** @file */ 

/** Function foo, see also bar(). */ 
void foo() 
{ 
} 

dann Datei bar.c mit folgendem Inhalt:

/** @file */ 

/** Function bar, see also foo(). */ 
void bar() 
{ 
} 

Führen Sie doxygen und beobachten Sie in der HTML-Ausgabe, dass beide Funktionen einen Link zu der anderen Funktion haben werden.