docs(troubleshooting): overriding the $TERM to a more compatible value like xterm-256color

This commit is contained in:
Dario Camonita
2025-09-11 16:53:51 +02:00
committed by Igor
parent f57516059a
commit cc48b115a8

View File

@@ -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