Netlib F2C

This project provides a CMake framework, that automatically downloads and builds the Fortran-to-C converter f2c from Netlib (https://www.netlib.org/f2c/) and the accompanying library libf2c.

Prerequisites

What you need:

• Git (optional) for getting the code and contributing to the project
• CMake and Ninja for building the project
• C compiler
  • GCC for Linux (https://gcc.gnu.org/)
  • Clang for Mac OS X (https://clang.llvm.org/)
  • Cygwin + GCC for Windows (https://www.cygwin.com/)
• LoadStaticSharedTargets (https://gitlab.aei.uni-hannover.de/cmake/loadstaticsharedtargets)

Linux (Ubuntu)

Use your distribution's package manager to install the necessary packages:

$ sudo apt-get install cmake ninja-build gcc

Mac OS X

You will need one of the community package managers for Mac OS X: Homebrew or MacPorts. For installing one of these, please refer to their respective installation instructions.

Homebrew

$ brew install cmake ninja llvm

MacPorts

$ sudo port -v install cmake ninja clang-<XX>

where you have to replace <XX> with the latest stable version of Clang. You can discover all available versions of Clang like this:

$ port search --name --line --regex '^clang-?\d*\.?\d*$'

Windows

The easiest thing to do is using the Windows Subsystem for Linux (WSL) and follow the Linux instructions above.

Otherwise, install Git for Windows for version control and cygwin, which is a large collection of GNU and Open Source tools which provide functionality similar to a Linux distribution on Windows. During the cygwin installation you'll be prompted to add additional packages. Search and select the following:

• cmake, ninja and gcc-core for the compiler and the build system

After cygwin finishes installing, use the cygwin terminal to start the build process.

How to compile

1. Clone the git repository or download the source code archive and unpack it to an arbitrary directory (e.g. netlib-f2c).

2. Go to this directory and type cp ./CMakeUserPresets.template.json ./CMakeUserPresets.json.

3. Next, type cmake --workflow --list-presets. A list of available build workflows will be shown to you.

4. For configuring, building and installing the project, type cmake --workflow --preset user-shared-release-install. This will try to populate the ./build directory with a CMake configuration tree, execute the build and install the project. By default, the configured installation directory is ./install.

   But it will fail due to an unaccepted license. Study the license text and proceed to the next step.

5. Open ./CMakeUserPresets.json in your favorite editor and set "NetlibF2C_LICENSE_ACCEPTED": true in the first configure preset "user-config".

6. Now, repeat step 4. Configuring, building and installing should be successful now.

7. Repeat step 6. for the other user workflow presets user-shared-debug-install, user-static-release-install and user-static-debug-install as needed.

How to use

Now, the f2c code is compiled and you can use it in other projects. The installed f2c package is discoverable by CMake as NetlibF2C. In the CMakeLists.txt of the other project, call:

include(FetchContent)

FetchContent_Declare(
    NetlibF2C
    GIT_REPOSITORY "git@gitlab.aei.uni-hannover.de:netlib/netlib-f2c.git"
    GIT_TAG v1.7.1
    SYSTEM
    FIND_PACKAGE_ARGS 1.7.1 CONFIG NAMES NetlibF2C
)
set(NetlibF2C_INCLUDE_PACKAGING TRUE)
FetchContent_MakeAvailable(NetlibF2C)

This discovers an installed version of the NetlibF2C package or adds it to the other project's install targets. To help CMake discover the NetlibF2C package, call CMake for the other project like this:

$ cmake -B ./build -D "CMAKE_PREFIX_PATH=/path/to/NetlibF2C/install/prefix"

Replace the path to the NetlibF2C install prefix with the actual path on your system! If NetlibF2C is installed in a proper system-wide location, the CMAKE_PREFIX_PATH shouldn't be necessary.

This makes two CMake targets available to you, the Netlib::f2c executable target and the Netlib::libf2c library target (static or shared depends on the value of BUILD_SHARED_LIBS in the other project).

For more information read the f2c executable's man page.

References

S. I. Feldman, David M. Gay, Mark W. Maimone, and N. L. Schryer. 1990. A Fortran-to-C Converter. AT&T Bell Laboratories Murray Hill, NJ 07974 (May 1990). Computing Science Technical Report No. 149. https://www.netlib.org/f2c/f2c.pdf