tech-kern archive

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index][Old Index]

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



[I mean to reply to Mouse, but I have a hell of a time with majordomo or
this mailing list: I'm subscribed but I don't get the messages! Can
someone look at this, please. TIA.]

So to clarify: I'm proposing to convert the rst doc pages to man
pages (with for example the utility I cite), and to add the man pages,
in man format, to the sources (in order for the sources to not depend
on a supplementary external tool) and to install the man pages in 
/usr/X11R7/man/.

The X11 part, for the interface, has changed in 2012, but seems (again:
for the interface) stable but the implementation changes and the Linux
kernel implementation is still changing frequently and heavily (the 
drm2/ sources are already significantly behind the Linux sources with
not trivial changes; it's, for me, a lost race...).

On Tue, Oct 17, 2023 at 02:39:58PM +0200, tlaronde wrote:
> 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
> 
> 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)?
> -- 
>         Thierry Laronde <tlaronde +AT+ kergis +dot+ com>
>                      http://www.kergis.com/
>                     http://kertex.kergis.com/
> Key fingerprint = 0FF7 E906 FBAF FE95 FD89  250D 52B1 AE95 6006 F40C

-- 
        Thierry Laronde <tlaronde +AT+ kergis +dot+ com>
                     http://www.kergis.com/
                    http://kertex.kergis.com/
Key fingerprint = 0FF7 E906 FBAF FE95 FD89  250D 52B1 AE95 6006 F40C


Home | Main Index | Thread Index | Old Index