git: 7937e6d486 - main - handbook/virtualization: Add section on VBoxSVGA to make Xorg work

The branch main has been updated by bcr:

URL: https://cgit.FreeBSD.org/doc/commit/?id=7937e6d4862899376aeecbe37fc41b2a8b916d50

commit 7937e6d4862899376aeecbe37fc41b2a8b916d50
Author:     Benedict Reuschling <[email protected]>
AuthorDate: 2026-06-20 01:06:58 +0000
Commit:     Benedict Reuschling <[email protected]>
CommitDate: 2026-06-20 01:06:58 +0000

    handbook/virtualization: Add section on VBoxSVGA to make Xorg work
    
    When trying to run Xorg on FreeBSD as a VirtualBox guest, it fails to
    start the X server because of the wrong graphics driver. Instruct users
    to set the VBoxSVGA graphics adapter before installing the guest
    additions.
    
    Also, remove the "First," from the beginning of a later sentence, as
    there is no "Second", "Third", and so on and does not help much in this
    context.
    
    Event:                  BSDCan 2026
    Reviewed by:            ziaee@
    Differential Revision:  https://reviews.freebsd.org/D57693
---
 documentation/content/en/books/handbook/virtualization/_index.adoc | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/documentation/content/en/books/handbook/virtualization/_index.adoc b/documentation/content/en/books/handbook/virtualization/_index.adoc
index 547cdd66b6..16825f3968 100644
--- a/documentation/content/en/books/handbook/virtualization/_index.adoc
+++ b/documentation/content/en/books/handbook/virtualization/_index.adoc
@@ -301,12 +301,17 @@ The VirtualBox(TM) guest additions provide support for:
 * Window scaling.
 * Seamless mode.
 
+For running Xorg, make sure to set *VBoxSVGA* for the Screen setting of the Display section in the virtual machine configuration before installing the Guest Additions.
+Do not select VBoxSVGA as that targets VMware guests and is not usable on FreeBSD.
+It causes Xorg to not run correctly.
+VBoxSVGA does not have this problem and executes X11 without errors.
+
 [NOTE]
 ====
 These commands are run in the FreeBSD guest.
 ====
 
-First, install the package:emulators/virtualbox-ose-additions[] package or port in the FreeBSD guest.
+Install the package:emulators/virtualbox-ose-additions[] package or port in the FreeBSD guest.
 This will install the port:
 
 [source,shell]