Page MenuHomeFreeBSD

Add a note about the new DRM/KMS graphics drivers available in graphics/drm-kmod
ClosedPublic

Authored by debdrup on Oct 24 2018, 7:09 PM.
Tags
None
Referenced Files
Unknown Object (File)
Fri, Apr 26, 11:39 PM
Unknown Object (File)
Fri, Apr 26, 1:51 PM
Unknown Object (File)
Fri, Apr 26, 1:49 PM
Unknown Object (File)
Fri, Apr 26, 1:46 PM
Unknown Object (File)
Fri, Apr 26, 1:46 PM
Unknown Object (File)
Fri, Apr 26, 1:46 PM
Unknown Object (File)
Fri, Apr 26, 1:46 PM
Unknown Object (File)
Fri, Apr 26, 1:46 PM

Details

Summary

Add a section to the x11 handbook section that covers the recent addition of the AMD, Intel, and Radeon GPU drivers which work as of 11.2, if not earlier.

Test Plan

Generated the html, didn't notice anything immediately wrong

Diff Detail

Lint
Lint Skipped
Unit
Tests Skipped

Event Timeline

Avoid weasel words, in accordance with the documentation primer.

Two things, nothing major. Thanks for the help in getting this documented.

en_US.ISO8859-1/books/handbook/x11/chapter.xml
415

There needs to be an empty line after <title> tags. textproc/igor will tell you all about it when running it on your modified xml file.

419

Another empty line here between the closing </para> and <variablelist>.

Fixed issues pointed out by bcr@

Added amdgpu, and explain that radeonkms and amdgpu are in general used for older and newer graphcs respectively.

Also add reference lists for which GPUs are supported.

Credits go to zeising@

rene added inline comments.
en_US.ISO8859-1/books/handbook/x11/chapter.xml
439

Doesn't this contradict what is described in https://reviews.freebsd.org/D17690?id=49701#378825 ?

449

Same here?

en_US.ISO8859-1/books/handbook/x11/chapter.xml
439

Yeah, these are switched around.

Corrected which drivers work for what cards.

The build fails for me, because it doesn't know the newly introduced entities:

rene@e17:/usr/freebsd/doc/head % find . -name "*.ent" -exec grep -iH radeon {} \;
./share/xml/man-refs.ent:<!ENTITY man.radeon.4x "<citerefentry xmlns='http://docbook.org/ns/docbook' vendor='xorg'><refentrytitle>radeon</refentrytitle><manvolnum>4</manvolnum></citerefentry>">
./share/xml/man-refs.ent:<!-- <!ENTITY man.radeonhd.4x "<citerefentry xmlns='http://docbook.org/ns/docbook' vendor='xorg'><refentrytitle>radeonhd</refentrytitle><manvolnum>4</manvolnum></citerefentry>"> -->
rene@e17:/usr/freebsd/doc/head %

But nothing for &radeonkms; ?

en_US.ISO8859-1/books/handbook/x11/chapter.xml
461

This </variablelist> is extraneous?

I'm really not sure what I'm supposed to do about these entries (nor am I even sure where to add them), because upstream (linux drm/kms stack) doesn't seem to provide these man-pages and I'm not at all capable of writing them.

So what am I supposed to do?

Added forward slash on last variablelist tag.

Added entities properly, sorted alphabetically

debdrup retitled this revision from Add a note about the new DRM graphics drivers available in graphics/drm-kmod to Add a note about the new DRM/KMS graphics drivers available in graphics/drm-kmod.Oct 29 2018, 6:29 PM
debdrup edited the summary of this revision. (Show Details)

Updated patch at https://people.freebsd.org/~rene/patches/x11-kms.diff which (apart from the entities) solves all build problems and fixes some style/igor bugs.

Applied the changes from rene@ after satisfying myself I understand why they were made.

Adding Sato-San and Warren to help shed a light on the issue about the entities (which is the proper file they should be added to?).

Turns out this revision didn't work, will update with a new diff that fixes it once I get the OK for the change.

Supply a patch that (should) work.

Sent in a working patch.

This revision is now accepted and ready to land.Nov 20 2018, 8:33 PM
This revision was automatically updated to reflect the committed changes.