Thread: [Doxygen-users] Fortan problems
Brought to you by:
dimitri
From: Petr P. <pet...@se...> - 2015-10-13 13:13:47
|
Hi all, It seems Doxygen 1.8.10 does not work properly on Fortran modules. A. If a module is not documented it is not listed on the "file reference" page (as expected) but all its functions/variables are (bug!). B. If EXTRACT_PRIVATE = NO, module private functions are not listed (as expected) but module private variables are (bug!). C. Implicit PRIVATE/PUBLIC/PROTECTED statements in a module work as expected but are not "appended" to function/variable documentation. This is only a nuisance. D. If a documented function (inside or outside a module) is followed by one or more undocumented functions, the function calls in the following undocumented functions are listed in "References" of the documented function (bug!). Could this issues be adressed in the next version? Thanks :) Best regards, Petr |
From: Albert <alb...@gm...> - 2015-11-08 09:41:32
Attachments:
aa.f90
|
Dear Petr, I looked at problem D, but was not able to reproduce it. I used the attached source file and the default Doxyfile with the following items set to YES: - EXTRACT_ALL - REFERENCED_BY_RELATION - REFERENCES_RELATION Can you please attach a self-contained example (source+config file in a tar or zip) that allows me to reproduce the problem? (Preferably as bug report at bugzilla (https://bugzilla.gnome.org/enter_bug.cgi?product=doxygen) Albert On Tue, Oct 13, 2015 at 3:13 PM, Petr Parik <pet...@se...> wrote: > Hi all, > > It seems Doxygen 1.8.10 does not work properly on Fortran modules. > > A. If a module is not documented it is not listed on the "file > reference" page (as expected) but all its functions/variables are (bug!). > > B. If EXTRACT_PRIVATE = NO, module private functions are not listed (as > expected) but module private variables are (bug!). > > C. Implicit PRIVATE/PUBLIC/PROTECTED statements in a module work as > expected but are not "appended" to function/variable documentation. This > is only a nuisance. > > D. If a documented function (inside or outside a module) is followed by > one or more undocumented functions, the function calls in the following > undocumented functions are listed in "References" of the documented > function (bug!). > > Could this issues be adressed in the next version? Thanks :) > > Best regards, > > Petr > > > ------------------------------------------------------------------------------ > _______________________________________________ > Doxygen-users mailing list > Dox...@li... > https://lists.sourceforge.net/lists/listinfo/doxygen-users > |
From: Albert <alb...@gm...> - 2015-11-08 10:11:50
|
Dear Petr, Regarding problem A: Can you please attach a self-contained example (source+config file in a tar or zip) that allows me to reproduce the problem? (Preferably as bug report at bugzilla ( https://bugzilla.gnome.org/enter_bug.cgi?product=doxygen) (It looks like that I can reproduce the problems B and C) Albert On Tue, Oct 13, 2015 at 3:13 PM, Petr Parik <pet...@se...> wrote: > Hi all, > > It seems Doxygen 1.8.10 does not work properly on Fortran modules. > > A. If a module is not documented it is not listed on the "file > reference" page (as expected) but all its functions/variables are (bug!). > > B. If EXTRACT_PRIVATE = NO, module private functions are not listed (as > expected) but module private variables are (bug!). > > C. Implicit PRIVATE/PUBLIC/PROTECTED statements in a module work as > expected but are not "appended" to function/variable documentation. This > is only a nuisance. > > D. If a documented function (inside or outside a module) is followed by > one or more undocumented functions, the function calls in the following > undocumented functions are listed in "References" of the documented > function (bug!). > > Could this issues be adressed in the next version? Thanks :) > > Best regards, > > Petr > > > ------------------------------------------------------------------------------ > _______________________________________________ > Doxygen-users mailing list > Dox...@li... > https://lists.sourceforge.net/lists/listinfo/doxygen-users > |
From: Albert <alb...@gm...> - 2015-11-08 18:30:03
|
I've just pushed a proposed patch to github (pull request 409). This request is regarding the problems B and C. Albert On Sun, Nov 8, 2015 at 11:11 AM, Albert <alb...@gm...> wrote: > Dear Petr, > > Regarding problem A: > Can you please attach a self-contained example (source+config file in a > tar or zip) that allows me to reproduce the problem? > (Preferably as bug report at bugzilla ( > https://bugzilla.gnome.org/enter_bug.cgi?product=doxygen) > > (It looks like that I can reproduce the problems B and C) > > Albert > > > On Tue, Oct 13, 2015 at 3:13 PM, Petr Parik <pet...@se...> wrote: > >> Hi all, >> >> It seems Doxygen 1.8.10 does not work properly on Fortran modules. >> >> A. If a module is not documented it is not listed on the "file >> reference" page (as expected) but all its functions/variables are (bug!). >> >> B. If EXTRACT_PRIVATE = NO, module private functions are not listed (as >> expected) but module private variables are (bug!). >> >> C. Implicit PRIVATE/PUBLIC/PROTECTED statements in a module work as >> expected but are not "appended" to function/variable documentation. This >> is only a nuisance. >> >> D. If a documented function (inside or outside a module) is followed by >> one or more undocumented functions, the function calls in the following >> undocumented functions are listed in "References" of the documented >> function (bug!). >> >> Could this issues be adressed in the next version? Thanks :) >> >> Best regards, >> >> Petr >> >> >> ------------------------------------------------------------------------------ >> _______________________________________________ >> Doxygen-users mailing list >> Dox...@li... >> https://lists.sourceforge.net/lists/listinfo/doxygen-users >> > > |
From: Albert <alb...@gm...> - 2015-11-15 13:06:19
|
Regarding the problem of showing non documented functions etc. in the brief description section I've pushed a proposed solution github (pull request 411) Albert On Tue, Oct 13, 2015 at 3:13 PM, Petr Parik <pet...@se...> wrote: > Hi all, > > It seems Doxygen 1.8.10 does not work properly on Fortran modules. > > A. If a module is not documented it is not listed on the "file > reference" page (as expected) but all its functions/variables are (bug!). > > B. If EXTRACT_PRIVATE = NO, module private functions are not listed (as > expected) but module private variables are (bug!). > > C. Implicit PRIVATE/PUBLIC/PROTECTED statements in a module work as > expected but are not "appended" to function/variable documentation. This > is only a nuisance. > > D. If a documented function (inside or outside a module) is followed by > one or more undocumented functions, the function calls in the following > undocumented functions are listed in "References" of the documented > function (bug!). > > Could this issues be adressed in the next version? Thanks :) > > Best regards, > > Petr > > > ------------------------------------------------------------------------------ > _______________________________________________ > Doxygen-users mailing list > Dox...@li... > https://lists.sourceforge.net/lists/listinfo/doxygen-users > |