Merge remote-tracking branch 'upstream/master' into median

Author: jvdp1

.github/workflows/CI.yml

@@ -21,7 +21,7 @@ jobs:
       fail-fast: false
       matrix:
         os: [ubuntu-latest, macos-latest]
-        gcc_v: [7, 8, 9, 10, 11] # Version of GFortran we want to use.
+        gcc_v: [9, 10, 11] # Version of GFortran we want to use.
     env:
       FC: gfortran-${{ matrix.gcc_v }}
       GCC_V: ${{ matrix.gcc_v }}

.github/workflows/ci_windows.yml

@@ -7,41 +7,6 @@ env:
   CTEST_TIME_TIMEOUT: "5"  # some failures hang forever
 
 jobs:
-  Build:
-    runs-on: windows-latest
-    strategy:
-      fail-fast: false
-
-    steps:
-    - uses: actions/checkout@v1
-
-    - name: Install fypp
-      run: pip install fypp
-
-    - run: cmake -G "MinGW Makefiles" -DCMAKE_SH="CMAKE_SH-NOTFOUND" -Wdev -B build -DCMAKE_BUILD_TYPE=Debug -DCMAKE_Fortran_FLAGS_DEBUG="-Wall -Wextra -Wimplicit-interface -fPIC -g -fcheck=all -fbacktrace" -DCMAKE_MAXIMUM_RANK=4
-
-      env:
-        FC: gfortran
-        CC: gcc
-        CXX: g++
-
-    - name: CMake build
-      run: cmake --build build --parallel
-
-    - name: catch build fail
-      run: cmake --build build --verbose --parallel 1
-      if: failure()
-
-    - name: CTest
-      run: ctest --output-on-failure --parallel -V -LE quadruple_precision
-      working-directory: build
-
-    - uses: actions/upload-artifact@v1
-      if: failure()
-      with:
-        name: WindowsCMakeTestlog
-        path: build/Testing/Temporary/LastTest.log
-
   msys2-build:
     runs-on: windows-latest
     strategy:

CMakeLists.txt

@@ -16,6 +16,9 @@ add_subdirectory(config)
 
 # --- compiler options
 if(CMAKE_Fortran_COMPILER_ID STREQUAL GNU)
+  if(CMAKE_Fortran_COMPILER_VERSION VERSION_LESS 9.0)
+    message(FATAL_ERROR "GCC Version 9 or newer required")
+  endif()
   add_compile_options(-fimplicit-none)
   add_compile_options(-ffree-line-length-132)
   add_compile_options(-Wall)
@@ -27,11 +30,7 @@ if(CMAKE_Fortran_COMPILER_ID STREQUAL GNU)
   if(CMAKE_Fortran_COMPILER_VERSION VERSION_LESS 11.0)
     add_compile_options(-pedantic-errors)
   endif()
-  if(CMAKE_Fortran_COMPILER_VERSION VERSION_GREATER_EQUAL 8.0)
-    add_compile_options(-std=f2018)
-  else()
-    add_compile_options(-std=f2008ts)
-  endif()
+  add_compile_options(-std=f2018)
 elseif(CMAKE_Fortran_COMPILER_ID STREQUAL Intel)
   add_compile_options(-warn declarations,general,usage,interfaces,unused)
   if(CMAKE_Fortran_COMPILER_VERSION VERSION_LESS 18.0)

README.md

@@ -87,9 +87,8 @@ The following combinations are tested on the default branch of stdlib:
 
 Name | Version | Platform | Architecture
 --- | --- | --- | ---
-GCC Fortran | 7, 8, 9, 10, 11 | Ubuntu 20.04 | x86_64
-GCC Fortran | 7, 8, 9, 10, 11 | MacOS Catalina 10.15 | x86_64
-GCC Fortran | 8 | Windows Server 2019 | x86_64
+GCC Fortran | 9, 10, 11 | Ubuntu 20.04 | x86_64
+GCC Fortran | 9, 10, 11 | MacOS Catalina 10.15 | x86_64
 GCC Fortran (MSYS) | 10 | Windows Server 2019 | x86_64
 GCC Fortran (MinGW) | 10 | Windows Server 2019 | x86_64, i686
 Intel oneAPI classic | 2021.1 | Ubuntu 20.04 | x86_64
@@ -106,7 +105,7 @@ A list of tested compilers which are currently not working and the respective is
 
 Name | Version | Platform | Architecture | Status
 --- | --- | --- | --- | ---
