From 45397b9e83382b1a769b01801837d1780d274a67 Mon Sep 17 00:00:00 2001
From: Dario Camonita <danterolle@parrotsec.org>
Date: Thu, 11 Sep 2025 16:53:51 +0200
Subject: [PATCH 1/2] docs(troubleshooting): overriding the $TERM to a more
 compatible value like xterm-256color

---
 docs/Developer-Guide_Build-Preparation.md | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/docs/Developer-Guide_Build-Preparation.md b/docs/Developer-Guide_Build-Preparation.md
index 5f3c1fdac..9507efb0e 100644
--- a/docs/Developer-Guide_Build-Preparation.md
+++ b/docs/Developer-Guide_Build-Preparation.md
@@ -68,6 +68,15 @@ Run framework:
 ./compile.sh [command] [switch...] [config...]
 ```
 
+!!! tip "Troubleshooting: 'unknown terminal type' error"
+When running the script, especially from modern terminal emulators (like Ghostty, Kitty, WezTerm), you might encounter an error like 'xterm-ghostty': unknown terminal type
+
+**Quick Workaround:** You can force a more common terminal type before running the script:
+```bash
+export TERM=xterm-256color
+./compile.sh
+```
+
 Only one command can be specified.
 
 Switches are parameter settings that are used by the build framework itself

From 00d0eccf46046c70dcc063917aa9bcb8d1f82b75 Mon Sep 17 00:00:00 2001
From: Dario Camonita <danterolle@parrotsec.org>
Date: Thu, 11 Sep 2025 17:29:55 +0200
Subject: [PATCH 2/2] docs(troubleshooting): update terminal type workaround to
 use env

---
 docs/Developer-Guide_Build-Preparation.md | 13 +++++++------
 1 file changed, 7 insertions(+), 6 deletions(-)

diff --git a/docs/Developer-Guide_Build-Preparation.md b/docs/Developer-Guide_Build-Preparation.md
index 9507efb0e..a6acf64d7 100644
--- a/docs/Developer-Guide_Build-Preparation.md
+++ b/docs/Developer-Guide_Build-Preparation.md
@@ -69,13 +69,14 @@ Run framework:
 ```
 
 !!! tip "Troubleshooting: 'unknown terminal type' error"
-When running the script, especially from modern terminal emulators (like Ghostty, Kitty, WezTerm), you might encounter an error like 'xterm-ghostty': unknown terminal type
+    When running the script, especially from modern terminal emulators (like Ghostty, Kitty, WezTerm), you might encounter an error like
 
-**Quick Workaround:** You can force a more common terminal type before running the script:
-```bash
-export TERM=xterm-256color
-./compile.sh
-```
+    'xterm-ghostty': unknown terminal type
+
+    **Quick workaround:** you can force a more common terminal type before running the script:
+    ```bash
+    env TERM=xterm-256color ./compile.sh
+    ```
 
 Only one command can be specified.