Details

Reviewers: None
Commits: R9:906851601568: x11: document the latest best advice about graphics

Summary

Recommend PORTS_MODULES for drm and nvidia ports. Remove pkg suggestion because
it doesn't work in too many cases. Provide example kernel config file.

Diff Detail

Lint

No Lint Coverage

Unit

No Test Coverage

Build Status

Buildable 38146
Build 35035: arc lint + arc unit

Event Timeline

imp requested review of this revision.Mar 29 2021, 3:39 AM

imp created this revision.

Harbormaster completed remote builds in B38145: Diff 86467.Mar 29 2021, 3:39 AM

Update

Harbormaster completed remote builds in B38146: Diff 86468.Mar 29 2021, 4:47 AM

Perhaps a single sentence on the *why* of PORTS_MODULES (I had never heard of it before!) would be useful, just something along the lines of "With PORTS_MODULES, the corresponding port (containing kernel modules) is re-built against the kernel sources, every time you build the kernel. This ensures the kernel module stays in-sync with the kernel itself."

documentation/content/en/books/handbook/x11/_index.adoc
209
224
266
268	Possibly list available versions? Have the nvidia drivers moved? In trees I can find, those drivers live under `x11/`

imp added inline comments.Mar 29 2021, 9:28 PM

documentation/content/en/books/handbook/x11/_index.adoc
268	Good suggestion. I'll add a list.

Do the suggested nits and expand nvidia section.

Harbormaster completed remote builds in B38285: Diff 86765.Apr 2 2021, 8:16 PM

oops, missed a suggestion from @adridg do that.

imp marked 4 inline comments as done.Apr 2 2021, 8:18 PM

Harbormaster completed remote builds in B38286: Diff 86766.Apr 2 2021, 8:18 PM

move to make.conf

Harbormaster completed remote builds in B38287: Diff 86767.Apr 2 2021, 9:13 PM

Better placement of PORTS_MODULES, wordsmith nvidia section.

Harbormaster completed remote builds in B38288: Diff 86771.Apr 2 2021, 10:08 PM

mention kernel config. fix sloppy language.

Harbormaster completed remote builds in B38289: Diff 86772.Apr 2 2021, 10:14 PM

Typo

documentation/content/en/books/handbook/x11/_index.adoc
267	s/you/use

imp marked an inline comment as done.Apr 2 2021, 10:35 PM

imp added inline comments.

documentation/content/en/books/handbook/x11/_index.adoc
267	thanks. Updating in a sec.

you -> use

Harbormaster completed remote builds in B38290: Diff 86774.Apr 2 2021, 10:36 PM

rpokala added a subscriber: rpokala.Apr 3 2021, 12:13 AM

rpokala added inline comments.

documentation/content/en/books/handbook/x11/_index.adoc
211	As such, it is strongly recommended that the drivers be built via the ports system, or by adding a `makeoptions PORT_MODULES` line in the kernel config file.
266	Since video drivers use private kernel interfaces, it is strongly recommended that the drivers be kept up to date by using the `PORTS_MODULES` mechanism.