Documentation | user/start: Add WSL path warning and clarify config.ini step (!202)

Thu Jan 8 14:55:41 UTC 2026

Kinsey Moore started a new discussion on user/start/bsp-build.md: https://gitlab.rtems.org/rtems/docs/rtems-docs/-/merge_requests/202#note_138133

 >  ```none
 >  export PATH=$HOME/quick-start/rtems/@rtems-ver-major@/bin:"$PATH"
 >  ```
 > +> **Warning for Windows (WSL) Users:**
 > +> If you are using Windows Subsystem for Linux (WSL), ensure that you append to your existing PATH (using `:$PATH`) rather than overwriting it. Overwriting the PATH will cause Windows tools like `explorer.exe` or VS Code (`code`) to stop working from the terminal.
 > +>
 > +> **Solution:** If you lose access to these tools, you can still execute them using their absolute path (e.g., `/mnt/c/Windows/explorer.exe`) or restore access by restarting your terminal session.

This warning applies to almost any environment, not just WSL terminals.

-- 
View it on GitLab: https://gitlab.rtems.org/rtems/docs/rtems-docs/-/merge_requests/202#note_138133
You're receiving this email because of your account on gitlab.rtems.org.

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.rtems.org/pipermail/bugs/attachments/20260108/366edb27/attachment.htm>