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

Aperta Adatta ai principianti
#12,082 1 commento 0 reazioni 0 assegnatari Vedi su GitHub

I maintainer di solito rispondono entro 2 giorni

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
1/5
Tempo stimato
Meno di un'ora
Idoneità per principianti
90/100
Tipo di issue
Documentazione
Chiarezza
Specificata chiaramente
Stato di attività
Attiva
Stack tecnologico
bash, markdown
Ambito
documentation

Direzione di ricerca

Inizia in documentation/2.quick-start/quick_start_qemu/quick_start_qemu_macos.md: leggi il passo 1.3 (righe 38-49) e il passo 5.3 (righe 162-171), poi elenca bsp/qemu-vexpress-a9 per confermare i nomi degli script disponibili. Modifica l'esempio PATH per usare $HOME all'interno del valore tra virgolette, e sostituisci ./qemu_nographic.sh con ./qemu-nographic.sh oppure punta a ./qemu.sh come nel passo 5.1. Fatto quando entrambi i passi indicano comandi funzionanti e il suffisso PATH si espande in un percorso assoluto.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

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.

Lingua principale
C
Stelle
12.4k
Fork
5.5k
Merge medio
3g 7h
PR unite (30g)
79

Preparare l'ambiente

Apri in Codespaces

Avvia il container di sviluppo del progetto nel browser, con il tuo account GitHub.

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di RT-Thread/rt-thread

Tutte le issue di RT-Thread/rt-thread

Issue simili

Altre issue su C

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.