From 1c696a0ef09fc302874c25e924cfbc5c4c95ce30 Mon Sep 17 00:00:00 2001
From: Athan Reines <kgryte@gmail.com>
Date: Sun, 14 Apr 2024 15:47:04 -0700
Subject: [PATCH] build: add separate configurations for benchmarks and
 examples

---
 .../blas/base/dswap/benchmark/c/Makefile      |  31 ++-
 .../blas/base/dswap/examples/c/Makefile       |  33 ++-
 .../@stdlib/blas/base/dswap/manifest.json     | 210 ++++++++++++++++++
 3 files changed, 259 insertions(+), 15 deletions(-)

diff --git a/lib/node_modules/@stdlib/blas/base/dswap/benchmark/c/Makefile b/lib/node_modules/@stdlib/blas/base/dswap/benchmark/c/Makefile
index a02f60e8f44..7280962b4c4 100644
--- a/lib/node_modules/@stdlib/blas/base/dswap/benchmark/c/Makefile
+++ b/lib/node_modules/@stdlib/blas/base/dswap/benchmark/c/Makefile
@@ -69,8 +69,17 @@ else
 	fPIC ?= -fPIC
 endif
 
+# List of includes (e.g., `-I /foo/bar -I /beep/boop/include`):
+INCLUDE ?=
+
 # List of source files:
-c_src := ../../src/dswap.c
+SOURCE_FILES ?=
+
+# List of libraries (e.g., `-lopenblas -lpthread`):
+LIBRARIES ?=
+
+# List of library paths (e.g., `-L /foo/bar -L /beep/boop`):
+LIBPATH ?=
 
 # List of C targets:
 c_targets := benchmark.length.out
@@ -79,11 +88,15 @@ c_targets := benchmark.length.out
 # RULES #
 
 #/
-# Compiles C source files.
+# Compiles source files.
 #
 # @param {string} [C_COMPILER] - C compiler (e.g., `gcc`)
 # @param {string} [CFLAGS] - C compiler options
-# @param {(string|void)} [fPIC] - compiler flag indicating whether to generate position independent code (e.g., `-fPIC`)
+# @param {(string|void)} [fPIC] - compiler flag determining whether to generate position independent code (e.g., `-fPIC`)
+# @param {string} [INCLUDE] - list of includes (e.g., `-I /foo/bar -I /beep/boop/include`)
+# @param {string} [SOURCE_FILES] - list of source files
+# @param {string} [LIBPATH] - list of library paths (e.g., `-L /foo/bar -L /beep/boop`)
+# @param {string} [LIBRARIES] - list of libraries (e.g., `-lopenblas -lpthread`)
 #
 # @example
 # make
@@ -99,12 +112,16 @@ all: $(c_targets)
 # Compiles C source files.
 #
 # @private
-# @param {string} CC - C compiler
-# @param {string} CFLAGS - C compiler flags
-# @param {(string|void)} fPIC - compiler flag indicating whether to generate position independent code
+# @param {string} CC - C compiler (e.g., `gcc`)
+# @param {string} CFLAGS - C compiler options
+# @param {(string|void)} fPIC - compiler flag determining whether to generate position independent code (e.g., `-fPIC`)
+# @param {string} INCLUDE - list of includes (e.g., `-I /foo/bar`)
+# @param {string} SOURCE_FILES - list of source files
+# @param {string} LIBPATH - list of library paths (e.g., `-L /foo/bar`)
+# @param {string} LIBRARIES - list of libraries (e.g., `-lopenblas`)
 #/
 $(c_targets): %.out: %.c
-	$(QUIET) $(CC) $(CFLAGS) $(fPIC) -I ../../include -o $@ $(c_src) $< -lm
+	$(QUIET) $(CC) $(CFLAGS) $(fPIC) $(INCLUDE) -o $@ $(SOURCE_FILES) $< $(LIBPATH) -lm $(LIBRARIES)
 
 #/
 # Runs compiled benchmarks.
diff --git a/lib/node_modules/@stdlib/blas/base/dswap/examples/c/Makefile b/lib/node_modules/@stdlib/blas/base/dswap/examples/c/Makefile
index 89cc603d9eb..ff5293d3059 100644
--- a/lib/node_modules/@stdlib/blas/base/dswap/examples/c/Makefile
+++ b/lib/node_modules/@stdlib/blas/base/dswap/examples/c/Makefile
@@ -69,8 +69,17 @@ else
 	fPIC ?= -fPIC
 endif
 
+# List of includes (e.g., `-I /foo/bar -I /beep/boop/include`):
+INCLUDE ?=
+
 # List of source files:
-c_src := ../../src/dswap.c
+SOURCE_FILES ?=
+
+# List of libraries (e.g., `-lopenblas -lpthread`):
+LIBRARIES ?=
+
+# List of library paths (e.g., `-L /foo/bar -L /beep/boop`):
+LIBPATH ?=
 
 # List of C targets:
 c_targets := example.out
@@ -79,11 +88,15 @@ c_targets := example.out
 # RULES #
 
 #/
-# Compiles C source files.
+# Compiles source files.
 #
 # @param {string} [C_COMPILER] - C compiler (e.g., `gcc`)
 # @param {string} [CFLAGS] - C compiler options
-# @param {(string|void)} [fPIC] - compiler flag indicating whether to generate position independent code (e.g., `-fPIC`)
+# @param {(string|void)} [fPIC] - compiler flag determining whether to generate position independent code (e.g., `-fPIC`)
+# @param {string} [INCLUDE] - list of includes (e.g., `-I /foo/bar -I /beep/boop/include`)
+# @param {string} [SOURCE_FILES] - list of source files
+# @param {string} [LIBPATH] - list of library paths (e.g., `-L /foo/bar -L /beep/boop`)
+# @param {string} [LIBRARIES] - list of libraries (e.g., `-lopenblas -lpthread`)
 #
 # @example
 # make
@@ -99,15 +112,19 @@ all: $(c_targets)
 # Compiles C source files.
 #
 # @private
-# @param {string} CC - C compiler
-# @param {string} CFLAGS - C compiler flags
-# @param {(string|void)} fPIC - compiler flag indicating whether to generate position independent code
+# @param {string} CC - C compiler (e.g., `gcc`)
+# @param {string} CFLAGS - C compiler options
+# @param {(string|void)} fPIC - compiler flag determining whether to generate position independent code (e.g., `-fPIC`)
+# @param {string} INCLUDE - list of includes (e.g., `-I /foo/bar`)
+# @param {string} SOURCE_FILES - list of source files
+# @param {string} LIBPATH - list of library paths (e.g., `-L /foo/bar`)
+# @param {string} LIBRARIES - list of libraries (e.g., `-lopenblas`)
 #/
 $(c_targets): %.out: %.c
-	$(QUIET) $(CC) $(CFLAGS) $(fPIC) -I ../../include -o $@ $(c_src) $< -lm
+	$(QUIET) $(CC) $(CFLAGS) $(fPIC) $(INCLUDE) -o $@ $(SOURCE_FILES) $< $(LIBPATH) -lm $(LIBRARIES)
 
 #/
-# Runs compiled benchmarks.
+# Runs compiled examples.
 #
 # @example
 # make run
