[Doxygen-users] Fortran issues (reiterated)
Brought to you by:
dimitri
From: Petr P. <pet...@se...> - 2015-03-19 10:42:03
|
Hi all, let me reiterate on my two issues with Doxygen (1.8.9.1) and Fortran. #1. Preserving name case -- I undestand the code change is not trivial. I have been able to partially resolve this by tweaking the HTML output with jQuery to uppercase what I need. But I still have to write #var or func() in lowercase (in comment blocks), because #VAR or FUNC() in uppercase does not create a valid link, which result in an inconsistency. I don't understand why function names are case-insensitive and references are not. Maybe changing the auto-linking to ignore the case would be better? On the other hand, C and Java are both case-sensitive, so how come Doxygen does not keep the case in the first place? :) #2. Documenting functions after declaration (inside function) -- I would like to put the whole comment block right after SUBROUTINE FOO(A,B,C) using !<. I have found that so far the only (unsatisfactory) working solution is to put a one-line comment !> *before* the declaration (serves as a brief description) and put the rest of the comment block !> inside the function *after* any function arguments. I tried to put the whole block inside and start it with !> @fn FOO(A,B,C) but that did not work. Is there a way to request this feature? Best regards, Petr |