From 57c09f226afb330f0483acecbe4c38612763074a Mon Sep 17 00:00:00 2001
From: Luca Toniolo <10792599+grandixximo@users.noreply.github.com>
Date: Wed, 3 Jun 2026 07:58:27 +0800
Subject: [PATCH] docs(build): filter checklink's Perl noise in checkref

w3c-linkchecker prints "Use of uninitialized value ... checklink line N"
to stderr on some inputs; it is tool noise, not link results, and floods
the build/CI log. Drop those lines; checklink stays first in the pipe so
PIPESTATUS[0] is unchanged.
---
 docs/src/checkref | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/docs/src/checkref b/docs/src/checkref
index b199a297658..bdd62af0585 100755
--- a/docs/src/checkref
+++ b/docs/src/checkref
@@ -25,7 +25,11 @@ for F in "$@"; do
     # --follow-file-links is required: recent w3c-linkchecker refuses file://
     # URIs by default, so without it checklink never inspects the local file
     # and validates nothing.
-    linuxcnc-checklink --quiet --follow-file-links --exclude "(http|https|irc)://" "$F"  2>&1 | tee "$OUT"
+    #
+    # Drop checklink's own "uninitialized value ... checklink line N" Perl
+    # noise (not link results).  checklink stays first, so PIPESTATUS[0] holds.
+    linuxcnc-checklink --quiet --follow-file-links --exclude "(http|https|irc)://" "$F" 2>&1 \
+        | grep -vE 'Use of uninitialized value .* at .*checklink line [0-9]+' | tee "$OUT"
     STATUS=${PIPESTATUS[0]}
     # Distinguish "checklink never inspected the file" from "checklink ran and
     # found problems".  It exits 64 when it reports broken links, so a nonzero