From bec881ce7dcce6b2eb9df195764e3acafa91c4a0 Mon Sep 17 00:00:00 2001
From: smathis <stefan.mathis@psi.ch>
Date: Thu, 24 Jul 2025 08:52:31 +0200
Subject: [PATCH] Expanded documentation

---
 README.md | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/README.md b/README.md
index 704f79f..366f101 100755
--- a/README.md
+++ b/README.md
@@ -59,6 +59,22 @@ pytest tests/sinqMotor/turboPmac/
 ```
 This runs all Turbo PMAC tests within the directory.
 
+To run a specific test file:
+```console
+pytest tests/sinqMotor/turboPmac/lin1/test_common.py
+```
+
+And to run a specific test "test_something" within this file:
+```console
+pytest tests/sinqMotor/turboPmac/lin1/test_common.py -k 'test_something'
+```
+
+Pytest normally suppresses stdout (which is where Pythons `print` writes by default).
+To show it, use the `-s` flag:
+```console
+pytest -s tests/sinqMotor/turboPmac/lin1/test_common.py -k 'test_something'
+```
+
 ## Running custom scripts
 
 The test framework can also be used to run custom scripts. The file