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

Offen Anfängerfreundlich
#12,082 1 Kommentar 0 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen

Maintainer antworten meist innerhalb von 2 Tagen

Dieses Issue hat noch niemand übernommen.

Bewertung

Schwierigkeit
1/5
Geschätzter Aufwand
Unter einer Stunde
Anfängerfreundlichkeit
90/100
Issue-Typ
Dokumentation
Klarheit
Klar beschrieben
Aktivitätsstatus
Aktiv
Tech-Stack
bash, markdown
Bereich
documentation

Rechercherichtung

Beginne in documentation/2.quick-start/quick_start_qemu/quick_start_qemu_macos.md: Lies Schritt 1.3 (Zeilen 38-49) und Schritt 5.3 (Zeilen 162-171), liste dann bsp/qemu-vexpress-a9 auf, um die verfügbaren Skriptnamen zu bestätigen. Ändere das PATH-Beispiel so, dass $HOME innerhalb des in Anführungszeichen gesetzten Werts verwendet wird, und ersetze ./qemu_nographic.sh durch ./qemu-nographic.sh oder verweise wie in Schritt 5.1 auf ./qemu.sh. Fertig, wenn beide Schritte funktionierende Befehle nennen und das PATH-Suffix zu einem absoluten Pfad expandiert.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Beschreibung

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.

Vorherrschende Sprache
C
Sterne
12.4k
Forks
5.5k
Ø Merge
3 T. 7 Std.
Gemergte PRs (30 T.)
79

Entwicklungsumgebung

In Codespaces öffnen

Startet den Dev-Container des Projekts im Browser, mit Ihrem eigenen GitHub-Konto.

Erste Schritte

  1. Lesen Sie das ganze Issue und danach den Beitragsleitfaden des Projekts.
  2. Schreiben Sie ins Issue, dass Sie es übernehmen — das erspart doppelte Arbeit.
  3. Forken Sie das Repository und arbeiten Sie in einem Branch.
  4. Öffnen Sie einen Pull Request, der die Issue-Nummer nennt.

Mehr aus RT-Thread/rt-thread

Alle Issues in RT-Thread/rt-thread

Ähnliche Issues

Weitere Issues zu C

Neue Issues direkt in Ihr Postfach

Eine kurze Übersicht über anfängerfreundliche GitHub-Issues.