Preparation for release 0.3.0

CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## DLA-Future-Fortran 0.3.0
+
+### Added
+
+* Documentation with [Ford] [PR #8]
+* Calculation of partial eigenspectrum [PR #26 | PR #28]
+* `libs` property to Spack package [PR #25]
+* `pkgconfig` as build dependency to Spack package [PR #23]
+
 ## DLA-Future-Fortran 0.2.0
 
 ### Added
@@ -20,3 +29,4 @@ First release of [DLA-Future-Fortran], a Fortran interface for [DLA-Future].
 
 [DLA-Future]: https://github.com/eth-cscs/DLA-Future
 [DLA-Future-Fortran]: https://github.com/eth-cscs/DLA-Future-Fortran 
+[Ford]: https://forddocs.readthedocs.io/en/stable/

CITATION.cff

@@ -1,9 +1,9 @@
 cff-version: 1.2.0
-title: DLA-Future-Fortran 0.2.0
+title: DLA-Future-Fortran 0.3.0
 repository-code: 'https://github.com/eth-cscs/DLA-Future-Fortran'
 abstract: Fortran interface for DLA-Future (Distributed Linear Algebra from the Future)
-version: 0.2.0
-date-released: '2024-07-05'
+version: 0.3.0
+date-released: '2024-12-17'
 type: software
 authors:
   - given-names: Rocco

CMakeLists.txt

@@ -12,7 +12,7 @@ cmake_minimum_required(VERSION 3.22)
 
 # NOTE: CXX needed with DLA-Future
 # NOTE: C needed with HDF5 (dla-future +hdf5)
-project(DLAFFortran VERSION 0.2.0 LANGUAGES Fortran C CXX)
+project(DLAFFortran VERSION 0.3.0 LANGUAGES Fortran C CXX)
 
 include(CMakeDependentOption)
 include(GNUInstallDirs)
@@ -30,7 +30,7 @@ if(NOT CMAKE_Fortran_MODULE_DIRECTORY)
   set(CMAKE_Fortran_MODULE_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}/fortran_mods)
 endif ()
 
-find_package(DLAF 0.6.0 REQUIRED)
+find_package(DLAF 0.7.0 REQUIRED)
 
 add_subdirectory(src)
 

DOCUMENTATION.md

@@ -6,16 +6,23 @@
 
 ## How to generate the documentation
 
+Install Python dependencies:
+
+```bash
+python -m pip install -r requirements.txt
+```
+
 The Fortran code is documented using [FORD] (FORtran Documenter), an automatic documentation generator for modern Fortran projects.
 
 ```bash
-python -m ford --output_dir documentation DLA-Future-Fortran.md
+python -m ford DLA-Future-Fortran.md
 ```
 
+By default, the documentation is generated in the `doc-ford` directory.
+
 ## Documentation on GitHub
 
-The documentation is hosted on [GitHub Pages]. Documentation is generated automatically by the [GitHub Action] `.github/workflows/docs.yaml`
-for each version (`v*` tag) and for the `main` branch.
+The documentation is hosted on [GitHub Pages]. Documentation is generated automatically by the [GitHub Action] `.github/workflows/docs.yaml` for each version (`v*` tag) and for the `main` branch.
 
 The documentation is pushed by the [GitHub Action] to the `docs-ghpages` branch. This branch was manually created as an orphan branch with
 

RELEASE_PROCEDURE.md

@@ -28,4 +28,6 @@ DLA-Future-Fortran follows [Semantic Versioning](https://semver.org).
    with local repository. Exclude blocks delimited by `# !!!` comments. These are only intended for the
    internal Spack package.
 
+1. Add release documentation to `DOCUMENTATION.md`.
+
 1. Delete your `GITHUB_TOKEN` if created only for the release.

ci/ci-common.yml

@@ -30,7 +30,7 @@ stages:
     reports:
       dotenv: build.env
   variables:
-    SPACK_SHA: develop-2024-12-15
+    SPACK_SHA: 6005813518e41a890e9b7c93bf7190c4181d3c5e
     SPACK_BUILDCACHE: develop-2024-12-15
     SPACK_DLAF_FORTRAN_REPO: ./spack
     DOCKER_BUILD_ARGS: '[

ci/docker/common.yaml

@@ -41,7 +41,7 @@ packages:
       - '~libxml2'
   dla-future:
     require:
-      - '@master'
+      - '@git.version_0.7'
   git:
     # Force git as non-buildable to allow deprecated versions in environments
     # https://github.com/spack/spack/pull/30040

spack/packages/dla-future-fortran/package.py

@@ -37,7 +37,7 @@ class DlaFutureFortran(CMakePackage):
 
     depends_on("[email protected]:0.5 +scalapack", when="@0.1.0")
     depends_on("[email protected]: +scalapack", when="@0.2.0:")
-    depends_on("dla-future@master: +scalapack", when="@main")
+    depends_on("dla-future@0.7.0: +scalapack", when="@0.3:") # TODO: Change to 0.7.3
     depends_on("dla-future +shared", when="+shared")
 
     depends_on("mpi", when="+test")