Add notes on workflow steps

Author: mdpiper

.github/workflows/test.yml

@@ -84,43 +84,26 @@ jobs:
           init-shell: >-
             powershell
 
-      # - name: Set the PREFIX environment variable
-      #   run: |
-      #     echo "PREFIX=$env:MAMBA_ROOT_PREFIX\envs\fbld\Library" | Out-File -FilePath $env:GITHUB_ENV -Encoding utf8 -Append
-
+      # The Fortran conda compiler, flang, needs to be set over the gfortran installed by chocolatety.
       - name: Set the FC environment variable
         run: |
           echo "FC=$env:CONDA_PREFIX\Library\bin\flang-new.exe" | Out-File -FilePath $Env:GITHUB_ENV -Encoding utf8 -Append
 
-      # - name: Make a LINKER environment variable
-      #   run: |
-      #     echo "LINKER=$env:VCToolsInstallDir\bin\Host$env:RUNNER_ARCH\$env:Platform\link.exe" | Out-File -FilePath $env:GITHUB_ENV -Encoding utf8 -Append
-
-      # - name: Make a LINK_DIR environment variable for MSVC link.exe
-      #   run: |
-      #     echo "LINK_DIR=$env:VCToolsInstallDir\bin\Host$env:RUNNER_ARCH\$env:Platform" | Out-File -FilePath $env:GITHUB_ENV -Encoding utf8 -Append
-
-      # - name: Push location of MSVC link.exe to the front of the path
-      #   run: |
-      #     echo "Path=$env:LINK_DIR;$env:Path" | Out-File -FilePath $env:GITHUB_ENV -Encoding utf8 -Append
-
-      # - name: Force location of MSVC link.exe to the front of the path
-      #   run: |
-      #     echo "$env:VCToolsInstallDir\bin\Host$env:RUNNER_ARCH\$env:Platform" | Out-File -FilePath $env:GITHUB_PATH -Encoding utf8 -Append
-
+      # A link.exe installed by chocolatey was ahead of the MSVC link.exe in the path.
       - name: Remove link.exe in the Git install
         run: |
           Remove-Item -Path "C:\Program Files\Git\usr\bin\link.exe" -Force
 
+      # The flang FortranRuntime.lib wasn't being found. This recommendation comes from the Meson docs.
       - name: Add conda environment libpath to Windows LIB (not LIBPATH)
         run: |
           echo "LIB=$env:LIB;$env:CONDA_PREFIX\Library\lib" | Out-File -FilePath $env:GITHUB_ENV -Encoding utf8 -Append
 
       - name: View environment variables
         run: |
           ls env:
-          ls env:LIB
 
+      # The install prefix must be quoted.
       - name: Configure, build, and install HeatModelF
         run: |
           pushd ./external/bmi-example-fortran 
@@ -138,6 +121,7 @@ jobs:
           python -c 'import pymt_heatf'
           python -c 'from pymt.models import HeatModelF'
 
+      # Weird Windows stuff here. If the examples in the next step run to completion, the BMI works.
       # - name: Test BMI
       #   working-directory: ${{ github.workspace }}
       #   run: |

meson.build

@@ -1,7 +1,7 @@
 project(
     'pymt_heatf',
     'c', 'cython', 'fortran',
-    version: '3.1.dev0',
+    version: '3.2.dev0',
     license: 'MIT',
 )
 
@@ -25,6 +25,7 @@ incs = include_directories(
     ]
 )
 
+# gfortran on Linux/macOS can find these libraries with fc.find_library(); flang 19 on Windows cannot.
 bmif_dep = dependency('bmif', method: 'pkg-config')
 heatf_dep = dependency('heatf', method: 'pkg-config')
 bmiheatf_dep = dependency('bmiheatf', method: 'pkg-config')