Referencing mixed Fortran & C in doxygen -


my situation:

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 put here??? integer function api_function(...very long parameter list ...) 

problem fortran , c functions have same name, way can reference c function via full function declaration:

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

which exceeds size of fortran line (132 characters) , makes code bit ugly read.

my questions:

  1. is there possibility split autolink more lines? like:

    !> \copydoc api_function(...very long

    !! long parameter list ...)

  2. is there way how use filename+function name in autolink instead of param list? like:

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

  3. set custom link object , not use autolink? (so can set c function have link api_function__() instead of api_function())


Comments

Popular posts from this blog

javascript - RequestAnimationFrame not working when exiting fullscreen switching space on Safari -

Python ctypes access violation with const pointer arguments -