Doxygen用linebreak识别参数

时间:2015-10-05 08:59:47

标签: fortran doxygen fortran90 fortran77 fixed-format

我试图记录我的Fortran 77 + 90扩展文件。一般来说,一切都很好,除了一件事。我的一些子程序有一个更长的参数列表。因此,它们使用换行符编写以添加内联注释,如下所示:

subroutine example (
                  &  a,          ! fist parameter
                  &  b,          ! second parameter
                  &  c,          ! third parameter
                  &  ...
                  &  z)          ! 26th parameter

<doing some stuff here...>

end

然而,当我运行doxygen时,它无法识别这些参数,这导致我的html文档中的空参数列表。它只是说:

  

子程序示例()

当然我可以使用@param添加参数,但它们不会出现在初始描述中。

doxygen中是否有隐藏的选项/命令来获得我想要的输出?我在文档中想要这样的东西:

subroutine example ( integer a
                     double precision b
                     ....
                     integer z )

当我将所有参数内联时,可以创建这个:

subroutine example (a,b,c,...,z)

<doing some stuff here...>

end

不幸的是,Fortran要求的固定格式不允许我使用它。有人可以帮我吗?

编辑:这是子程序参数列表中的换行符所发生的情况! http://www.pic-upload.de/view-28502940/pic.png.html

1 个答案:

答案 0 :(得分:0)

要详细说明albert的评论,您可以记录您的子例程,例如:

  !> Get a globally defined function.
  subroutine aot_fun_global(L, fun, key)
    type(flu_state) :: L !< Handle for the Lua script.

    !> Returned handle, providing access to the function.
    type(aot_fun_type), intent(out) :: fun

    !> Name of the function to look up in the global scope of the Lua script.
    character(len=*), intent(in) :: key

doxygen html为它。