KMS documentation for userspace

[Simon Ser]

On Wednesday, June 19, 2019 10:53 PM, Daniel Vetter <daniel at ffwll.ch> wrote:
> tldr; Yes, I just didn't get around to it yet.
>
> The rough plan is to actually document ioctls and properties and all
> that stuff in drm-uapi.rst, and then cross-link that with the
> driver-side documentation.

I'm confused regarding drm-uapi.rst's role. Is it a document for kernel driver
writers to expand the uAPI, or is it a document for userspace?

It's currently filled with references to internal kernel symbols
(drm_master_get, drm_ioctl_desc, drm_ioctl_permit and so on). Some chapters seem
dedicated to kernel devs (e.g. "Testing and validation").

Is it really the right place for userspace devs to learn how to use KMS?