Doxygen: Как ссылаться на подпрограмму внутри модуля Fortran? - PullRequest
Новая
       23

Doxygen: Как ссылаться на подпрограмму внутри модуля Fortran?

1 голос
/ 31 января 2020

Я считаю Fortran API для C кода. Поэтому у меня есть надлежащим образом документированная C функция execute_lua. Для этой функции (и других функций) у меня есть модуль Fortran 

MODULE CINTERFACE 
! Some definitions
CONTAINS 

!> @brief Wrap the C function execute_lua
!> @param[in]   state Global State
!> 
!> .......
SUBROUTINE EXECUTE_LUA(STATE) 
 ...
END SUBROUTINE 
END MODULE

Теперь я хочу сослаться на Fortran EXECUTE_LUA где-то еще, например, как См. Также ссылка. Я попытался 

!> @sa execute_lua

, который дает ссылку на функцию C. Я пытался 

!> @sa EXECUTE_LUA

, где не появляется ссылка. Поскольку doxygen генерирует мою подпрограмму Fortran внутри модуля как cinterface::execute_lua, я попытался 

!> @sa cinterface::execute_lua

, где также не появляется ссылка.

Так как же это работает, что я могу ссылаться на подпрограмму внутри модуля Fortran вместо C.

Полный пример приведен здесь: https://gist.github.com/grisuthedragon/01ac07ed05a865419475b7a8644b8459

...