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

Muhammad Kamran Khan (@Muhammad-Kamran-Khan) gitlab at rtems.org
Mon Dec 29 11:53:29 UTC 2025



Muhammad Kamran Khan created a merge request: https://gitlab.rtems.org/rtems/docs/rtems-docs/-/merge_requests/202

Project:Branches: Muhammad-Kamran-Khan/rtems-docs:fix-wsl-config-docs to rtems/docs/rtems-docs:main
Author:   Muhammad Kamran Khan




**Reason for Change:**
1.  **WSL Path Issue:** Users on Windows Subsystem for Linux (WSL) often face issues where `export PATH=...` overrides the system path, breaking access to Windows tools like `code` (VS Code) and `explorer.exe`. Added a warning and solution for this.
2.  **Config.ini Clarity:** The step to create `config.ini` was hidden inside a text block and easy to miss, causing build failures for new users. Added a critical step note to highlight this requirement.

**Updates:**
- Added a warning block for WSL users regarding PATH modification.
- Added a "Critical Step" note before the `waf configure` command.

-- 
View it on GitLab: https://gitlab.rtems.org/rtems/docs/rtems-docs/-/merge_requests/202
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/20251229/968d5815/attachment.htm>


More information about the bugs mailing list