From Fedora Project Wiki

No edit summary
(Deprecate this page.)
 
(9 intermediate revisions by 4 users not shown)
Line 1: Line 1:
{{admon/warning|This is a draft document}}
{{OldGuidelinePage|Fortran}}
 
''This document is loosely based on the [[PackagingDrafts/FortranLibraries|Fortran library draft]] and the [[PackagingDrafts/FortranModulesDir|Fortran modules directory guideline]]. It is supposed to replace both of them.''
 
== Introduction ==
 
FORTRAN [http://en.wikipedia.org/wiki/Fortran] (short for FORmula TRANslator) was the first programming language ever, invented in 1957 and standardized in 1966. The Fortran 77 standard introduced improved support for structured programming such as <code>if</code> clauses.
 
Fortran natively handles matrices and is rather easy to program and for these reasons it was widely adopted in the scientific community. Due to the large amount of legacy code, Fortran is still widely used in computational science. Some modernization has taken place, though.
 
Fortran 90 presented a modernization of the language to support among others dynamic memory allocation, free-form source input and an argument passing mechanism to support compile time interface checking. Fortran 95 introduced many useful features such as vectorization constructs for high performance computing.
 
The Fortran 2003 standard added e.g. access to command line arguments and environment variables. The current standard under development is Fortran 2008.
 
== Modules and include files ==
== Modules and include files ==


Line 27: Line 14:
Fortran include files <b>MUST</b> be placed in the standard include directory: either directly in <code>%{_includedir}</code>, or if headers have general names or upstream recommends having an own directory, in e.g. <code>%{_includedir}/%{name}</code>.
Fortran include files <b>MUST</b> be placed in the standard include directory: either directly in <code>%{_includedir}</code>, or if headers have general names or upstream recommends having an own directory, in e.g. <code>%{_includedir}/%{name}</code>.


As Fortran modules are architecture and GCC version specific, they <b>MUST</b> be placed into <code>/usr/lib/gcc/<target>/<version>/finclude</code>, which is owned by 'gcc-gfortran'. For directory ownership any packages containing Fortran modules <b>MUST</b> <code>Requires: gcc-gfortran%{_isa}</code>.
As Fortran modules are architecture and GCC version specific, they <b>MUST</b> be placed into <code>%{_fmoddir}</code> (or its package-specific subfolder in case the modules have generic names), which is owned by 'gcc-gfortran'. For directory ownership any packages containing Fortran modules <b>MUST</b> <code>Requires: gcc-gfortran%{_isa}</code>.


To use the modules in the Fortran module directory, one needs to add <code>-I%{_fmoddir}</code> to the compiler flags (this is already included in <code>FFLAGS</code> used by <code>%configure</code>).
To use the modules in the Fortran module directory, one needs to add <code>-I%{_fmoddir}</code> to the compiler flags (this is already included in <code>FFLAGS</code> used by <code>%configure</code>).


== Required changes ==
[[Category:Packaging guidelines]]
 
The preexisting <code>%{_fmoddir}</code> macro must be changed from <code>%{_libdir}/gfortran/modules</code> to <code>/usr/lib/gcc/<target>/<version>/finclude</code>. Packages that contain modules in the wrong place must be found and corrected (find all packages that BR: gcc-gfortran and contain '.mod' files). Finally, a rebuild of all packages containing Fortran modules must be performed.

Latest revision as of 20:01, 21 December 2018

This is an old copy of a packaging guideline, preserved here in the wiki while we complete the transition to the Fedora documentation system. The current version is located at https://docs.fedoraproject.org/en-US/packaging-guidelines/Fortran/. Please update your bookmarks.

Modules and include files

The fortran modules files, ending in .mod are files describing a fortran 90 (and above) module API and ABI. These are not like C header files describing an API, they are compiler dependent and arch dependent, and not easily readable by a human being. They are nevertheless searched for in the includes directories by gfortran (in directories specified with -I).

Due to the ABI specificity, the module directory used must be architecture specific. In addition each gfortran release (e.g. from 4.4 to 4.5) may lead to an incompatible change in the .mod files, therefore mass rebuilds of Fortran packages must take place when gfortran is updated.

Fortran can also use include files, similar to C headers. Common used filename suffixes are '.inc' and '.h', although '.fh' has been used for files that are designed to function as public headers.

Packaging of Fortran programs

Fortran programs in Fedora MUST be compiled, if possible, using the default Fortran compiler in Fedora, 'gfortran'. As usual, standard Fedora optimization flags %{optflags} MUST be used in the compilation.

Fortran include files MUST be placed in the standard include directory: either directly in %{_includedir}, or if headers have general names or upstream recommends having an own directory, in e.g. %{_includedir}/%{name}.

As Fortran modules are architecture and GCC version specific, they MUST be placed into %{_fmoddir} (or its package-specific subfolder in case the modules have generic names), which is owned by 'gcc-gfortran'. For directory ownership any packages containing Fortran modules MUST Requires: gcc-gfortran%{_isa}.

To use the modules in the Fortran module directory, one needs to add -I%{_fmoddir} to the compiler flags (this is already included in FFLAGS used by %configure).

Retrieved from "https://fedoraproject.org/w/index.php?title=Packaging:Fortran&oldid=530772"