[docs] do not tell users to delete /usr/bin/python3 - #11790
Conversation
Section 3.2.1 of the QEMU (Ubuntu) quick start instructs the reader to run "sudo rm -rf /usr/bin/python3" and re-create the symlink by hand. On Debian and Ubuntu, apt and much of the system tooling are Python programs resolved through that path, so following the guide leaves the machine unable to install packages at all - including the packages needed to undo it. The hardcoded 3.9 version in the example also goes stale with every release. Replace it with python-is-python3, which is what provides the python command on these distributions, and add a warning against the manual approach. Drop the now unreferenced screenshot.
|
👋 感谢您对 RT-Thread 的贡献!Thank you for your contribution to RT-Thread! 为确保代码符合 RT-Thread 的编码规范,请在你的仓库中执行以下步骤运行代码格式化工作流(如果格式化CI运行失败)。 🛠 操作步骤 | Steps
完成后,提交将自动更新至 如有问题欢迎联系我们,再次感谢您的贡献!💐 |
|
Cheng Li seems not to be a GitHub user. You need a GitHub account to be able to sign the CLA. If you have already a GitHub account, please add the email address used for this commit to your account. You have signed the CLA already but the status is still pending? Let us recheck it. |
📌 Code Review Assignment🏷️ Tag: documentationReviewers: @CXSforHPU @GorrayLi @lianux-mm Changed Files (Click to expand)
📊 Current Review Status (Last Updated: 2026-09-08 22:11 CST)
📝 Review Instructions
|
Problem
Section 3.2.1 of
documentation/2.quick-start/quick_start_qemu/quick_start_qemu_linux.mdinstructs the reader to run:On Debian and Ubuntu,
aptand much of the system tooling are Python programs resolved through/usr/bin/python3, so following the guide leaves the machine unable to install packages at all — including the packages needed to undo it. The hardcoded3.9version also goes stale with every release.Change
python-is-python3, which is how these distributions provide thepythoncommand