Merge pull request #296 from intel/develop

Develop

Author: chuckyount

Makefile

@@ -1,6 +1,6 @@
 ##############################################################################
 ## YASK: Yet Another Stencil Kit
-## Copyright (c) 2014-2023, Intel Corporation
+## Copyright (c) 2014-2024, Intel Corporation
 ## 
 ## Permission is hereby granted, free of charge, to any person obtaining a copy
 ## of this software and associated documentation files (the "Software"), to
@@ -109,15 +109,15 @@ api-docs: docs/api/html/index.html
 compiler-api:
 	$(YC_MAKE) api
 
-kernel-api:
-	$(YK_MAKE) api
+cxx-kernel-api:
+	$(YK_MAKE) cxx-api
 
 py-kernel-api:
 	$(YK_MAKE) py-api
 
-api:
-	$(YC_MAKE) $@
-	$(YK_MAKE) $@
+kernel-api: cxx-kernel-api py-kernel-api
+
+api: compiler-api kernel-api
 
 # Remove old generated API documents and make new ones.
 docs/api/html/index.html: include/*.hpp include/*/*.hpp docs/api/*.*
@@ -142,11 +142,11 @@ clean:
 	$(YK_MAKE) $@
 
 # Remove executables, generated documentation, etc. (not logs).
-# Use 'find *' instead of 'find .' to avoid searching in '.git'.
+# Avoid 'find .' to prevent searching in '.git'.
 realclean: clean
 	rm -rf $(LIB_OUT_DIR) $(BIN_OUT_DIR) $(BUILD_OUT_DIR)
 	rm -fv TAGS '*~'
-	- find src include utils docs -name '*~' -print -delete
+	- find src include utils docs yask -name '*~' -print -delete
 	- find src -name '*.optrpt' -print -delete
 	- find src -name __pycache__ -print -delete
 	$(YC_MAKE) $@
@@ -292,6 +292,7 @@ all-tests: compiler-api common-unit-tests
 all:
 	$(MAKE) realclean
 	$(MAKE) tags
-	$(MAKE) default
-	$(MAKE) api-all
+	$(MAKE) docs
+	$(MAKE) compiler
+	$(MAKE) compiler-api
 	$(MAKE) all-tests

README.md

@@ -31,11 +31,11 @@ and Intel(R) graphics processors.
 
 ### Pre-requisites:
 * Intel(R) [oneAPI](https://software.intel.com/content/www/us/en/develop/tools/oneapi.html)
-  HPC Toolkit for Linux (toolkit 2023.2 or later recommended); this will install
+  HPC Toolkit for Linux (toolkit 2024.1 or later recommended); this will install
   the Intel(R) oneAPI DPC++/C++ Compiler and the Intel(R) MPI Library.
   See compiler notes below under version 4.00.00 changes.
 * Gnu C++ compiler, g++ (8.5.0 or later recommended).
-  Even when using Intel compilers, a g++ installation is required.
+  (Even when using Intel compilers, a g++ installation is required.)
 * Linux libraries `librt` and `libnuma`.
 * Grep.
 * Perl (v5 or later).
@@ -68,6 +68,12 @@ and Intel(R) graphics processors.
 
 ## Backward-compatibility notices
 ### Version 4
+* Version 4.05.03 has a few notices:
+  - The default stencil name "iso3dfd" is removed; this means
+    you must always set the stencil name when building a kernel -- there is no default.
+    If you get an error about the "undefined" stencil, this means you didn't set the
+    stencil name.
+  - Some of the API-related Makefile target names were changed for consistency.
 * Version 4.05.00 removes the "out-of-band" genetic-algorithm tuning script
     due to lack of resources for maintenance and testing.
 * Version 4.04.00 deprecates the existing `void* {set,get}_elements_in_slice()`

YASK-LICENSE.md

@@ -1,5 +1,5 @@
 YASK: Yet Another Stencil Kit
-Copyright (c) 2014-2023, Intel Corporation
+Copyright (c) 2014-2024, Intel Corporation
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to

docs/api/html/yask__common__api_8hpp_source.html

@@ -85,7 +85,7 @@
 <a href="yask__common__api_8hpp.html">Go to the documentation of this file.</a><div class="fragment"><div class="line"><a id="l00001" name="l00001"></a><span class="lineno">    1</span><span class="comment">/*****************************************************************************</span></div>
 <div class="line"><a id="l00002" name="l00002"></a><span class="lineno">    2</span><span class="comment"></span> </div>
 <div class="line"><a id="l00003" name="l00003"></a><span class="lineno">    3</span><span class="comment">YASK: Yet Another Stencil Kit</span></div>
-<div class="line"><a id="l00004" name="l00004"></a><span class="lineno">    4</span><span class="comment">Copyright (c) 2014-2023, Intel Corporation</span></div>
+<div class="line"><a id="l00004" name="l00004"></a><span class="lineno">    4</span><span class="comment">Copyright (c) 2014-2024, Intel Corporation</span></div>
 <div class="line"><a id="l00005" name="l00005"></a><span class="lineno">    5</span><span class="comment"></span> </div>
 <div class="line"><a id="l00006" name="l00006"></a><span class="lineno">    6</span><span class="comment">Permission is hereby granted, free of charge, to any person obtaining a copy</span></div>
 <div class="line"><a id="l00007" name="l00007"></a><span class="lineno">    7</span><span class="comment">of this software and associated documentation files (the &quot;Software&quot;), to</span></div>

docs/api/html/yask__compiler__api_8hpp_source.html

@@ -85,7 +85,7 @@
 <a href="yask__compiler__api_8hpp.html">Go to the documentation of this file.</a><div class="fragment"><div class="line"><a id="l00001" name="l00001"></a><span class="lineno">    1</span><span class="comment">/*****************************************************************************</span></div>
 <div class="line"><a id="l00002" name="l00002"></a><span class="lineno">    2</span><span class="comment"></span> </div>
 <div class="line"><a id="l00003" name="l00003"></a><span class="lineno">    3</span><span class="comment">YASK: Yet Another Stencil Kit</span></div>
-<div class="line"><a id="l00004" name="l00004"></a><span class="lineno">    4</span><span class="comment">Copyright (c) 2014-2023, Intel Corporation</span></div>
+<div class="line"><a id="l00004" name="l00004"></a><span class="lineno">    4</span><span class="comment">Copyright (c) 2014-2024, Intel Corporation</span></div>
 <div class="line"><a id="l00005" name="l00005"></a><span class="lineno">    5</span><span class="comment"></span> </div>
 <div class="line"><a id="l00006" name="l00006"></a><span class="lineno">    6</span><span class="comment">Permission is hereby granted, free of charge, to any person obtaining a copy</span></div>
 <div class="line"><a id="l00007" name="l00007"></a><span class="lineno">    7</span><span class="comment">of this software and associated documentation files (the &quot;Software&quot;), to</span></div>

docs/api/html/yask__kernel__api_8hpp_source.html

@@ -85,7 +85,7 @@
 <a href="yask__kernel__api_8hpp.html">Go to the documentation of this file.</a><div class="fragment"><div class="line"><a id="l00001" name="l00001"></a><span class="lineno">    1</span><span class="comment">/*****************************************************************************</span></div>
 <div class="line"><a id="l00002" name="l00002"></a><span class="lineno">    2</span><span class="comment"></span> </div>
 <div class="line"><a id="l00003" name="l00003"></a><span class="lineno">    3</span><span class="comment">YASK: Yet Another Stencil Kit</span></div>
-<div class="line"><a id="l00004" name="l00004"></a><span class="lineno">    4</span><span class="comment">Copyright (c) 2014-2023, Intel Corporation</span></div>
+<div class="line"><a id="l00004" name="l00004"></a><span class="lineno">    4</span><span class="comment">Copyright (c) 2014-2024, Intel Corporation</span></div>
 <div class="line"><a id="l00005" name="l00005"></a><span class="lineno">    5</span><span class="comment"></span> </div>
 <div class="line"><a id="l00006" name="l00006"></a><span class="lineno">    6</span><span class="comment">Permission is hereby granted, free of charge, to any person obtaining a copy</span></div>
 <div class="line"><a id="l00007" name="l00007"></a><span class="lineno">    7</span><span class="comment">of this software and associated documentation files (the &quot;Software&quot;), to</span></div>

docs/api/html/yc__node__api_8hpp_source.html

@@ -85,7 +85,7 @@
 <a href="yc__node__api_8hpp.html">Go to the documentation of this file.</a><div class="fragment"><div class="line"><a id="l00001" name="l00001"></a><span class="lineno">    1</span><span class="comment">/*****************************************************************************</span></div>
 <div class="line"><a id="l00002" name="l00002"></a><span class="lineno">    2</span><span class="comment"></span> </div>
 <div class="line"><a id="l00003" name="l00003"></a><span class="lineno">    3</span><span class="comment">YASK: Yet Another Stencil Kit</span></div>
-<div class="line"><a id="l00004" name="l00004"></a><span class="lineno">    4</span><span class="comment">Copyright (c) 2014-2023, Intel Corporation</span></div>
+<div class="line"><a id="l00004" name="l00004"></a><span class="lineno">    4</span><span class="comment">Copyright (c) 2014-2024, Intel Corporation</span></div>
 <div class="line"><a id="l00005" name="l00005"></a><span class="lineno">    5</span><span class="comment"></span> </div>
 <div class="line"><a id="l00006" name="l00006"></a><span class="lineno">    6</span><span class="comment">Permission is hereby granted, free of charge, to any person obtaining a copy</span></div>
 <div class="line"><a id="l00007" name="l00007"></a><span class="lineno">    7</span><span class="comment">of this software and associated documentation files (the &quot;Software&quot;), to</span></div>

docs/api/html/yc__solution__api_8hpp_source.html

@@ -85,7 +85,7 @@
 <a href="yc__solution__api_8hpp.html">Go to the documentation of this file.</a><div class="fragment"><div class="line"><a id="l00001" name="l00001"></a><span class="lineno">    1</span><span class="comment">/*****************************************************************************</span></div>
 <div class="line"><a id="l00002" name="l00002"></a><span class="lineno">    2</span><span class="comment"></span> </div>
 <div class="line"><a id="l00003" name="l00003"></a><span class="lineno">    3</span><span class="comment">YASK: Yet Another Stencil Kit</span></div>
-<div class="line"><a id="l00004" name="l00004"></a><span class="lineno">    4</span><span class="comment">Copyright (c) 2014-2023, Intel Corporation</span></div>
+<div class="line"><a id="l00004" name="l00004"></a><span class="lineno">    4</span><span class="comment">Copyright (c) 2014-2024, Intel Corporation</span></div>
 <div class="line"><a id="l00005" name="l00005"></a><span class="lineno">    5</span><span class="comment"></span> </div>
 <div class="line"><a id="l00006" name="l00006"></a><span class="lineno">    6</span><span class="comment">Permission is hereby granted, free of charge, to any person obtaining a copy</span></div>
 <div class="line"><a id="l00007" name="l00007"></a><span class="lineno">    7</span><span class="comment">of this software and associated documentation files (the &quot;Software&quot;), to</span></div>

docs/api/html/yk__solution__api_8hpp_source.html

@@ -85,7 +85,7 @@
 <a href="yk__solution__api_8hpp.html">Go to the documentation of this file.</a><div class="fragment"><div class="line"><a id="l00001" name="l00001"></a><span class="lineno">    1</span><span class="comment">/*****************************************************************************</span></div>
 <div class="line"><a id="l00002" name="l00002"></a><span class="lineno">    2</span><span class="comment"></span> </div>
 <div class="line"><a id="l00003" name="l00003"></a><span class="lineno">    3</span><span class="comment">YASK: Yet Another Stencil Kit</span></div>
-<div class="line"><a id="l00004" name="l00004"></a><span class="lineno">    4</span><span class="comment">Copyright (c) 2014-2023, Intel Corporation</span></div>
+<div class="line"><a id="l00004" name="l00004"></a><span class="lineno">    4</span><span class="comment">Copyright (c) 2014-2024, Intel Corporation</span></div>
 <div class="line"><a id="l00005" name="l00005"></a><span class="lineno">    5</span><span class="comment"></span> </div>
 <div class="line"><a id="l00006" name="l00006"></a><span class="lineno">    6</span><span class="comment">Permission is hereby granted, free of charge, to any person obtaining a copy</span></div>
 <div class="line"><a id="l00007" name="l00007"></a><span class="lineno">    7</span><span class="comment">of this software and associated documentation files (the &quot;Software&quot;), to</span></div>

docs/api/html/yk__var__api_8hpp_source.html

@@ -85,7 +85,7 @@
 <a href="yk__var__api_8hpp.html">Go to the documentation of this file.</a><div class="fragment"><div class="line"><a id="l00001" name="l00001"></a><span class="lineno">    1</span><span class="comment">/*****************************************************************************</span></div>
 <div class="line"><a id="l00002" name="l00002"></a><span class="lineno">    2</span><span class="comment"></span> </div>
 <div class="line"><a id="l00003" name="l00003"></a><span class="lineno">    3</span><span class="comment">YASK: Yet Another Stencil Kit</span></div>
-<div class="line"><a id="l00004" name="l00004"></a><span class="lineno">    4</span><span class="comment">Copyright (c) 2014-2023, Intel Corporation</span></div>
+<div class="line"><a id="l00004" name="l00004"></a><span class="lineno">    4</span><span class="comment">Copyright (c) 2014-2024, Intel Corporation</span></div>
 <div class="line"><a id="l00005" name="l00005"></a><span class="lineno">    5</span><span class="comment"></span> </div>
 <div class="line"><a id="l00006" name="l00006"></a><span class="lineno">    6</span><span class="comment">Permission is hereby granted, free of charge, to any person obtaining a copy</span></div>
 <div class="line"><a id="l00007" name="l00007"></a><span class="lineno">    7</span><span class="comment">of this software and associated documentation files (the &quot;Software&quot;), to</span></div>