Muhammad Kamran Khan commented on a discussion on user/start/bsp-build.md: https://gitlab.rtems.org/rtems/docs/rtems-docs/-/merge_requests/202#note_138351 > ```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. @opticron Thank you for the feedback. You are absolutely right that overwriting PATH is bad practice in any environment. I specifically labeled this 'WSL' because the symptom (losing access to Windows tools like `explorer.exe` and `code`) is unique to WSL and very confusing for new users. Would you prefer I change the header to a generic **"Warning regarding PATH"**, or keep it specific to WSL for this Quick Start guide? -- View it on GitLab: https://gitlab.rtems.org/rtems/docs/rtems-docs/-/merge_requests/202#note_138351 You're receiving this email because of your account on gitlab.rtems.org.
_______________________________________________ bugs mailing list [email protected] http://lists.rtems.org/mailman/listinfo/bugs
