[Doxygen-users] Fortran module-submodule structure

[Norman K. <nor...@gm...>]

Dear doxygen community

I love doxygen! Recently Fortran has been encouraging users ot move to a
module-submodule structure to dramatically reduce compilation effort in
long use chains.  A module procedure might be declared public and the
interface specified at the level of the module but the body specified in a
submodule.

Doxygen does not seem to understand the public declaration and does not
document the public routine as a result, here is a brief example:

!> @brief Module consisting of declarations and interfaces
module a_module
public a_module_print
interface
    module subroutine a_module_print
    end subroutine a_module_print
end interface
end module a_module

!> @brief The working parts of a_module
submodule (a_module) a_module_subm
    contains
    !> @brief Only subroutine in this submodule
    !> @detail Declared public at the level of the module
    !! prints hello world
    module subroutine a_module_print
        write(*,*) 'Hello World of Submodules'
    end subroutine a_module_print
end submodule a_module_subm

!> @brief Demonstration of module-submodule structure
program test_doxygen_subm
    use, non_intrinsic :: a_module
    call a_module_print
    stop
end program test_doxygen_subm

Is this just a case of new features of Fortran not yet implemented in
doxygen, or am I missing something?

Thanks

-- 
*Prof Norman Kirkby*
Research Fellow

Faculty of Biology, Medicine and Health

The University of Manchester



[image: Description: cid:image002.jpg@01D1EC01.DD98DC00]


The Christie NHS Foundation Trust
First Floor, Wolfson Molecular Imaging Centre, 27 Palatine Road, Manchester
M20 3LJ
Phone 0161 275 0009

Due to the Paterson fire, my ics.manchester.ac.uk email is not working,
please use:
nor...@ma..., or nor...@gm...