Skip to content

Conversation

@skyace65
Copy link
Contributor

Adds a Linux subsection to the platform-specific section, and adds a Wayland and X11 page. This is part of the 4.x milestone because it includes information on the libdecor environment variable which is a 4.6 variable. Draft until I can figure out how to set the variable in code.

@skyace65 skyace65 added this to the 4.6 milestone Jan 25, 2026
@skyace65 skyace65 added enhancement content:new page Issues and PRs related to creation of new documentation pages for new or undocumented features area:manual Issues and PRs related to the Manual/Tutorials section of the documentation labels Jan 25, 2026
--------

One of the important components of any operating system is its display server.
Windows and Mac only provide one option, Linux however has two, X11 and Wayland.
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
Windows and Mac only provide one option, Linux however has two, X11 and Wayland.
Windows and macOS only provide one option, Linux however has two, X11 and Wayland.

I'd say

using Wayland thanks to a compatibility layer known as Xwayland.

Godot's support is still a work in progress, so for now X11 remains the default
setting for game projects, however that will likely change in a future version.
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
setting for game projects, however that will likely change in a future version.
setting for game projects, that will likely change in a future version.

Too many "however"s

When to use Wayland
-------------------

If you're an engine developer that wants to help improve support, or if you think
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
If you're an engine developer that wants to help improve support, or if you think
If you're an engine developer who wants to help improve support, or if you think

-------------------

If you're an engine developer that wants to help improve support, or if you think
xWayland might be causing visual glitches in your exported project for whatever
Copy link
Member

Choose a reason for hiding this comment

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

Is it "xWayland" or "Xwayland"? You use both

--------------------

To change your display server to Wayland click on :menu:`Project > project settings`,
from here, go to :button:`Display Server` And change the :button:`driver.linuxbsd`
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
from here, go to :button:`Display Server` And change the :button:`driver.linuxbsd`
from here, go to :button:`Display Server` and change the :button:`driver.linuxbsd`

--------------------------

Libdecor loading on Wayland has some quirks and it may be useful to disable it
depending on your situation. To do that you need to set the ``GODOT_WAYLAND_DISABLE_LIBDECOR``
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
depending on your situation. To do that you need to set the ``GODOT_WAYLAND_DISABLE_LIBDECOR``
depending on your situation. To do so you need to set the ``GODOT_WAYLAND_DISABLE_LIBDECOR``

IMO

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area:manual Issues and PRs related to the Manual/Tutorials section of the documentation content:new page Issues and PRs related to creation of new documentation pages for new or undocumented features enhancement

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants