From 313ad99ec45c808fd2033d0d432e29d914a89769 Mon Sep 17 00:00:00 2001
From: Luca Toniolo <10792599+grandixximo@users.noreply.github.com>
Date: Thu, 11 Jun 2026 11:09:27 +0800
Subject: [PATCH] tests: move rand.comp out of docs/src, drop unused out8.comp

Both files duplicate examples already inlined in docs/src/hal/comp.adoc
and are not part of the docs build. rand.comp is only used to generate
the halcompile/userspace test input, so move it next to that test.
out8.comp is referenced nowhere; delete it.

Fixes #4145
---
 docs/src/hal/out8.comp                        | 44 -------------------
 tests/Submakefile                             |  2 +-
 .../halcompile/userspace}/rand.comp           |  0
 3 files changed, 1 insertion(+), 45 deletions(-)
 delete mode 100644 docs/src/hal/out8.comp
 rename {docs/src/hal => tests/halcompile/userspace}/rand.comp (100%)

diff --git a/docs/src/hal/out8.comp b/docs/src/hal/out8.comp
deleted file mode 100644
index 9ee84651b26..00000000000
--- a/docs/src/hal/out8.comp
+++ /dev/null
@@ -1,44 +0,0 @@
-component out8;
-pin out unsigned out_ "Output value; only low 8 bits are used";
-param r unsigned ioaddr;
-
-function _;
-
-option count_function;
-option extra_setup;
-option extra_cleanup;
-option constructable no;
-
-license "GPL";
-;;
-#include <asm/io.h>
-
-#define MAX 8
-int io[MAX] = {0,};
-RTAPI_MP_ARRAY_INT(io, MAX, "I/O addresses of out8 boards");
-
-int get_count(void) {
-    int i = 0;
-    for(i=0; i<MAX && io[i]; i++) { /* Nothing */ }
-    return i;
-}
-
-EXTRA_SETUP() {
-    if(!rtapi_request_region(io[extra_arg], 1, "out8")) {
-	// set this I/O port to 0 so that EXTRA_CLEANUP does not release the IO
-	// ports that were never requested.
-        io[extra_arg] = 0; 
-        return -EBUSY;
-    }
-    ioaddr = io[extra_arg];
-    return 0;
-}
-
-EXTRA_CLEANUP() {
-    int i;
-    for(i=0; i < MAX && io[i]; i++) {
-        rtapi_release_region(io[i], 1);
-    }
-}
-
-FUNCTION(_) { outb(out_, ioaddr); }
diff --git a/tests/Submakefile b/tests/Submakefile
index 608e64ee9c2..b20f232661b 100644
--- a/tests/Submakefile
+++ b/tests/Submakefile
@@ -17,7 +17,7 @@ $(PERSONALITIES_MOD_COMPS): ../tests/halcompile/personalities_mod/%_test.comp: \
 	sed $< -e "1 s/mesa_uart/mesa_uart_test/" > $@
 
 ../tests/halcompile/userspace/rand_test.comp: \
-		../docs/src/hal/rand.comp
+		../tests/halcompile/userspace/rand.comp
 	sed $< -e "1 s/rand/rand_test/" > $@
 
 ../tests/uspace/spawnv-root/rtapi.conf: ../scripts/rtapi.conf
diff --git a/docs/src/hal/rand.comp b/tests/halcompile/userspace/rand.comp
similarity index 100%
rename from docs/src/hal/rand.comp
rename to tests/halcompile/userspace/rand.comp