[Bug] macOS QEMU quick start documents a literal PATH suffix and a missing restart script
維護者通常 2 天內回覆
還沒有人認領這個 Issue。
評估
- 難度
- 1/5
- 預估耗時
- 1 小時以內
- 新手友好度
- 90/100
- Issue 類型
- 文件
- 描述清晰度
- 描述清楚
- 活躍度
- 活躍
- 技術堆疊
- bash, markdown
研究方向
從 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 內容生成。
描述
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:
- Step 1.3 adds a quoted
~toPATH. Inspecting the final component withprintf '%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$HOMEinside the quoted value sets an absolute path. Quick start, step 1.3 · Bash POSIX mode - Step 5.3 asks readers to run
./qemu_nographic.shafter formattingsd0. This name is absent from the BSP directory. Readers can restart using./qemu.shas in step 5.1, or./qemu-nographic.shfor 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
環境準備
在瀏覽器裡用你自己的 GitHub 帳號啟動這個專案的開發容器。
- 沒有 Dockerfile 或 Docker Compose 檔案
- 有 Pull Request 範本
- 閱讀貢獻指南
從這裡開始
- 先讀完整個 Issue,再讀專案的貢獻指南。
- 在 Issue 下留言說明你要接手 —— 這能避免兩個人做同樣的事。
- Fork 儲存庫,在一個分支上完成修改。
- 送出 Pull Request,並在描述裡引用這個 Issue 編號。
RT-Thread/rt-thread 的其他 Issue
-
bug
難度 2/5 1-3 小時 新手友好度 67/100
RT-Thread/rt-thread#11951 · 2 則留言 ·
維護者通常 2 天內回覆
-
[Bug] [libc] timer_gettime 拆秒前将总纳秒截断为 uint32_t,剩余时间查询错误可能重新可做 @Yunlk 於 28 天前認領,目前沒有進行中的 PR。 未關閉in progress
難度 2/5 1-3 小時 新手友好度 68/100
RT-Thread/rt-thread#11924 · 7 則留言 · 已指派 1 人 ·
維護者通常 2 天內回覆
-
[Bug] dfs_v2 tmpfs: ftruncate(fd, 0) frees the file buffer but reports success — use-after-free read/write and double free from a legal POSIX call可能已有人在做 @remukisama 於 32 天前認領。 未關閉in progress
難度 2/5 1-3 小時 新手友好度 78/100
RT-Thread/rt-thread#11902 · 4 則留言 · 已指派 1 人 ·
維護者通常 2 天內回覆
-
[bsp][stm32][bluepill] README「快速上手」缺少重新生成 MDK 工程这一步,按文档操作无法编译通过可能重新可做 @moment-NEW 於 50 天前認領,目前沒有進行中的 PR。 未關閉in progress
難度 2/5 1-3 小時 新手友好度 75/100
RT-Thread/rt-thread#11818 · 4 則留言 · 已指派 1 人 ·
維護者通常 2 天內回覆
-
Arch: RISC-V BSP BSP: HPMicro bug
難度 2/5 1-3 小時 新手友好度 72/100
RT-Thread/rt-thread#11687 · 6 則留言 ·
維護者通常 2 天內回覆
查看 RT-Thread/rt-thread 的全部 Issue
相似的 Issue
-
難度 2/5 1-3 小時 新手友好度 72/100
apache/nuttx-apps#4108 · 4 則留言 ·
維護者通常 1 天內回覆
-
難度 1/5 1 小時以內 新手友好度 82/100
trezor/trezor-firmware#8357 ·
維護者通常 2 天內回覆
-
ivorysql_ora: DBMS_SESSION lacks SLEEP (documented, not covered by #2763)可能已有人在做 關聯的 PR 仍在進行中或已合併。 未關閉
難度 2/5 1-3 小時 新手友好度 68/100
維護者通常 1 天內回覆
-
good first issue kernel
難度 2/5 1-3 小時 新手友好度 76/100
JackFurton/who-would-build-a-kernel-in-java#316 ·
維護者通常 1 天內回覆
-
難度 2/5 1-3 小時 新手友好度 66/100
PE5PVB/TEF6686_ESP32#970 ·