Re: drm.4 man page and import of X11 drm-kms.7 and al.

[Taylor R Campbell <campbell+netbsd-tech-kern%mumble.net@localhost>]

> Date: Tue, 17 Oct 2023 14:39:57 +0200
> From: tlaronde%kergis.com@localhost
> 
> I have modified drm.4 to state that the drivers are obsolete and 
> to suppress a mention of viadrm that was removed long ago (now superseded by
> viadrmums, provided in drm2/ ---drmkms--- part).
> 
> Patch can be retrieved from https://github.com/tlaronde/src

Thanks, I took the opportunity to update the whole man page.  Didn't
realize until now that our drm(4) man page was a local creation
requiring local maintenance.

> There is no man page for drmkms (the kernel part), but there are man
> pages in the X sources, in the rst format
> (external/mit/libdrm/dist/man/drm-kms.7.rst) with a bunch of related
> resources that provide a view of the DRI thing (from the X POV).
> 
> There is rst2man-3.10 (pkgsrc py310-docutils) to convert these to man
> pages.
> 
> Should this be done (it is the X11/DRI interface, not the kernel one, so
> should reside in the X11R7 realm)?

It might be reasonable to ship libdrm man pages in /usr/X11R7/man but
we would need to import the pregenerated rst2man output into
xsrc/external.  Not hard in principle but somewhat annoying to deal
with.  That said, a cursory skim suggests there's a lot missing here.
I see a lot of API functions cross-referenced, but I don't see their
documentation here?  So I'm not sure how useful this would be.