Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) client-ip=2620:137:e000::1:20;
Date:   Fri, 9 Sep 2022 05:10:40 -0400
From:   Rodrigo Vivi <rodrigo.vivi@intel.com>
To:     Mauro Carvalho Chehab <mchehab@kernel.org>
CC:     Thomas Zimmermann <tzimmermann@suse.de>,
        Jonathan Corbet <corbet@lwn.net>,
        David Airlie <airlied@linux.ie>,
        <dri-devel@lists.freedesktop.org>, <linux-kernel@vger.kernel.org>,
        <linux-doc@vger.kernel.org>, Maxime Ripard <mripard@kernel.org>,
        Daniel Vetter <daniel@ffwll.ch>,
        <intel-gfx@lists.freedesktop.org>
Subject: Re: [Intel-gfx] [PATCH v3 32/37] docs: gpu: i915.rst: add the
 remaining kernel-doc markup files
Message-ID: <YxsDEP30aZmyBvIo@intel.com>
References: <cover.1662708705.git.mchehab@kernel.org>
 <7ed6d74b75061fb2800e5a59f5282b224bd0621a.1662708705.git.mchehab@kernel.org>
Content-Type: text/plain; charset="us-ascii"
Content-Disposition: inline
In-Reply-To: <7ed6d74b75061fb2800e5a59f5282b224bd0621a.1662708705.git.mchehab@kernel.org>
MIME-Version: 1.0
X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1
X-MS-Exchange-AntiSpam-MessageData-0: =?us-ascii?Q?+1xBlUvVSOVXybxMti3uD42QjagQOisw0fmox6oS4ocwrwwKTn5vkH4XqlqN?=
 =?us-ascii?Q?hZRxj6vjPLf7UzfQ8VdylPVN3zPr5PkdREtSYLmSJsB7dNUtcgXBqMIDTvtY?=
 =?us-ascii?Q?auMacT+XG+DiXxkLR2kXmnB29nybUvbo27S/fnqK8dSv21SzengMMt6zRk0b?=
 =?us-ascii?Q?v7b6AhCdgucVd6uulGSmIAw9fpN7aTIQyClwjVYj6AvH00XqdslqwKCrkBCN?=
 =?us-ascii?Q?qqYp5Yli2DnJwfH0Fa41rUjrsyzp7NuHL6x/X65k85CqK0UWgg32g+B3Uaj3?=
 =?us-ascii?Q?idekwnMeHIThHLxnftJlToUNjuqAQpHEFrvvvM8Tc7b0bjS/1pbA065RZIjj?=
 =?us-ascii?Q?Wiy8wh4j0J8sv0WNOw6CRQVqt/lKAHzBeFlKi7TZEMD9WTWyEgf35Q+y2d1Q?=
 =?us-ascii?Q?pVV7+uhJJYJ34A6mE+5rdByifcNmMM6H/W1RAd+Brpa5xioFMp9NgRztKXd8?=
 =?us-ascii?Q?hJGxw7uCeMP6ypdh65CA7msC1EgzwTsqJIKRBq8LtvL7sHYA1Crao6SBd14l?=
 =?us-ascii?Q?VFaYtK8YmRIxhf8L593v/p8NHyNmqN15LR7aVZaLq9eDDQe/mcrYoiq4L/07?=
 =?us-ascii?Q?eLf5Kb4sCPn7G1WniqUuqNQWC7TIVxssrmId900SVDeEC5h321jk0RwEho9k?=
 =?us-ascii?Q?xCsIIEZBVdBpP7dTGM0aHOooRD+PoRDsqZa/wxaFnIIK7E0Vo2gwlZvWSr4k?=
 =?us-ascii?Q?1lDB3DYQ+UVm50vGcgixq4mCql+xZpfL9tw4ZNAKKAnltdpSZSfB4SeWRocN?=
 =?us-ascii?Q?2ZDlO0NCS8H4ymlLpZq5tHoOF2fxgZnCmaO/cN6dMtGW6TJVv8QNMlMiRfng?=
 =?us-ascii?Q?4NFj8J9b1bGlVbxxgbODSNct5iOVPbIIijYpxbW8lxKmrV19p6bI00talMC0?=
 =?us-ascii?Q?ZAQcVAHMGWRrhhRAixC+QR5WuF5VRJ6IdUbSSUvi34sJkDfQrDTHOqzr6pUF?=
 =?us-ascii?Q?4ndWinOvR5mFg8LpDg0/+cDwZv86tBADLSLxIRxcGHs0xj17L+okTfeyWx0e?=
 =?us-ascii?Q?YZrlWTM1nyNwPq7TUloluLDokZGLE+EALQhAWyfuKvLm5Y1SifUWbejUJ4E+?=
 =?us-ascii?Q?HrCdXXxObWx9otmscmRVEp2pF6AdEpr2vvPYXmBWBs64p+MA7IXbMIkwf14L?=
 =?us-ascii?Q?jnYVTDJpWtzsbAODysakXhzqA59EuJZYiVLGVB9Z5Yi4f94sP0KrDeOCi6ok?=
 =?us-ascii?Q?NAmqvmRLgyN0W6Q56MDQmLCbu0gZxjbCz0Uy0rZImZqpqdCujBHNaZrkQ0+s?=
 =?us-ascii?Q?bQ7qLnVTieTu/fTgjJJGxJ+vT+8rgsBDboLuGTGe2jv0yzO7UUQYuoE0AQ2T?=
 =?us-ascii?Q?3hPxu7W9oHVDf8wQ/EM4MzOP4f3iMFpoDYxPdGi9FZw03wgeOWkJgxybVsKN?=
 =?us-ascii?Q?dVh7Iq0GZ/EGcvdFka34lN7zOvh7i8uOzR+Bc0oJv29uFLbBVsRr+PK+Nkfh?=
 =?us-ascii?Q?2OgUUqReCx49+EgHguxtldiBvky6Xw/vwxD3hHrP8yYrH7Fjxctny/d9VzLs?=
 =?us-ascii?Q?89uQO2aGZznMBY31yjqrlm0oT4IqDCZemssybyLalBQGlz8xYP1aigVNf8oN?=
 =?us-ascii?Q?edNxgBQ36FI2Gw+tDLdBnY0E7yYDTsYKfqqp0WVo708rLMnJFqeZ2OPnAw8G?=
 =?us-ascii?Q?4g=3D=3D?=
X-MS-Exchange-CrossTenant-Network-Message-Id: cfa57bc6-5c35-44cb-4d76-08da92432dc4
X-MS-Exchange-CrossTenant-AuthSource: MN0PR11MB6059.namprd11.prod.outlook.com
X-MS-Exchange-CrossTenant-AuthAs: Internal
X-MS-Exchange-CrossTenant-OriginalArrivalTime: 09 Sep 2022 09:10:45.7618
 (UTC)
X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted
X-MS-Exchange-CrossTenant-Id: 46c98d88-e344-4ed4-8496-4ed7712e255d
X-MS-Exchange-CrossTenant-MailboxType: HOSTED
X-MS-Exchange-CrossTenant-UserPrincipalName: u3N54i9w/fe1TK563ILU/41bAIxPdvrRPw6c6kTMW14fHd2k7yffy2dEXY24RTr2P1it8ehThDoj5jo09GxZwA==
X-MS-Exchange-Transport-CrossTenantHeadersStamped: DM6PR11MB4739
X-OriginatorOrg: intel.com
X-Spam-Status: No, score=-4.4 required=5.0 tests=BAYES_00,DKIMWL_WL_HIGH,
        DKIM_SIGNED,DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,RCVD_IN_DNSWL_MED,
        RCVD_IN_MSPIKE_H3,RCVD_IN_MSPIKE_WL,SPF_HELO_NONE,SPF_NONE,
        T_SCC_BODY_TEXT_LINE autolearn=ham autolearn_force=no version=3.4.6
X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on
        lindbergh.monkeyblade.net
Precedence: bulk
List-ID: <linux-kernel.vger.kernel.org>
X-Mailing-List: linux-kernel@vger.kernel.org

On Fri, Sep 09, 2022 at 09:34:39AM +0200, Mauro Carvalho Chehab wrote:
> There are other files with kernel-doc markups:
> 
> 	$ git grep -l "/\*\*" $(git ls-files|grep drivers/gpu/drm/i915/) >kernel-doc-files
> 	$ for i in $(cat kernel-doc-files); do if [ "$(git grep $i Documentation/)" == "" ]; then echo "$i"; fi; done >aaa
> 
> Add them to i915.rst as well.
> 
> Signed-off-by: Mauro Carvalho Chehab <mchehab@kernel.org>

Reviewed-by: Rodrigo Vivi <rodrigo.vivi@intel.com>

> ---
> 
> To avoid mailbombing on a large number of people, only mailing lists were C/C on the cover.
> See [PATCH v3 00/37] at: https://lore.kernel.org/all/cover.1662708705.git.mchehab@kernel.org/
> 
>  Documentation/gpu/i915.rst | 85 +++++++++++++++++++++++++++++++++++++-
>  1 file changed, 83 insertions(+), 2 deletions(-)
> 
> diff --git a/Documentation/gpu/i915.rst b/Documentation/gpu/i915.rst
> index 545fe630557a..7f5cd01ed398 100644
> --- a/Documentation/gpu/i915.rst
> +++ b/Documentation/gpu/i915.rst
> @@ -13,6 +13,11 @@ Core Driver Infrastructure
>  This section covers core driver infrastructure used by both the display
>  and the GEM parts of the driver.
>  
> +Core driver
> +-----------
> +
> +.. kernel-doc:: drivers/gpu/drm/i915/i915_driver.c
> +
>  Runtime Power Management
>  ------------------------
>  
> @@ -29,6 +34,8 @@ Runtime Power Management
>  
>  .. kernel-doc:: drivers/gpu/drm/i915/intel_pm.c
>  
> +.. kernel-doc:: drivers/gpu/drm/i915/intel_wakeref.h
> +
>  Interrupt Handling
>  ------------------
>  
> @@ -44,8 +51,25 @@ Interrupt Handling
>  .. kernel-doc:: drivers/gpu/drm/i915/i915_irq.c
>     :functions: intel_runtime_pm_enable_interrupts
>  
> -Intel GVT-g Guest Support(vGPU)
> --------------------------------
> +Memory Handling
> +---------------
> +
> +.. kernel-doc:: drivers/gpu/drm/i915/i915_vma_resource.h
> +
> +.. kernel-doc:: drivers/gpu/drm/i915/i915_vma_resource.c
> +
> +.. kernel-doc:: drivers/gpu/drm/i915/i915_vma.h
> +
> +.. kernel-doc:: drivers/gpu/drm/i915/i915_vma.c
> +
> +.. kernel-doc:: drivers/gpu/drm/i915/i915_mm.c
> +
> +.. kernel-doc:: drivers/gpu/drm/i915/intel_memory_region.c
> +
> +.. kernel-doc:: drivers/gpu/drm/i915/i915_memcpy.c
> +
> +Intel GVT-g Guest Support (vGPU)
> +--------------------------------
>  
>  .. kernel-doc:: drivers/gpu/drm/i915/i915_vgpu.c
>     :doc: Intel GVT-g guest support
> @@ -109,6 +133,55 @@ Workarounds
>  .. kernel-doc:: drivers/gpu/drm/i915/gt/intel_workarounds.c
>     :doc: Hardware workarounds
>  
> +Scatterlist handling
> +--------------------
> +
> +.. kernel-doc:: drivers/gpu/drm/i915/i915_scatterlist.h
> +
> +.. kernel-doc:: drivers/gpu/drm/i915/i915_scatterlist.c
> +
> +i915 request
> +------------
> +
> +.. kernel-doc:: drivers/gpu/drm/i915/i915_request.h
> +
> +.. kernel-doc:: drivers/gpu/drm/i915/i915_request.c
> +
> +Others
> +------
> +
> +.. kernel-doc:: drivers/gpu/drm/i915/i915_ioc32.c
> +
> +.. kernel-doc:: drivers/gpu/drm/i915/i915_gpu_error.c
> +
> +.. kernel-doc:: drivers/gpu/drm/i915/i915_active.h
> +
> +.. kernel-doc:: drivers/gpu/drm/i915/i915_deps.c
> +
> +.. kernel-doc:: drivers/gpu/drm/i915/i915_deps.h
> +
> +.. kernel-doc:: drivers/gpu/drm/i915/intel_device_info.c
> +
> +.. kernel-doc:: drivers/gpu/drm/i915/i915_params.c
> +
> +.. kernel-doc:: drivers/gpu/drm/i915/i915_sw_fence_work.h
> +
> +.. kernel-doc:: drivers/gpu/drm/i915/i915_syncmap.c
> +
> +.. kernel-doc:: drivers/gpu/drm/i915/intel_pcode.c
> +
> +.. kernel-doc:: drivers/gpu/drm/i915/i915_reg_defs.h
> +
> +.. kernel-doc:: drivers/gpu/drm/i915/intel_wopcm.h
> +
> +
> +Protected Xe Path (PXP)
> +-----------------------
> +
> +.. kernel-doc:: drivers/gpu/drm/i915/pxp/intel_pxp_irq.c
> +
> +.. kernel-doc:: drivers/gpu/drm/i915/pxp/intel_pxp_tee.c
> +
>  Display Hardware Handling
>  =========================
>  
> @@ -615,6 +688,12 @@ Protected Objects
>  Table Manager (TTM)
>  -------------------
>  
> +.. kernel-doc:: drivers/gpu/drm/i915/i915_ttm_buddy_manager.h
> +
> +.. kernel-doc:: drivers/gpu/drm/i915/i915_ttm_buddy_manager.c
> +
> +.. kernel-doc:: drivers/gpu/drm/i915/intel_region_ttm.c
> +
>  .. kernel-doc:: drivers/gpu/drm/i915/gem/i915_gem_ttm.c
>  
>  .. kernel-doc:: drivers/gpu/drm/i915/gem/i915_gem_ttm.h
> @@ -624,6 +703,8 @@ Table Manager (TTM)
>  Graphics Execution Manager (GEM)
>  --------------------------------
>  
> +.. kernel-doc:: drivers/gpu/drm/i915/i915_gem.c
> +
>  .. kernel-doc:: drivers/gpu/drm/i915/gem/i915_gem_create.c
>  
>  .. kernel-doc:: drivers/gpu/drm/i915/gem/i915_gem_domain.c
> -- 
> 2.37.3
>