KMS documentation for userspace

Daniel Vetter daniel at ffwll.ch
Sat Jun 22 10:51:10 UTC 2019


On Wed, Jun 19, 2019 at 10:16 PM Jani Nikula
<jani.nikula at linux.intel.com> wrote:
>
> On Wed, 19 Jun 2019, Daniel Vetter <daniel at ffwll.ch> wrote:
> > - figure out what to do with the libdrm manpages. Some stuff we really
> > want to also document there. But geez nroff. Maybe we need to stuff
> > libdrm into the kernel, dunno.
>
> How would people feel about converting libdrm man pages to rst, and
> using rst2man in the build? We did that for igt man pages [1]. Looking
> at the diff, I think it's plain to see how that could lower the bar for
> contributing. And perhaps it would be easier to refactor and move
> documentation around too.

I think that'd be very nice.

> I forget, I probably used pandoc or something to do the bulk of the igt
> conversion, and added some manual polish on top. I'm not volunteering
> for the libdrm man page conversion though. ;)

Hm, maybe dig out the old tools you used and point Simon at them?
-Daniel
-- 
Daniel Vetter
Software Engineer, Intel Corporation
+41 (0) 79 365 57 48 - http://blog.ffwll.ch


More information about the dri-devel mailing list