Experimental fpm build/test/install capability

.VERSION

@@ -1,6 +1,6 @@
 $Format:%d%n%n$
 # Fall back version, probably last release:
-2.10.0
+3.0.0
 
 # OpenCoarrays version file. This project uses semantic
 # versioning. For details see http://semver.org

.gitignore

@@ -0,0 +1 @@
+fpm.toml

CMakeLists.txt

@@ -645,6 +645,7 @@ define_property(TARGET
 # Recurse into the src directory
 #-------------------------------
 add_subdirectory(src)
+add_subdirectory(tests)
 
 #-----------------------------------------------------
 # Publicize installed location to other CMake projects
@@ -964,7 +965,7 @@ endif()
 
 # Test bash installation scripts
 include(cmake/AddInstallationScriptTest.cmake )
-add_installation_script_test(installation-scripts.sh src/tests/installation/)
+add_installation_script_test(installation-scripts.sh tests/installation/)
 
 if( CAF_ENABLE_FAILED_IMAGES AND ( NOT
       (	"${CMAKE_C_COMPILER_ID}" STREQUAL "GNU" ) AND ( "${CMAKE_SYSTEM_PROCESSOR}" STREQUAL "x86_64" ) )

doc/man/man1/caf.1

@@ -1,4 +1,4 @@
-.TH CAF 1 2017\-09\-12 OpenCoarrays\-1.9.1 "caf compiler wrapper manual"
+.TH CAF 1 2022\-06\-05 OpenCoarrays\-3.0.0 "caf compiler wrapper manual"
 .SH NAME
 .PP
 \fB\fCcaf\fR \- OpenCoarrays compiler wrapper to compile and link coarray Fortran source files and programs
@@ -7,9 +7,9 @@
 \fB\fCcaf\fR [compiler\-options] [linker\-options] \fI<fortran\-source\-file>\fP [\fIobject\-files\fP] [libraries]
 .SH DESCRIPTION
 .PP
-\fB\fCcaf\fR is a compiler wrapper script which is generated when the OpenCoarrays library \[la]https://github.com/sourceryinstitute/OpenCoarrays#readme\[ra] that ensures coarray fortran programs are compiled with the same fortran compiler OpenCoarrays was built for,
+\fB\fCcaf\fR is a compiler wrapper script which is generated when the OpenCoarrays library \[la]https://github.com/sourceryinstitute/OpenCoarrays#readme\[ra] that ensures coarray Fortran programs are compiled with the same Fortran compiler OpenCoarrays was built for,
 .BR gfortran (1)
-by default, and that the linker links against the appropriate parallel runtime, MPI by default. The \fB\fCcaf\fR compiler wrapper serves a similar purpose to the MPI fortran wrapper compiler,
+by default, and that the linker links against the appropriate parallel runtime, MPI by default. The \fB\fCcaf\fR compiler wrapper serves a similar purpose to the MPI Fortran wrapper compiler,
 .BR mpifort (1).
 \fB\fCcaf\fR embeds the full path to the Fortran compiler it was built for, and to the parallel runtime libraries it links against, and a relative path, based on the install location of \fB\fCcaf\fR itself, to the OpenCoarrays library. This ensures that the API and ABI of OpenCoarrays is always consistent with the Fortran compiler it was built for, and the parallel runtime it uses. To upgrade the parallel runtime, e.g., MPI, or the Fortran compiler, you will need to rebuild and install OpenCoarrays, which will regenerate and reinstall the \fB\fCcaf\fR wrapper script.
 .PP
@@ -30,9 +30,10 @@ Report the name and version of the Fortran compiler \fB\fCcaf\fR is wrapping and
 .SH BUGS
 .PP
 For a list of bugs currently affecting OpenCoarrays, or to report a new one, please report any bugs to the OpenCoarrays project at \[la]https://github.com/sourceryinstitute/OpenCoarrays/issues\[ra]
-.SH AUTHOR
+.SH AUTHORS
 .PP
 Izaak Beekman \[la]izaak@izaakbeekman.com\[ra]
+Damian Rouson \[la]damian@rouson.net\[ra]
 .SH SEE ALSO
 .PP
 .BR cafrun (1),

doc/man/man1/cafrun.1

@@ -1,4 +1,4 @@
-.TH CAFRUN 1 2017\-09\-12 OpenCoarrays\-1.9.1 "cafrun coarray Fortran job launcher manual"
+.TH CAFRUN 1 2022\-06\-05 OpenCoarrays\-3.0.0 "cafrun coarray Fortran job launcher manual"
 .SH NAME
 .PP
 \fB\fCcafrun\fR \- Coarray Fortran executable launcher for OpenCoarrays
@@ -64,9 +64,10 @@ Report the version of the parallel runtime \fB\fCcafrun\fR is wrapping and exit.
 .SH BUGS
 .PP
 For a list of bugs currently affecting OpenCoarrays, or to report a new one, please report any bugs to the OpenCoarrays project at \[la]https://github.com/sourceryinstitute/OpenCoarrays/issues\[ra]
-.SH AUTHOR
+.SH AUTHORS
 .PP
 Izaak Beekman \[la]izaak@izaakbeekman.com\[ra]
+Damian Rouson \[la]damian@rouson.net\[ra]
 .SH SEE ALSO
 .PP
 .BR caf (1),

doc/sample-compiler-output.c

@@ -4,7 +4,7 @@
  * SYNOPSIS
  *   This C program represents the code an OpenCoarrays-compatible
  *   Fortran compiler might generate from doc/sample-fortran-source.f90.
- *   The code delegates all necessary synchronization and communicaiton
+ *   The code delegates all necessary synchronization and communication
  *   to an OpenCoarrays transport layer.  In this program, image 1 puts
  *   its local elements of an array coarray into the corresponding
  *   elements of image 2.

example/hello.f90

@@ -0,0 +1,4 @@
+program main
+  implicit none
+  print*,"Hello from image ",this_image()
+end program

example/support-test/README.md

@@ -0,0 +1,3 @@
+Test Support
+------------
+The programs in this directory intentionally error-terminate to support the `error stop` tests in `test/caf_error_stop.f90`, which use Fortran's `execute_command_line` to run the programms in this directory and check for the expected non-zero stop codes.  Running the tests in this manner enables the Vegetable tests to continue executing in the presence of error-terminating tests.

example/support-test/error_stop_character_code.f90

@@ -0,0 +1,7 @@
+program error_stop_character_code
+  implicit none
+
+  error stop ""
+
+  stop 0 ! ../../test/error_stop_test.f90 will report a test failure if this line runs
+end program 

example/support-test/error_stop_integer_code.f90

@@ -0,0 +1,7 @@
+program error_stop_integer_code
+  implicit none
+
+  error stop
+
+  stop 0 ! caffeine/test/error_stop_test.f90 reports a failure if this line runs
+end program 

example/support-test/normal_termination.f90

@@ -0,0 +1,7 @@
+program normal_termination
+  implicit none
+
+  stop 0
+
+  stop 1 ! opencoarrays/test/zzz_finalization_test.f90 reports a failure if this line runs
+end program