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

Đang mở Phù hợp với người mới
#12,082 1 bình luận 0 reaction 0 người được giao Xem trên GitHub

Maintainer thường phản hồi trong vòng 2 ngày

Chưa có ai nhận issue này.

Đánh giá

Độ khó
1/5
Thời gian dự kiến
Dưới một giờ
Mức phù hợp với người mới
90/100
Loại issue
Tài liệu
Độ rõ ràng
Đặc tả rõ ràng
Mức độ hoạt động
Sôi nổi
Công nghệ
bash, markdown
Lĩnh vực
documentation

Hướng nghiên cứu

Bắt đầu trong documentation/2.quick-start/quick_start_qemu/quick_start_qemu_macos.md: đọc bước 1.3 (dòng 38-49) và bước 5.3 (dòng 162-171), sau đó liệt kê bsp/qemu-vexpress-a9 để xác nhận các tên script có sẵn. Thay đổi ví dụ PATH để dùng $HOME bên trong giá trị được trích dẫn, và thay ./qemu_nographic.sh bằng ./qemu-nographic.sh hoặc trỏ đến ./qemu.sh như trong bước 5.1. Hoàn tất khi cả hai bước nêu tên các lệnh hoạt động và hậu tố PATH mở rộng thành đường dẫn tuyệt đối.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

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.

Ngôn ngữ chính
C
Star
12.4k
Fork
5.5k
Merge trung bình
3 ngày 7 giờ
Pull request đã merge (30 ngày)
79

Chuẩn bị môi trường

Mở trong Codespaces

Khởi chạy dev container của dự án ngay trên trình duyệt, bằng tài khoản GitHub của bạn.

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của RT-Thread/rt-thread

Tất cả issue của RT-Thread/rt-thread

Issue tương tự

Thêm issue về C

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.