From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-13.6 required=3.0 tests=BAYES_00,DKIM_INVALID, DKIM_SIGNED,HEADER_FROM_DIFFERENT_DOMAINS,INCLUDES_CR_TRAILER,INCLUDES_PATCH, MAILING_LIST_MULTI,SPF_HELO_NONE,SPF_PASS autolearn=unavailable autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id C4168C433DB for ; Tue, 23 Mar 2021 13:10:25 +0000 (UTC) Received: from gabe.freedesktop.org (gabe.freedesktop.org [131.252.210.177]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.kernel.org (Postfix) with ESMTPS id 3F266619BD for ; Tue, 23 Mar 2021 13:10:25 +0000 (UTC) DMARC-Filter: OpenDMARC Filter v1.3.2 mail.kernel.org 3F266619BD Authentication-Results: mail.kernel.org; dmarc=none (p=none dis=none) header.from=ffwll.ch Authentication-Results: mail.kernel.org; spf=none smtp.mailfrom=dri-devel-bounces@lists.freedesktop.org Received: from gabe.freedesktop.org (localhost [127.0.0.1]) by gabe.freedesktop.org (Postfix) with ESMTP id 050416E8EB; Tue, 23 Mar 2021 13:10:23 +0000 (UTC) Received: from mail-wm1-x332.google.com (mail-wm1-x332.google.com [IPv6:2a00:1450:4864:20::332]) by gabe.freedesktop.org (Postfix) with ESMTPS id C3CAF6E15C for ; Tue, 23 Mar 2021 13:10:21 +0000 (UTC) Received: by mail-wm1-x332.google.com with SMTP id w203-20020a1c49d40000b029010c706d0642so1104951wma.0 for ; Tue, 23 Mar 2021 06:10:21 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=ffwll.ch; s=google; h=date:from:to:cc:subject:message-id:references:mime-version :content-disposition:in-reply-to; bh=8LILuIxx3Dt03RFOu/SDBOmKxUoeOOb2/7p2Ovux+Cc=; b=HnohPj6P0TsytW0MHIUvzXitiD+Py+SjuVImPqEkHjIqlc/CNfvqKsrQx0lZDUYxWF 1PxlMrF2G0rptCS0ecJqR7WQmROyB/XsumEYrSicRZi0sLx61/EoSF3AHWcEeAfqTwQQ w5mwt56jlBrZxtIQ0iRUji6aMuatmWv7pq46g= X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:date:from:to:cc:subject:message-id:references :mime-version:content-disposition:in-reply-to; bh=8LILuIxx3Dt03RFOu/SDBOmKxUoeOOb2/7p2Ovux+Cc=; b=WONPAUmObEhRIsHokj2novfQ8mUnD7+BzM6tagsdBA8tIw0Y5Uw1fMOd+shZqdW81o To3V7iNwjHxMeZtqqO/AnyPo6QIJyibt+vKIHNq58ep8eXa48Llibfi6O34tGQ9gBBOT lmGHf2yepe0/W+f0X4lPqFlr7ZrQvlrpCZd0lCGhSa2gzSVqYPWfsUttUOKBRZENzows swOftJNLyQrxWpo2M3vNeGSy7g0lY0TFmPBIDBdeveIt+DGyZVXSg07XY7WrnSGQSlDt AC1Czf+LjJNcWakf1jwJQAX2eh9t8JFqNhgLgcXtRPBMTLcxRcUEZqfeTaxhKKLjIXyU i0Wg== X-Gm-Message-State: AOAM53178ZzAVL//EXXfjiz5zx2VPX/9ZxDaoYAveSsGhNWctO2aWx/i 6balWaNJeegWg88GGAkdU1o1FA== X-Google-Smtp-Source: ABdhPJySHnPrHD9PxfvezeGwJIRNpT2FFerm2wpTndArq8J5fihw8E9kTZ4U3Iyyx+nasEZ4ubGm7w== X-Received: by 2002:a05:600c:284:: with SMTP id 4mr3404455wmk.24.1616505020391; Tue, 23 Mar 2021 06:10:20 -0700 (PDT) Received: from phenom.ffwll.local ([2a02:168:57f4:0:efd0:b9e5:5ae6:c2fa]) by smtp.gmail.com with ESMTPSA id m132sm2511284wmf.45.2021.03.23.06.10.19 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 23 Mar 2021 06:10:19 -0700 (PDT) Date: Tue, 23 Mar 2021 14:10:17 +0100 From: Daniel Vetter To: Rodrigo Vivi Subject: Re: [PATCH 2/2] drm/doc: Add RFC section Message-ID: References: <20210323084453.366863-1-daniel.vetter@ffwll.ch> <20210323084453.366863-2-daniel.vetter@ffwll.ch> MIME-Version: 1.0 Content-Disposition: inline In-Reply-To: X-Operating-System: Linux phenom 5.7.0-1-amd64 X-BeenThere: dri-devel@lists.freedesktop.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Direct Rendering Infrastructure - Development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: Daniel Vetter , Intel Graphics Development , DRI Development , Jason Ekstrand , Daniel Vetter , Dave Airlie Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit Errors-To: dri-devel-bounces@lists.freedesktop.org Sender: "dri-devel" On Tue, Mar 23, 2021 at 08:37:07AM -0400, Rodrigo Vivi wrote: > On Tue, Mar 23, 2021 at 09:44:53AM +0100, Daniel Vetter wrote: > > Motivated by the pre-review process for i915 gem/gt features, but > > probably useful in general for complex stuff. > > > > Cc: Jani Nikula > > Cc: Joonas Lahtinen > > Cc: Rodrigo Vivi > > Cc: Jason Ekstrand > > Cc: Dave Airlie > > Signed-off-by: Daniel Vetter > > --- > > Documentation/gpu/index.rst | 1 + > > Documentation/gpu/rfc.rst | 16 ++++++++++++++++ > > 2 files changed, 17 insertions(+) > > create mode 100644 Documentation/gpu/rfc.rst > > > > diff --git a/Documentation/gpu/index.rst b/Documentation/gpu/index.rst > > index c9a51e3bfb5a..df58cb826d68 100644 > > --- a/Documentation/gpu/index.rst > > +++ b/Documentation/gpu/index.rst > > @@ -16,6 +16,7 @@ Linux GPU Driver Developer's Guide > > vga-switcheroo > > vgaarbiter > > todo > > + rfc > > I understand the motivation here so I didn't commented earlier, but looking now, > I'm wondering that this section will polute the official doc... We already have this problem between documentation meant for kernel driver developers and documentation meant for userspace developers around uapi and all that. "who is the audience here" is very ill-defined for our current set of docs in Documentation/gpu :-( So I agree with you, but I also don't think this will make things worse. -Daniel > > > > > .. only:: subproject and html > > > > diff --git a/Documentation/gpu/rfc.rst b/Documentation/gpu/rfc.rst > > new file mode 100644 > > index 000000000000..9d0ff2921af8 > > --- /dev/null > > +++ b/Documentation/gpu/rfc.rst > > @@ -0,0 +1,16 @@ > > +=============== > > +GPU RFC Section > > +=============== > > + > > +For complex work, especially new uapi, it is often good to nail the high level > > +design issues before getting lost in the code details. This section is meant to > > +host such documentation: > > + > > +* Each RFC should be a section in this file, explaining the goal and main design > > + considerations. > > + > > +* For uapi structures add a file to this directory with and then pull the > > + kerneldoc in like with real uapi headers. > > + > > +* Once the code has landed move all the documentation to the right places in > > + the main core, helper or driver sections. > > -- > > 2.31.0 > > -- Daniel Vetter Software Engineer, Intel Corporation http://blog.ffwll.ch _______________________________________________ dri-devel mailing list dri-devel@lists.freedesktop.org https://lists.freedesktop.org/mailman/listinfo/dri-devel From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-13.6 required=3.0 tests=BAYES_00,DKIM_INVALID, DKIM_SIGNED,HEADER_FROM_DIFFERENT_DOMAINS,INCLUDES_CR_TRAILER,INCLUDES_PATCH, MAILING_LIST_MULTI,SPF_HELO_NONE,SPF_PASS autolearn=ham autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id 67FF5C433C1 for ; Tue, 23 Mar 2021 13:10:23 +0000 (UTC) Received: from gabe.freedesktop.org (gabe.freedesktop.org [131.252.210.177]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.kernel.org (Postfix) with ESMTPS id CEE79619A9 for ; Tue, 23 Mar 2021 13:10:22 +0000 (UTC) DMARC-Filter: OpenDMARC Filter v1.3.2 mail.kernel.org CEE79619A9 Authentication-Results: mail.kernel.org; dmarc=none (p=none dis=none) header.from=ffwll.ch Authentication-Results: mail.kernel.org; spf=none smtp.mailfrom=intel-gfx-bounces@lists.freedesktop.org Received: from gabe.freedesktop.org (localhost [127.0.0.1]) by gabe.freedesktop.org (Postfix) with ESMTP id 47D336E15C; Tue, 23 Mar 2021 13:10:22 +0000 (UTC) Received: from mail-wm1-x332.google.com (mail-wm1-x332.google.com [IPv6:2a00:1450:4864:20::332]) by gabe.freedesktop.org (Postfix) with ESMTPS id CD89C6E857 for ; Tue, 23 Mar 2021 13:10:21 +0000 (UTC) Received: by mail-wm1-x332.google.com with SMTP id d191so11013874wmd.2 for ; Tue, 23 Mar 2021 06:10:21 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=ffwll.ch; s=google; h=date:from:to:cc:subject:message-id:references:mime-version :content-disposition:in-reply-to; bh=8LILuIxx3Dt03RFOu/SDBOmKxUoeOOb2/7p2Ovux+Cc=; b=HnohPj6P0TsytW0MHIUvzXitiD+Py+SjuVImPqEkHjIqlc/CNfvqKsrQx0lZDUYxWF 1PxlMrF2G0rptCS0ecJqR7WQmROyB/XsumEYrSicRZi0sLx61/EoSF3AHWcEeAfqTwQQ w5mwt56jlBrZxtIQ0iRUji6aMuatmWv7pq46g= X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:date:from:to:cc:subject:message-id:references :mime-version:content-disposition:in-reply-to; bh=8LILuIxx3Dt03RFOu/SDBOmKxUoeOOb2/7p2Ovux+Cc=; b=ZYWUjXwMQMhHWEc7SlRdC7HCNdfj2pwy4dzOL3/WaURCms9jJxDJGIIsnFlg0ZPLIr 8TPQ49RtQreSFKsAbw/4ymmZ1TNxZd+2l3e1ZMDnEpGYUYVTLGPZ/gE0bv1yIWTr+qYw JOcoB652nrtaebXf1rh4/gLZFjMTeKG6oi9smeCQmM9kxmLbYbZHJ2TxF8+W86PkRy4c U0/cLfhWNk5dVN2nb8lOmK3EIMZ3BRuYihj7dwxlrwb8QGtPm2fFgAyeWFwaZwKRvCCo 6DzVvum15WRXHFG44tcM+neq6kA50SPQDSi/VUOwn5hOr+1rMmM8DSSKcp5xoGWKj8Xt thng== X-Gm-Message-State: AOAM530S7UH0SUVIvd33mmtTh4B1LIZ5pcpNBqvC3/L9fd9IflAiu59s r9IaR42n6KNMOqzdTs+RJsSKig== X-Google-Smtp-Source: ABdhPJySHnPrHD9PxfvezeGwJIRNpT2FFerm2wpTndArq8J5fihw8E9kTZ4U3Iyyx+nasEZ4ubGm7w== X-Received: by 2002:a05:600c:284:: with SMTP id 4mr3404455wmk.24.1616505020391; Tue, 23 Mar 2021 06:10:20 -0700 (PDT) Received: from phenom.ffwll.local ([2a02:168:57f4:0:efd0:b9e5:5ae6:c2fa]) by smtp.gmail.com with ESMTPSA id m132sm2511284wmf.45.2021.03.23.06.10.19 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 23 Mar 2021 06:10:19 -0700 (PDT) Date: Tue, 23 Mar 2021 14:10:17 +0100 From: Daniel Vetter To: Rodrigo Vivi Message-ID: References: <20210323084453.366863-1-daniel.vetter@ffwll.ch> <20210323084453.366863-2-daniel.vetter@ffwll.ch> MIME-Version: 1.0 Content-Disposition: inline In-Reply-To: X-Operating-System: Linux phenom 5.7.0-1-amd64 Subject: Re: [Intel-gfx] [PATCH 2/2] drm/doc: Add RFC section X-BeenThere: intel-gfx@lists.freedesktop.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Intel graphics driver community testing & development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: Daniel Vetter , Intel Graphics Development , DRI Development , Daniel Vetter , Dave Airlie Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit Errors-To: intel-gfx-bounces@lists.freedesktop.org Sender: "Intel-gfx" On Tue, Mar 23, 2021 at 08:37:07AM -0400, Rodrigo Vivi wrote: > On Tue, Mar 23, 2021 at 09:44:53AM +0100, Daniel Vetter wrote: > > Motivated by the pre-review process for i915 gem/gt features, but > > probably useful in general for complex stuff. > > > > Cc: Jani Nikula > > Cc: Joonas Lahtinen > > Cc: Rodrigo Vivi > > Cc: Jason Ekstrand > > Cc: Dave Airlie > > Signed-off-by: Daniel Vetter > > --- > > Documentation/gpu/index.rst | 1 + > > Documentation/gpu/rfc.rst | 16 ++++++++++++++++ > > 2 files changed, 17 insertions(+) > > create mode 100644 Documentation/gpu/rfc.rst > > > > diff --git a/Documentation/gpu/index.rst b/Documentation/gpu/index.rst > > index c9a51e3bfb5a..df58cb826d68 100644 > > --- a/Documentation/gpu/index.rst > > +++ b/Documentation/gpu/index.rst > > @@ -16,6 +16,7 @@ Linux GPU Driver Developer's Guide > > vga-switcheroo > > vgaarbiter > > todo > > + rfc > > I understand the motivation here so I didn't commented earlier, but looking now, > I'm wondering that this section will polute the official doc... We already have this problem between documentation meant for kernel driver developers and documentation meant for userspace developers around uapi and all that. "who is the audience here" is very ill-defined for our current set of docs in Documentation/gpu :-( So I agree with you, but I also don't think this will make things worse. -Daniel > > > > > .. only:: subproject and html > > > > diff --git a/Documentation/gpu/rfc.rst b/Documentation/gpu/rfc.rst > > new file mode 100644 > > index 000000000000..9d0ff2921af8 > > --- /dev/null > > +++ b/Documentation/gpu/rfc.rst > > @@ -0,0 +1,16 @@ > > +=============== > > +GPU RFC Section > > +=============== > > + > > +For complex work, especially new uapi, it is often good to nail the high level > > +design issues before getting lost in the code details. This section is meant to > > +host such documentation: > > + > > +* Each RFC should be a section in this file, explaining the goal and main design > > + considerations. > > + > > +* For uapi structures add a file to this directory with and then pull the > > + kerneldoc in like with real uapi headers. > > + > > +* Once the code has landed move all the documentation to the right places in > > + the main core, helper or driver sections. > > -- > > 2.31.0 > > -- Daniel Vetter Software Engineer, Intel Corporation http://blog.ffwll.ch _______________________________________________ Intel-gfx mailing list Intel-gfx@lists.freedesktop.org https://lists.freedesktop.org/mailman/listinfo/intel-gfx