Scroll to navigation

DH_FORTRAN_MOD(1) dh-fortran-mod DH_FORTRAN_MOD(1)

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

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

2024-02-05 dh_fortran_mod v0.39