EXAMPLE: Provide example CMakeLists.txt for users of exodus library […

…ci skip]

README.md

@@ -280,6 +280,24 @@ mingw-w64-x86_64-cmake mingw-w64-x86_64-fmt
 There is also a Visual Studio build performed at each commit to the
 SEACAS git repository.  See the file `.appveyor.yml` for more details.
 
+## Example For External Build
+The `cmake-use-example` directory contains a sample `CMakeLists.txt`
+file which provides an example of how to build and link a C or Fortran
+program with the Exodus library installed as part of a build of this
+package.
+
+To use this, copy the contents of the directory to your own filespace
+and modify the contents as needed.  The example provides a C
+executable and a Fortran Executable which both are linked to the
+Exodus library.
+
+To configure and build, you would do something like:
+```
+  mkdir build; cd build
+  CMAKE_PREFIX_PATH={path_to_root_of_seacas_install} cmake ..
+  make
+```
+
 ## License
 
 SEACAS is licensed under the Modified BSD License.  See the [LICENSE](LICENSE) file for details.

cmake-use-example/CMakeLists.txt

@@ -0,0 +1,32 @@
+# Almost all CMake files should start with this
+# You should always specify a range with the newest
+# and oldest tested versions of CMake. This will ensure
+# you pick up the best policies.
+cmake_minimum_required(VERSION 3.1...3.26)
+project(ExodusCMakeExample VERSION 1.0 LANGUAGES C Fortran)
+
+###
+### Generate Makefile with:   
+#  * mkdir build; cd build
+#  * CMAKE_PREFIX_PATH={path_to_root_of_seacas_install} ccmake ..
+
+#### C ####
+find_package(SEACASExodus CONFIG)
+add_executable(ExodusWriteC ExodusWrite.c)
+target_link_libraries(ExodusWriteC PRIVATE SEACASExodus::all_libs)
+
+
+#### FORTRAN #####
+IF ("${CMAKE_Fortran_COMPILER_ID}" MATCHES "GNU")
+  SET(CMAKE_Fortran_FLAGS "${CMAKE_Fortran_FLAGS} -fcray-pointer -fdefault-real-8 -fdefault-integer-8 -fno-range-check")
+ELSEIF ("${CMAKE_Fortran_COMPILER_ID}" MATCHES "XL")
+  SET(CMAKE_Fortran_FLAGS "${CMAKE_Fortran_FLAGS} -qintsize=8 -qrealsize=8")
+ELSEIF ("${CMAKE_Fortran_COMPILER_ID}" MATCHES "Cray")
+  SET(CMAKE_Fortran_FLAGS "${CMAKE_Fortran_FLAGS} -sdefault64")
+ELSE()
+  SET(CMAKE_Fortran_FLAGS "${CMAKE_Fortran_FLAGS} -r8 -i8")
+ENDIF()
+
+find_package(SEACASExodus_for CONFIG)
+add_executable(ExodusReadFor ExodusRead.f)
+target_link_libraries(ExodusReadFor PRIVATE SEACASExodus_for::all_libs)