Skip to content

docs(quickemu): clarify CPU, display and VM comments#1822

Merged
flexiondotorg merged 1 commit intomasterfrom
polish
Jan 25, 2026
Merged

docs(quickemu): clarify CPU, display and VM comments#1822
flexiondotorg merged 1 commit intomasterfrom
polish

Conversation

@flexiondotorg
Copy link
Member

  • Clarify highmem behaviour for aarch64 virt machine and why it is needed for >3GB RAM
  • Add detailed explanation of TCG (software emulation), how to force it, and common use cases
  • Replace TODOs about VM detection with manufacturer-based detection guidance
  • Improve ARM detection rationale (no standard vendor strings)
  • Explain that TCG enables running x86_64 macOS on ARM via software emulation
  • Prefer OpenGL ES via ANGLE on macOS for stability/performance on Metal-backed systems
  • Document virtio-gpu naming and regex rationale for matching device names
  • Note virtio devices manage VRAM dynamically via QEMU default max_hostmem
  • Add SMM/vmport note clarifying x86-specific semantics and Secure Boot differences

No functional changes; comments only.

Type of change

  • Documentation (updates the documentation)

Checklist:

  • I have added comments to my code, particularly in hard-to-understand sections

- Clarify highmem behaviour for aarch64 virt machine and why it is
needed for >3GB RAM
- Add detailed explanation of TCG (software emulation), how to force it,
and common use cases
- Replace TODOs about VM detection with manufacturer-based detection
guidance
- Improve ARM detection rationale (no standard vendor strings)
- Explain that TCG enables running x86_64 macOS on ARM via software
emulation
- Prefer OpenGL ES via ANGLE on macOS for stability/performance on
Metal-backed systems
- Document virtio-gpu naming and regex rationale for matching device
names
- Note virtio devices manage VRAM dynamically via QEMU default
max_hostmem
- Add SMM/vmport note clarifying x86-specific semantics and Secure Boot
differences

No functional changes; comments only.

Signed-off-by: Martin Wimpress <martin@wimpress.org>
Copy link
Contributor

@cubic-dev-ai cubic-dev-ai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

No issues found across 1 file

Confidence score: 5/5

  • Automated review surfaced no issues in the provided summaries.
  • No files require special attention.

@flexiondotorg flexiondotorg merged commit e7b4943 into master Jan 25, 2026
4 of 5 checks passed
@flexiondotorg flexiondotorg deleted the polish branch January 25, 2026 01:31
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant