Skip to content

Conversation

@wbohrer
Copy link

@wbohrer wbohrer commented Dec 5, 2025

Mesa's NVK driver is getting better and more popular. Time to add instructions in the handbook for it. Went ahead and divided the nouveau section into subsections like the other driver pages.

Note that the section divisions are unnecessary for the proprietary driver because it unifies all of the APIs into one package.

@wbohrer wbohrer changed the title config/graphical-session/graphics-drivers/nvidia: Organize into sections, add Vulkan information config/graphical-session/graphics-drivers/nvidia: rewrite nouveau Dec 6, 2025
@wbohrer
Copy link
Author

wbohrer commented Dec 27, 2025

Argh, I am also failing linkcheck locally from timeout errors for GNU Savannah and ArchWiki. I additionally verified that I cannot access these sites in the browser. Might be more DDoS outages.
Well, I'll go ahead and push requested changes anyway. Actions will probably fail with timeout errors again.


The accelerated OpenGL driver is provided by `mesa-dri`. This is a dependency of
the `xorg` metapackage, but must be manually installed when using `xorg-minimal`
or 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
or Wayland.
or a Wayland compositor.

### Vulkan

> **Warning**: The NVK driver is relatively new and may be unstable and/or
> underperformant. Expect instability on cards below Turing (GTX 16xx).
Copy link
Member

Choose a reason for hiding this comment

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

"Underperformant" is not a word. Additionally, this warning would be better served as part of the main paragraph.

> underperformant. Expect instability on cards below Turing (GTX 16xx).
Cards starting with Kepler (GTX 6xx) are supported by the Vulkan nouveau driver.
Install `vulkan-loader` and `mesa-vulkan-nouveau`.
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
Install `vulkan-loader` and `mesa-vulkan-nouveau`.
Install `vulkan-loader` and `mesa-vulkan-nouveau`. Older cards may perform poorly or unreliably with Vulkan.


### Reclocking

At the time of writing, only first generation Maxwell, Kepler, and some Tesla
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
At the time of writing, only first generation Maxwell, Kepler, and some Tesla
Only first generation Maxwell, Kepler, and some Tesla

There is no need for "at the time of writing" unless you are trying to claim psychic abilities and you assume that the reader will browse Git history to figure out when the document was written.

At the time of writing, only first generation Maxwell, Kepler, and some Tesla
cards support manual reclocking. Cards past Turing (GTX 16xx) support automatic
reclocking.

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

This should all be one paragraph.

### Xorg

The `xorg` metapackage pulls in the `xf86-video-nouveau` video driver. This will
need to be manually installed if using `xorg-minimal`. You can also use the
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
need to be manually installed if using `xorg-minimal`. You can also use the
need to be manually installed when `xorg-minimal` is installed instead. You can also use the

need to be manually installed if using `xorg-minimal`. You can also use the
universal `modesetting` driver bundled with Xorg (this is the only option on
Tegra-based ARM boards).

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

This should be a single paragraph.

Tegra-based ARM boards).

The former can make use of card-specific 2D acceleration paths, which is
primarily useful on older cards with specialized fixed function hardware (the
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
primarily useful on older cards with specialized fixed function hardware (the
primarily useful on older cards with specialized, fixed-function hardware. (The

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.

3 participants