[Bug] macOS QEMU quick start documents a literal PATH suffix and a missing restart script

未關閉 適合新手
#12,082 1 則留言 0 個 reaction 已指派 0 人 在 GitHub 檢視

維護者通常 2 天內回覆

還沒有人認領這個 Issue。

評估

難度
1/5
預估耗時
1 小時以內
新手友好度
90/100
Issue 類型
文件
描述清晰度
描述清楚
活躍度
活躍
技術堆疊
bash, markdown
領域
documentation

研究方向

從 documentation/2.quick-start/quick_start_qemu/quick_start_qemu_macos.md 開始:閱讀步驟 1.3(第 38-49 行)和步驟 5.3(第 162-171 行),然後列出 bsp/qemu-vexpress-a9 以確認可用的腳本名稱。修改 PATH 範例,在引號內的值中使用 $HOME,並將 ./qemu_nographic.sh 替換為 ./qemu-nographic.sh,或像步驟 5.1 那樣指向 ./qemu.sh。完成條件是兩個步驟都指出可用的命令,且 PATH 後綴展開為絕對路徑。

由索引模型根據 Issue 內容生成。

描述

Arch: ARM/AArch64 Doc
RT-Thread Version

master at 6fdfe70062ec394e5dd7099c51cbcff127cacab1

Affected area

Documentation

Hardware/BSP vendor

Not applicable / Other

Architecture

ARM / AArch64

Board and hardware details

bsp/qemu-vexpress-a9 (emulated ARM vexpress A9). The affected instructions target an Intel macOS host.

Develop Toolchain

GCC

Describe the bug

Two commands in the Intel macOS QEMU quick start can block readers:

  1. Step 1.3 adds a quoted ~ to PATH. Inspecting the final component with printf '%s\n' "${PATH##*:}" shows it is stored literally. In a Bash POSIX-mode test, the documented pattern failed to locate an executable under the home directory. Using $HOME inside the quoted value sets an absolute path. Quick start, step 1.3 · Bash POSIX mode
  2. Step 5.3 asks readers to run ./qemu_nographic.sh after formatting sd0. This name is absent from the BSP directory. Readers can restart using ./qemu.sh as in step 5.1, or ./qemu-nographic.sh for a terminal-only session. Quick start, step 5.3 · BSP directory
Other additional context

Verified the PATH behavior with a temporary executable in Git Bash and checked the script names and executable modes in the repository tree. No macOS build or QEMU boot was performed. Drafted with assistance from OpenAI Codex.

主要語言
C
星號
12.4k
分支
5.5k
平均合併
3 天 7 小時
30 天內合併 PR
79

環境準備

在 Codespaces 中開啟

在瀏覽器裡用你自己的 GitHub 帳號啟動這個專案的開發容器。

從這裡開始

  1. 先讀完整個 Issue,再讀專案的貢獻指南。
  2. 在 Issue 下留言說明你要接手 —— 這能避免兩個人做同樣的事。
  3. Fork 儲存庫,在一個分支上完成修改。
  4. 送出 Pull Request,並在描述裡引用這個 Issue 編號。

RT-Thread/rt-thread 的其他 Issue

查看 RT-Thread/rt-thread 的全部 Issue

相似的 Issue

更多 C Issue

把新 issue 寄到你的電子郵件信箱

精選適合新手參與的 GitHub issue 摘要。