From patchwork Tue May 21 08:48:49 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Daniel Vetter X-Patchwork-Id: 10953181 Return-Path: Received: from mail.wl.linuxfoundation.org (pdx-wl-mail.web.codeaurora.org [172.30.200.125]) by pdx-korg-patchwork-2.web.codeaurora.org (Postfix) with ESMTP id D27DC1395 for ; Tue, 21 May 2019 08:49:02 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id C34F02896F for ; Tue, 21 May 2019 08:49:02 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id B7AB92899B; Tue, 21 May 2019 08:49:02 +0000 (UTC) X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on pdx-wl-mail.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-5.2 required=2.0 tests=BAYES_00,MAILING_LIST_MULTI, RCVD_IN_DNSWL_MED autolearn=ham version=3.3.1 Received: from gabe.freedesktop.org (gabe.freedesktop.org [131.252.210.177]) (using TLSv1.2 with cipher DHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.wl.linuxfoundation.org (Postfix) with ESMTPS id 694E62896F for ; Tue, 21 May 2019 08:49:02 +0000 (UTC) Received: from gabe.freedesktop.org (localhost [127.0.0.1]) by gabe.freedesktop.org (Postfix) with ESMTP id D522D89214; Tue, 21 May 2019 08:48:58 +0000 (UTC) X-Original-To: dri-devel@lists.freedesktop.org Delivered-To: dri-devel@lists.freedesktop.org Received: from mail-ed1-x542.google.com (mail-ed1-x542.google.com [IPv6:2a00:1450:4864:20::542]) by gabe.freedesktop.org (Postfix) with ESMTPS id 9BFFC89214 for ; Tue, 21 May 2019 08:48:56 +0000 (UTC) Received: by mail-ed1-x542.google.com with SMTP id a8so28210161edx.3 for ; Tue, 21 May 2019 01:48:56 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id:mime-version :content-transfer-encoding; bh=YxW4olyjrfcR1+tkKODaDnEd9Z8VUWh5BT2RxJbDCjE=; b=OeOGjSJO088NinyZR8L8xXln+VGHX8Z+OoWJG0Oe60U0xFN3pjq+5UtzmMSvJ21iqe c+2ehSzpYRhRxn30hq9F42O43fjP7ZpsqsJYLKNaUqdc8uGC153lQ56nh4RtDAerrLaT J4yArvc17YG+aEhW00xwNCxHenLKVQ7419mxOWXpgSUF4C/OHqp824XRalQzHAfj0a0S 7UjE5wVvMmee+s6NYiFY1TV9HF4WdXTYBKawb7GNlayHz1XRVqqwJKAV2dfKHb2popUv VrsE4op+JbSPgfgUNQ4n3sPsCAMrLkhjtVX3d0mYbZIx05uUGR6gepwmelZED+xmtRJM EJBw== X-Gm-Message-State: APjAAAW+4jL3QFtHse4LnGSnKXgoB0AJKk7RXT7+4kkBCI/rNKVriDCL lmf3n+zvOMdSR29udEZ1VSD0xU7QSuA= X-Google-Smtp-Source: APXvYqx0wR8FkNgcdM/niCM+mDn8g/8XcNpu85+WReFbH0rjHeOPFoK9phhDjT5MKZUzffhHskMkNg== X-Received: by 2002:a50:9581:: with SMTP id w1mr81245448eda.6.1558428534986; Tue, 21 May 2019 01:48:54 -0700 (PDT) Received: from phenom.ffwll.local ([2a02:168:569e:0:3106:d637:d723:e855]) by smtp.gmail.com with ESMTPSA id m4sm77645edc.24.2019.05.21.01.48.53 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Tue, 21 May 2019 01:48:54 -0700 (PDT) From: Daniel Vetter To: DRI Development Subject: [PATCH] drm/doc: More fine-tuning on userspace review requirements Date: Tue, 21 May 2019 10:48:49 +0200 Message-Id: <20190521084849.27452-1-daniel.vetter@ffwll.ch> X-Mailer: git-send-email 2.20.1 MIME-Version: 1.0 X-Mailman-Original-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=ffwll.ch; s=google; h=from:to:cc:subject:date:message-id:mime-version :content-transfer-encoding; bh=YxW4olyjrfcR1+tkKODaDnEd9Z8VUWh5BT2RxJbDCjE=; b=IzdHVMFOuNxq3CQEksG/UJ4H5H68Xj2f4BjKMG7P581TTwS1Gk/i/0gqH+zW9RnOFS V6TzXez4BxUZYWF36SCaGGjwrmnPokr6yta4WTDVYKzY55liwKeQouqhSolvCyhGUJhY hI9AnB3DYaXbhGiaQdVUXwsyt2+WjygJnigdI= X-BeenThere: dri-devel@lists.freedesktop.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: Direct Rendering Infrastructure - Development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: Daniel Vetter , wayland-devel@lists.freedesktop.org, contact@emersion.fr, Daniel Vetter Errors-To: dri-devel-bounces@lists.freedesktop.org Sender: "dri-devel" X-Virus-Scanned: ClamAV using ClamSMTP With Eric's patch commit ba6e798ecf320716780bb6a6088a8d17dcba1d49 Author: Eric Anholt Date: Wed Apr 24 11:56:17 2019 -0700 drm/doc: Document expectation that userspace review looks at kernel uAPI. there's been concerns raised that we expect userspace people to do in-depth kernel patch review. That's not reasonable, same way kernel people can't review all the userspace we have. Try to clarify expectations a bit more. Cc: Eric Anholt Cc: Pekka Paalanen Cc: contact@emersion.fr Cc: wayland-devel@lists.freedesktop.org Signed-off-by: Daniel Vetter Reviewed-by: Pekka Paalanen Reviewed-by: Simon Ser --- Documentation/gpu/drm-uapi.rst | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/Documentation/gpu/drm-uapi.rst b/Documentation/gpu/drm-uapi.rst index 05874d09820c..f368e58fb727 100644 --- a/Documentation/gpu/drm-uapi.rst +++ b/Documentation/gpu/drm-uapi.rst @@ -85,9 +85,9 @@ leads to a few additional requirements: - The userspace side must be fully reviewed and tested to the standards of that userspace project. For e.g. mesa this means piglit testcases and review on the mailing list. This is again to ensure that the new interface actually gets the - job done. The userspace-side reviewer should also provide at least an - Acked-by on the kernel uAPI patch indicating that they've looked at how the - kernel side is implementing the new feature being used. + job done. The userspace-side reviewer should also provide an Acked-by on the + kernel uAPI patch indicating that they believe the proposed uAPI is sound and + sufficiently documented and validated for userspace's consumption. - The userspace patches must be against the canonical upstream, not some vendor fork. This is to make sure that no one cheats on the review and testing