# Known bugs

This document tracks currently known issues and limitations.

## Open issues

- None :-)

---

## Won't fix

These issues are caused by platform or environment limitations outside the scope of this
project and will not be addressed in Bash.

### Prompt execution time is inaccurate in Windows Terminal (WSL)

- **Description:** In Windows Terminal the displayed duration includes idle and typing time,
  and is consistently higher than actual command execution time. In a native Linux terminal
  (including WSL shells inside Konsole, QTerminal, etc.) timing correctly starts on Enter and
  stops when the prompt reappears; in Windows Terminal, timer events appear tied to prompt
  display rather than to the Enter keypress.
- **Cause:** Execution time is measured via a `DEBUG` trap and `PROMPT_COMMAND` using
  `date +%s%N` deltas. WSL + Windows Terminal introduces scheduling jitter between Bash signal
  events and the underlying Windows terminal layer that does not match wall-clock perception.
- **Impact:** Cosmetic / observability only — commands execute normally.
- **Status:** Not fixable in Bash; this is a limitation of the Windows Terminal / WSL
  integration layer.
- **Workarounds:**
  - Use a native Linux terminal under WSL (Konsole, QTerminal, Terminator, etc.) to
    recover the expected Enter→prompt timing behavior.
  - Use `/usr/bin/time -p <command>` or the shell built-in `time` when accurate timing
    is required.
  - Treat prompt timing as an inacurate indicator in this environment.

### Rain/Matrix rendering is slow on Windows

- **Description:** The rain, matrix and rainbow terminal effects are significantly slower
  on Windows, especially with high density settings on every terminal software.
- **Cause:** This is due to the way Windows handles terminal display updates, which is
  inherently less efficient than on Unix-like systems.
- **Status:** Not fixable in Bash; this is a limitation of Windows terminal design.
- **Workaround:** Lower the density parameter for better performance, or use a Unix-like
  environment for optimal speed.