Doxygen распознает параметры с разрывом строки

Question

Я пытаюсь документировать мои файлы расширений 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

Answer 1

Чтобы уточнить комментарии Альберта, вы можете задокументировать свою подпрограмму, например, так:

  !> 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 для этого.