Merge pull request #53 from sourceryinstitute/document-cray-results

doc(README.md): update Cray compiler test results

Author: rouson

README.md

@@ -66,18 +66,19 @@ summarizes the observed compiler behaviors:
 
 | _Compiler_   | _Test failures_    | _Version tested_                                    |
 | :---         |       :---:        | :---                                                |
-| NAG          |         0          | `nagfor` 7.1 Build 7113                             |
-| IBM          |         1          | `xlf2003_r` 17.1.0 on AIX                           |
-| Intel        |         2          | `ifort` 2021.5.0 Build 20211109\_000000             |
-| NVIDIA       |         2          | `nvfortran` 22.7-0                                  |
-| Cray         |         3          | `ftn` 13.0.1                                        |
-| GCC          |         6          | `gfortran` 12.2.0                                   |
 | AMD          | N.A. (see Note 1.) | `flang` 13.0.0 (AOCC_3.2.0-Build\#128 2021\_11\_12) |
+| Cray         | >= 3 (see Note 3.) | `ftn` 13.0.1                                        |
+| GCC          |         6          | `gfortran` 12.2.0                                   |
+| IBM          |         1          | `xlf2008_r` 17.1.0 on AIX                           |
+| Intel        |         1          | `ifort` 2021.7.0 Build 20220726_000000              |
 | LLVM         | N.A. (see Note 2.) | `git` commit `f5253058144aca1e9fcacd` (9/20/2022)   
+| NAG :trophy: |         0          | `nagfor` 7.1 Build 7113                             |
+| NVIDIA       |         2          | `nvfortran` 22.7-0                                  |
 
 **Notes**
 1. Fails to build due to an internal compiler error (ICE).
 2. Fails to build due to type finalization not yet being supported.
+2. Fails to build due to `fpm` issue [767]. See [test/README.md#cray] for a lower bound on the Cray compiler test failures.
 
 See the [test suite README.md](./test/README.md) for more details on each compiler's test
 results.
@@ -139,3 +140,5 @@ class diagram below of the three derived types in Smart-Pointers.
 [PlantUML]: https://plantuml.com
 [doc/]: ./doc
 [shallow copy]: https://en.wikipedia.org/wiki/Object_copying#Shallow_copy
+[767]: https://github.com/fortran-lang/fpm/issues/767
+[test/README.md#cray]: ./test/README.md#cray

test/README.md

@@ -31,7 +31,30 @@ Detailed Results
 
 ### Cray
 - Version: 13.0.1
-- Result: 3 test failures.
+- Result: at least 3 test failures.
+The Smart-Pointers library does not currenlty build with the Cray Fortran compiler, but
+the compiler standard-conformance tests embodied in [compiler_test_m.f90] also exist in
+a standalone format in a type-finalization [branch] of the Berkely Lab fork of the
+llvm-test-suite repository.  The reslts of running those compiler test show three compiler
+test failures as follows:
+```
+git clone https://github.com/berkeleylab/llvm-test-suite
+cd llvm-test-suite/Fortran/UnitTests/finalization
+ftn compile_me_only.f90
+> ./a.out
+ Cray Fortran : Version 13.0.1 fails to compile specification_expression_finalization.f90
+ Pass: finalizes a non-allocatable object on the LHS of an intrinsic assignment
+ Fail: finalizes an allocated allocatable LHS of an intrinsic assignment
+ Pass: finalizes a target when the associated pointer is deallocated
+ Pass: finalizes an object upon explicit deallocation
+ Pass: finalizes a non-pointer non-allocatable object at the END statement
+ Pass: finalizes a non-pointer non-allocatable object at the end of a block construct
+ Pass: finalizes a function reference on the RHS of an intrinsic assignment
+ Fail: finalizes a specification expression function result
+ Fail: finalizes an intent(out) derived type dummy argument
+ Pass: finalizes an allocatable component object
+```
+The number of unit test failures for the remainder of the Smart-Pointers test suite is unknown.
 
 ### GCC
 - Version: 12.2.0
@@ -152,3 +175,4 @@ Project is up to date
 [specification_expression_finalization.f90]:  ../example/test-support/specification_expression_finalization.f90
 [compiler_test_m.f90]:  ./compiler_test_m.f90
 [sp_smart_pointer_test_m.f90]:  ./sp_smart_pointer_test_m.F90
+[branch]: https://github.com/BerkeleyLab/llvm-test-suite/tree/fortran-type-finalization/Fortran/UnitTests/finalization