[PATCH] docs/drm: Add a new bullet to the uAPI requirements (v2)
Jason Ekstrand
jason at jlekstrand.net
Wed Aug 4 18:57:04 UTC 2021
While tracking down various bits of i915 uAPI, it's been difficult to
find the userspace much of the time because no one bothers to mention it
in commit messages. Require the kernel patch to be a one-stop shop for
finding the various bits which were used to justify the new uAPI.
v2 (Daniel Vetter):
- Minor wording tweaks
Signed-off-by: Jason Ekstrand <jason at jlekstrand.net>
Acked-by: Daniel Vetter <daniel.vetter at ffwll.ch>
Cc: Dave Airlie <airlied at redhat.com>
---
Documentation/gpu/drm-uapi.rst | 5 +++++
1 file changed, 5 insertions(+)
diff --git a/Documentation/gpu/drm-uapi.rst b/Documentation/gpu/drm-uapi.rst
index 199afb503ab1..7b398c6fadc6 100644
--- a/Documentation/gpu/drm-uapi.rst
+++ b/Documentation/gpu/drm-uapi.rst
@@ -109,6 +109,11 @@ leads to a few additional requirements:
userspace patches land. uAPI always flows from the kernel, doing things the
other way round risks divergence of the uAPI definitions and header files.
+- The kernel patch which adds the new uAPI **must** reference the patch series
+ or merge requests in the userspaces projects which demonstrate the use of the
+ new uAPI and against which the review was done so that future developers can
+ find all of the pieces which tie together.
+
These are fairly steep requirements, but have grown out from years of shared
pain and experience with uAPI added hastily, and almost always regretted about
just as fast. GFX devices change really fast, requiring a paradigm shift and
--
2.31.1
More information about the dri-devel
mailing list