-GCC Fortran | 7.4 | Windows 10 | i686 | [#296](https://github.com/fortran-lang/stdlib/issues/296)
+GCC Fortran | <9 | any | any | [#296](https://github.com/fortran-lang/stdlib/issues/296), [#430](https://github.com/fortran-lang/stdlib/pull/430)
 NVIDIA HPC SDK | 20.7, 20.9, 20.11 | Manjaro Linux 20 | x86_64 | [#107](https://github.com/fortran-lang/stdlib/issues/107)
 NAG | 7.0 | RHEL | x86_64 | [#108](https://github.com/fortran-lang/stdlib/issues/108)
 Intel Parallel Studio XE | 16, 17, 18 | OpenSUSE | x86_64 | failed to compile

config/CMakeLists.txt

@@ -1,5 +1,11 @@
 # SPDX-Identifier: MIT
 
+option(
+  CMAKE_INSTALL_MODULEDIR
+  "Directory in prefix to install generated module files"
+  "${CMAKE_INSTALL_INCLUDEDIR}/${PROJECT_NAME}/${CMAKE_Fortran_COMPILER_ID}-${CMAKE_Fortran_COMPILER_VERSION}"
+)
+
 # Export a pkg-config file
 configure_file(
   "${CMAKE_CURRENT_SOURCE_DIR}/template.pc"

config/template.pc

@@ -1,9 +1,10 @@
 prefix=@CMAKE_INSTALL_PREFIX@
 libdir=${prefix}/@CMAKE_INSTALL_LIBDIR@
 includedir=${prefix}/@CMAKE_INSTALL_INCLUDEDIR@
+moduledir=${prefix}/@CMAKE_INSTALL_MODULEDIR@
 
 Name: @PROJECT_NAME@
 Description: @PROJECT_DESCRIPTION@
 Version: @PROJECT_VERSION@
 Libs: -L${libdir} -l@PROJECT_NAME@
-Cflags: -I${includedir}
+Cflags: -I${includedir} -I${moduledir}

doc/specs/index.md

@@ -15,6 +15,7 @@ This is and index/directory of the specifications (specs) for each new module/fe
  - [bitsets](./stdlib_bitsets.html) - Bitset data types and procedures
  - [error](./stdlib_error.html) - Catching and handling errors
  - [IO](./stdlib_io.html) - Input/output helper & convenience
+ - [kinds](./stdlib_kinds.html) - Kind parameters
  - [linalg](./stdlib_linalg.html) - Linear Algebra
  - [logger](./stdlib_logger.html) - Runtime logging system
  - [optval](./stdlib_optval.html) - Fallback value for optional arguments
@@ -25,10 +26,6 @@ This is and index/directory of the specifications (specs) for each new module/fe
  - [string\_type](./stdlib_string_type.html) - Basic string support
  - [strings](./stdlib_strings.html) - String handling and manipulation routines
 
-## Missing specs
-
- - [kinds](https://github.com/fortran-lang/stdlib/blob/master/src/stdlib_kinds.f90)
-
 ## Released/Stable Features & Modules
 
  - (None yet)

doc/specs/stdlib_kinds.md

@@ -0,0 +1,59 @@
+---
+title: kinds
+---
+
+# The `stdlib_kinds` module
+
+[TOC]
+
+## Introduction
+
+The `stdlib_kinds` module provides kind parameters for the Fortran intrinsic data types,
+*integer*, *logical*, *real*, and *complex*.
+
+
+## Constants provided by `stdlib_kinds`
+
+### `sp`
+
+Alias for intrinsic named constant `real32` imported from `iso_fortran_env`.
+
+
+### `dp`
+
+Alias for intrinsic named constant `real64` imported from `iso_fortran_env`.
+
+
+### `qp`
+
+Alias for intrinsic named constant `real128` imported from `iso_fortran_env`.
+
+
+### `int8`
+
+Reexported intrinsic named constant `int8` from `iso_fortran_env`.
+
+
+### `int16`
+
+Reexported intrinsic named constant `int16` from `iso_fortran_env`.
+
+
+### `int32`
+
+Reexported intrinsic named constant `int32` from `iso_fortran_env`.
+
+
+### `int64`
+
+Reexported intrinsic named constant `int64` from `iso_fortran_env`.
+
+
+### `lk`
+
+Kind parameter of the default logical data type.
+
+
+### `c_bool`
+
+Reexported intrinsic named constant `c_bool` from `iso_c_binding`.

doc/specs/stdlib_sorting.md

@@ -211,7 +211,7 @@ increasing, or decreasing, value.
 
 ##### Syntax
 
-`call [[stdlib_sorting(module):ord_sort(subroutine)]]ord_sort ( array[, work, reverse ] )`
+`call [[stdlib_sorting(module):ord_sort(interface)]]( array[, work, reverse ] )`
 
 ##### Class
 
@@ -286,7 +286,7 @@ decreasing, value.
 
 ##### Syntax
 
-`call [[stdlib_sorting(module):sort(subroutine)]]sort ( array[, reverse] )`
+`call [[stdlib_sorting(module):sort(interface)]]( array[, reverse] )`
 
 ##### Class
 
@@ -349,7 +349,7 @@ sort the input `array` to produce the output `array`.
 
 ##### Syntax
 
-`call [[stdlib_sorting(module):sort_index(subroutine)]]sort_index ( array, index[, work, iwork, reverse ] )`
+`call [[stdlib_sorting(module):sort_index(interface)]]( array, index[, work, iwork, reverse ] )`
 
 ##### Class
 

doc/specs/stdlib_string_type.md

@@ -1254,7 +1254,7 @@ The result is a scalar `string_type` value.
 
 ```fortran
 program demo_to_title
-  use stdlib_string_type, only: string_type, to_title
+  use stdlib_string_type
   implicit none
   type(string_type) :: string, titlecase_string
 
@@ -1302,7 +1302,7 @@ The result is a scalar `string_type` value.
 
 ```fortran
 program demo_to_sentence
-  use stdlib_string_type, only: string_type, to_sentence
+  use stdlib_string_type
   implicit none
   type(string_type) :: string, sentencecase_string