NAME

       dh_fortran_mod - Install Fortran 90 .mod files and add dependency information.

SYNOPSIS

       dh_fortran_mod   [--sourcedir=dir] [$<debhelper options>]

DESCRIPTION

       dh_fortran_mod is a debhelper program that finds Fortran module and submodule files and
       adds dependencies to gfortran-$version as required to the package using via the variable
       ${fortran:Depends}.

       dh_fortran_mod is expected to be automatically added using the debhelper "addon"
       fortran_mod ie. either automatically, by build-depending on 'dh-sequence-fortran-mod', or
       explicitly:

           dh $@ --with fortran_mod

       dh_fortran_modSearches the debian/ directory for files debian/pkg.fortran-mod$ which list
       module files to include, with the same syntax as debhelper install files.

OPTIONS

       --sourcedir=dir
           Look in the specified directory for files to be installed.

           Typically Fortran module files are included in library development packages.

TODO

       Add dh-fortran-mod support for generic fortran compilers (ifx, etc).

           dh_fortran_mod will be expanded to find mod files automatically from the debian/tmp
           directory.  It will enable the installation of mod files in parallel for multiple
           compilers.  It will install .smod files for Fortran 2018.

           The fortran-mod file syntax follows dh_install: pairs of sources and optional target
           directories.  The default directory will be $fmoddir (
           /usr/lib/$multiarch/fortran/$compiler_mod_directory/) If the target directory is
           absolute (starts with a  '/'), this directory is used in the target package.  If the
           target  does not absolute, it will be treated as a subdirectory of $fmoddir.

           Currently four flavours of Fortran compiler are supported: gfortran-*  ('gfortran'),
           flang-new-* ('flang') , flang-to-external-fc-* ('flangext') and lfortran ('lfortran').

           $compiler_mod_directory is based on the compiler module version: currently
           gfortran-mod-15 for gfortran-14 (and older), flang-mod-15 for flang-new-15+ and
           lfortran-mod-0 for lfortran.

           For flang-to-external-fc-* the version is flangext-mod-15 (assuming gfortran-14 as the
           external compiler); in principle flang-to-external-fc ('flangext' flavour) and
           gfortran are intercompatible but intermixing is avoided.

           These will be updated for incompatible compiler versions.

           Support for Makefiles and debian/rules is given in
           /usr/share/debhelper/dh-fortran/fortran-support.mk

           This enables, for example:

                   /usr/share/debhelper/dh-fortran/fortran-support.mk
                   FMODDIR:= $(call get_fmoddir, gfortran)
                   FC_EXE:= $(call get_fc_exe, $(FC_DEFAULT))

SEE ALSO

       debhelper(7)

AUTHORS

       Sébastien Villemot <sebastien@debian.org> Alastair McKinstry <mckinstry@debian.org>

       Lots of code stolen shamelessly from dh_install (Joey Hess <joeyh@debian.org>).