env
env copied to clipboard
Add troubleshooting section for Ubuntu 23.04+ installation issues
Description
This PR adds a troubleshooting section to the README.md to help users resolve installation issues on Ubuntu 23.04 and later versions.
Problem
On Ubuntu 23.04+, the installation script may complete successfully, but users may encounter ModuleNotFoundError errors when using commands like pkgs or scons --menuconfig. This is due to PEP 668 restrictions that prevent pip install from installing packages into system-wide locations.
Solution
Added a new "Troubleshooting" section in the README.md that:
- Explains the issue with PEP 668 restrictions on Ubuntu 23.04+
- Provides a clear solution using system package manager (
apt install) - Lists the specific packages needed:
python3-tqdmandpython3-kconfiglib
Changes
- Added "Troubleshooting" section after "Prepare Env" section in README.md
- Includes instructions for Ubuntu 23.04+ users to manually install missing dependencies
Testing
- Verified the documentation format and clarity
- Confirmed the solution works on Ubuntu 23.04+ systems
Related Issues
This addresses installation issues on newer Ubuntu versions where PEP 668 restrictions cause module import errors after installation.