[Bug] macOS QEMU quick start documents a literal PATH suffix and a missing restart script
Maintainers usually reply within 2 days
Nobody has claimed this yet.
Assessment
- Difficulty
- 1/5
- Estimated time
- Under an hour
- Newbie friendliness
- 90/100
- Issue type
- Documentation
- Clarity
- Clearly specified
- Activity status
- Active
- Tech stack
- bash, markdown
- Domain
- documentation
Research direction
Start in documentation/2.quick-start/quick_start_qemu/quick_start_qemu_macos.md: read step 1.3 (lines 38-49) and step 5.3 (lines 162-171), then list bsp/qemu-vexpress-a9 to confirm the available script names. Change the PATH example to use $HOME inside the quoted value, and replace ./qemu_nographic.sh with ./qemu-nographic.sh or point to ./qemu.sh as in step 5.1. Done when both steps name working commands and the PATH suffix expands to an absolute path.
Written by the indexing model from the issue text.
Description
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.
- Dominant language
- C
- Stars
- 12.4k
- Forks
- 5.5k
- Avg merge
- 3d 7h
- Merged PRs (30d)
- 79
Getting set up
Starts the project's dev container in your browser, under your own GitHub account.
- No Dockerfile or Docker Compose file
- Has a pull request template
- Read the contributing guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from RT-Thread/rt-thread
-
bug
Difficulty 2/5 1-3 hours Newbie friendliness 67/100
RT-Thread/rt-thread#11951 · 2 comments ·
Maintainers usually reply within 2 days
-
[Bug] [libc] timer_gettime 拆秒前将总纳秒截断为 uint32_t,剩余时间查询错误May be free again @Yunlk claimed this 28 days ago, and no pull request is open. Openin progress
Difficulty 2/5 1-3 hours Newbie friendliness 68/100
RT-Thread/rt-thread#11924 · 7 comments · 1 assignee ·
Maintainers usually reply within 2 days
-
[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 callPossibly taken @remukisama claimed this 32 days ago. Openin progress
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
RT-Thread/rt-thread#11902 · 4 comments · 1 assignee ·
Maintainers usually reply within 2 days
-
[bsp][stm32][bluepill] README「快速上手」缺少重新生成 MDK 工程这一步,按文档操作无法编译通过May be free again @moment-NEW claimed this 50 days ago, and no pull request is open. Openin progress
Difficulty 2/5 1-3 hours Newbie friendliness 75/100
RT-Thread/rt-thread#11818 · 4 comments · 1 assignee ·
Maintainers usually reply within 2 days
-
Arch: RISC-V BSP BSP: HPMicro bug
Difficulty 2/5 1-3 hours Newbie friendliness 72/100
RT-Thread/rt-thread#11687 · 6 comments ·
Maintainers usually reply within 2 days
All issues in RT-Thread/rt-thread
Similar issues
-
Difficulty 2/5 1-3 hours Newbie friendliness 72/100
apache/nuttx-apps#4108 · 4 comments ·
Maintainers usually reply within 1 day
-
Difficulty 1/5 Under an hour Newbie friendliness 82/100
trezor/trezor-firmware#8357 ·
Maintainers usually reply within 2 days
-
ivorysql_ora: DBMS_SESSION lacks SLEEP (documented, not covered by #2763)Possibly taken A pull request linked to this issue is open or already merged. Open
Difficulty 2/5 1-3 hours Newbie friendliness 68/100
Maintainers usually reply within 1 day
-
good first issue kernel
Difficulty 2/5 1-3 hours Newbie friendliness 76/100
JackFurton/who-would-build-a-kernel-in-java#316 ·
Maintainers usually reply within 1 day
-
Difficulty 2/5 1-3 hours Newbie friendliness 66/100
PE5PVB/TEF6686_ESP32#970 ·