From cc48b115a85094ccfda42c78d1daa6e043fdbe07 Mon Sep 17 00:00:00 2001 From: Dario Camonita Date: Thu, 11 Sep 2025 16:53:51 +0200 Subject: [PATCH] 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 5f3c1fda..9507efb0 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