diff --git a/lib/node_modules/@stdlib/blas/base/dswap/manifest.json b/lib/node_modules/@stdlib/blas/base/dswap/manifest.json
index e89f90fd318..a701f5d167a 100644
--- a/lib/node_modules/@stdlib/blas/base/dswap/manifest.json
+++ b/lib/node_modules/@stdlib/blas/base/dswap/manifest.json
@@ -1,5 +1,6 @@
 {
   "options": {
+    "task": "build",
     "os": "linux",
     "blas": "",
     "wasm": false
@@ -28,6 +29,7 @@
   ],
   "confs": [
     {
+      "task": "build",
       "os": "linux",
       "blas": "",
       "wasm": false,
@@ -48,6 +50,38 @@
       ]
     },
     {
+      "task": "benchmark",
+      "os": "linux",
+      "blas": "",
+      "wasm": false,
+      "src": [
+        "./src/dswap.c"
+      ],
+      "include": [
+        "./include"
+      ],
+      "libraries": [],
+      "libpath": [],
+      "dependencies": []
+    },
+    {
+      "task": "examples",
+      "os": "linux",
+      "blas": "",
+      "wasm": false,
+      "src": [
+        "./src/dswap.c"
+      ],
+      "include": [
+        "./include"
+      ],
+      "libraries": [],
+      "libpath": [],
+      "dependencies": []
+    },
+
+    {
+      "task": "build",
       "os": "linux",
       "blas": "openblas",
       "wasm": false,
@@ -70,6 +104,44 @@
       ]
     },
     {
+      "task": "benchmark",
+      "os": "linux",
+      "blas": "openblas",
+      "wasm": false,
+      "src": [
+        "./src/dswap_cblas.c"
+      ],
+      "include": [
+        "./include"
+      ],
+      "libraries": [
+        "-lopenblas",
+        "-lpthread"
+      ],
+      "libpath": [],
+      "dependencies": []
+    },
+    {
+      "task": "examples",
+      "os": "linux",
+      "blas": "openblas",
+      "wasm": false,
+      "src": [
+        "./src/dswap_cblas.c"
+      ],
+      "include": [
+        "./include"
+      ],
+      "libraries": [
+        "-lopenblas",
+        "-lpthread"
+      ],
+      "libpath": [],
+      "dependencies": []
+    },
+
+    {
+      "task": "build",
       "os": "mac",
       "blas": "",
       "wasm": false,
@@ -90,6 +162,38 @@
       ]
     },
     {
+      "task": "benchmark",
+      "os": "mac",
+      "blas": "",
+      "wasm": false,
+      "src": [
+        "./src/dswap.c"
+      ],
+      "include": [
+        "./include"
+      ],
+      "libraries": [],
+      "libpath": [],
+      "dependencies": []
+    },
+    {
+      "task": "examples",
+      "os": "mac",
+      "blas": "",
+      "wasm": false,
+      "src": [
+        "./src/dswap.c"
+      ],
+      "include": [
+        "./include"
+      ],
+      "libraries": [],
+      "libpath": [],
+      "dependencies": []
+    },
+
+    {
+      "task": "build",
       "os": "mac",
       "blas": "apple_accelerate_framework",
       "wasm": false,
@@ -111,6 +215,42 @@
       ]
     },
     {
+      "task": "benchmark",
+      "os": "mac",
+      "blas": "apple_accelerate_framework",
+      "wasm": false,
+      "src": [
+        "./src/dswap_cblas.c"
+      ],
+      "include": [
+        "./include"
+      ],
+      "libraries": [
+        "-lblas"
+      ],
+      "libpath": [],
+      "dependencies": []
+    },
+    {
+      "task": "examples",
+      "os": "mac",
+      "blas": "apple_accelerate_framework",
+      "wasm": false,
+      "src": [
+        "./src/dswap_cblas.c"
+      ],
+      "include": [
+        "./include"
+      ],
+      "libraries": [
+        "-lblas"
+      ],
+      "libpath": [],
+      "dependencies": []
+    },
+
+    {
+      "task": "build",
       "os": "mac",
       "blas": "openblas",
       "wasm": false,
@@ -133,6 +273,44 @@
       ]
     },
     {
+      "task": "benchmark",
+      "os": "mac",
+      "blas": "openblas",
+      "wasm": false,
+      "src": [
+        "./src/dswap_cblas.c"
+      ],
+      "include": [
+        "./include"
+      ],
+      "libraries": [
+        "-lopenblas",
+        "-lpthread"
+      ],
+      "libpath": [],
+      "dependencies": []
+    },
+    {
+      "task": "examples",
+      "os": "mac",
+      "blas": "openblas",
+      "wasm": false,
+      "src": [
+        "./src/dswap_cblas.c"
+      ],
+      "include": [
+        "./include"
+      ],
+      "libraries": [
+        "-lopenblas",
+        "-lpthread"
+      ],
+      "libpath": [],
+      "dependencies": []
+    },
+
+    {
+      "task": "build",
       "os": "win",
       "blas": "",
       "wasm": false,
@@ -152,6 +330,38 @@
       ]
     },
     {
+      "task": "benchmark",
+      "os": "win",
+      "blas": "",
+      "wasm": false,
+      "src": [
+        "./src/dswap.c"
+      ],
+      "include": [
+        "./include"
+      ],
+      "libraries": [],
+      "libpath": [],
+      "dependencies": []
+    },
+    {
+      "task": "examples",
+      "os": "win",
+      "blas": "",
+      "wasm": false,
+      "src": [
+        "./src/dswap.c"
+      ],
+      "include": [
+        "./include"
+      ],
+      "libraries": [],
+      "libpath": [],
+      "dependencies": []
+    },
+
+    {
+      "task": "build",
       "os": "",
       "blas": "",
       "wasm": true,