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

Ouverte Adaptée aux débutants
#12,082 1 commentaire 0 réactions 0 personnes assignées Voir sur GitHub

Les mainteneurs répondent en général sous 2 jours

Personne n'a encore pris cette issue.

Évaluation

Difficulté
1/5
Temps estimé
Moins d'une heure
Accessibilité débutants
90/100
Type d'issue
Documentation
Clarté
Clairement spécifiée
Activité
Active
Stack technique
bash, markdown
Domaine
documentation

Piste de recherche

Commence dans documentation/2.quick-start/quick_start_qemu/quick_start_qemu_macos.md : lis l’étape 1.3 (lignes 38-49) et l’étape 5.3 (lignes 162-171), puis liste bsp/qemu-vexpress-a9 pour confirmer les noms de scripts disponibles. Modifie l’exemple PATH pour utiliser $HOME à l’intérieur de la valeur entre guillemets, et remplace ./qemu_nographic.sh par ./qemu-nographic.sh ou pointe vers ./qemu.sh comme à l’étape 5.1. Terminé lorsque les deux étapes nomment des commandes fonctionnelles et que le suffixe PATH se développe en un chemin absolu.

Rédigé par le modèle d'indexation à partir du texte de l'issue.

Description

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.

Langage dominant
C
Étoiles
12.4k
Forks
5.5k
Merge moyen
3 j 7 h
PR mergées (30 j)
79

Préparer son environnement

Ouvrir dans Codespaces

Lance le conteneur de développement du projet dans votre navigateur, avec votre propre compte GitHub.

Par où commencer

  1. Lisez l'issue en entier, puis le guide de contribution du projet.
  2. Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
  3. Forkez le dépôt et travaillez sur une branche.
  4. Ouvrez une pull request qui référence le numéro de l'issue.

Autres issues de RT-Thread/rt-thread

Toutes les issues de RT-Thread/rt-thread

Issues similaires

Plus d'issues C

Recevez les nouvelles issues par e-mail

Un résumé court des issues GitHub adaptées aux débutants.