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-13 (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-13 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>).

dh_fortran_mod v0.39                               2024-02-05                                  DH_FORTRAN_MOD(1)