引用混合Fortran& C在doxygen中

时间:2014-06-27 09:27:16

标签: c fortran doxygen

我的情况:

file_api.h

/*!
   \brief blabla
   \params ...description of many parameters..
*/
int api_function(...very long parameter list ...);

file_api.c

int api_function(...very long parameter list ...)
{
   return api_function_(...very long parameter list ...);
}

file_api.f

!> \copydoc ????what to put here???
integer function api_function(...very long parameter list ...)

问题是FortranC函数具有完全相同的名称,所以只能通过完整函数声明来引用C函数:

!> \copydoc api_function(...very long parameter list ...)

超过了Fortran行的大小(132个字符),使代码看起来有点难看。

我的问题:

  1. 是否有可能将自动链接拆分为更多行?类似的东西:

    !> \copydoc api_function(...very long

    !! long parameter list ...)

  2. 有没有办法在autolink中使用filename + function name而不是param list?类似的东西:

    !> \copydoc file_api.h::api_function()

  3. 设置自定义链接到对象而不使用自动链接? (因此我可以设置C函数将包含链接api_function__()而不是api_function()

0 个答案:

没有答案