From b0ccc5aa49fa52044aa7a2bdd8647656df85415f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?J=C3=B6rg=20Thalheim?= <joerg@thalheim.io>
Date: Sun, 3 Aug 2025 07:20:32 +0200
Subject: [PATCH] docs/hacking: document how to run single tests

---
 doc/manual/src/hacking.md | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/doc/manual/src/hacking.md b/doc/manual/src/hacking.md
index 8b2b13ba..6815197a 100644
--- a/doc/manual/src/hacking.md
+++ b/doc/manual/src/hacking.md
@@ -46,6 +46,16 @@ $ meson test
 $ YATH_JOB_COUNT=$NIX_BUILD_CORES meson test
 ```
 
+To run individual tests:
+
+```console
+# Run a specific test file
+$ PERL5LIB=t/lib:$PERL5LIB perl t/test.pl t/Hydra/Controller/API/checks.t
+
+# Run all tests in a directory
+$ PERL5LIB=t/lib:$PERL5LIB perl t/test.pl t/Hydra/Controller/API/
+```
+
 **Warning**: Currently, the tests can fail
 if run with high parallelism [due to an issue in
 `Test::PostgreSQL`](https://github.com/TJC/Test-postgresql/issues/40)