Bug 268315 - FreeBSD Handbook: X.Org configuration: driver name ambiguities, confusion
Summary: FreeBSD Handbook: X.Org configuration: driver name ambiguities, confusion
Status: Closed Overcome By Events
Alias: None
Product: Documentation
Classification: Unclassified
Component: Books & Articles (show other bugs)
Version: Latest
Hardware: Any Any
: --- Affects Some People
Assignee: freebsd-doc (Nobody)
URL: https://github.com/freebsd/freebsd-do...
Keywords: needs-patch, needs-qa
Depends on:
Blocks: handbook-2022
  Show dependency tree / graph
 
Reported: 2022-12-11 17:27 UTC by Graham Perrin
Modified: 2023-02-15 19:32 UTC (History)
1 user (show)

See Also:

Attachments
Add an attachment (proposed patch, testcase, etc.)

Note You need to log in before you can comment on or make changes to this bug.
Description Graham Perrin freebsd_committer freebsd_triage 2022-12-11 17:27:25 UTC 
German (de) <https://docs.freebsd.org/de/books/handbook/x11/#x-config-video-cards-ports> looked partly wrong, at a glance: 

* i915kms, radeonkms, amdgpu, intel, radeon

English (en) <https://docs.freebsd.org/en/books/handbook/x11/#x-config-video-cards-ports> is similarly ambiguous: 

* each of the five words is a driver name

* the array of subheadings, in and around this area, does not convey 
  a sense of why (for example) the radeonkms name might be wrong in 
  some situations.
Comment 1 Graham Perrin freebsd_committer freebsd_triage 2022-12-11 17:56:03 UTC 
From comment #0: 

> … partly wrong, …

The more that I begin to look at this chapter, the more that it seems wrong for DRM KMS kld_list -related blurb to appear under X.Org configuration. 

(I assume that i915kms, radeonkms, and amdgpu under what's currently 5.4.5 relate to the same three words under <https://wiki.freebsd.org/Graphics#drm-kmod>.)

kld_list is an aspect of rc.conf(5), not to be confused with X.Org configuration. 

<https://www.freebsd.org/cgi/man.cgi?query=rc.conf&sektion=5&manpath=FreeBSD>
Comment 2 Sergio Carlavilla Delgado freebsd_committer freebsd_triage 2023-02-15 19:32:10 UTC 
Fixed in https://cgit.freebsd.org/doc/commit/?id=4d1de1c7246d147e1c428b542350695b8fedf84e