Message-ID: <20251215113903.46555-12-bagasdotme@gmail.com>
Date: Mon, 15 Dec 2025 18:38:59 +0700
From: Bagas Sanjaya <bagasdotme@...il.com>
To: Linux Kernel Mailing List <linux-kernel@...r.kernel.org>,
	Linux AMDGPU <amd-gfx@...ts.freedesktop.org>,
	Linux DRI Development <dri-devel@...ts.freedesktop.org>,
	Linux Filesystems Development <linux-fsdevel@...r.kernel.org>,
	Linux Media <linux-media@...r.kernel.org>,
	linaro-mm-sig@...ts.linaro.org,
	kasan-dev@...glegroups.com,
	Linux Virtualization <virtualization@...ts.linux.dev>,
	Linux Memory Management List <linux-mm@...ck.org>,
	Linux Network Bridge <bridge@...ts.linux.dev>,
	Linux Networking <netdev@...r.kernel.org>
Cc: Harry Wentland <harry.wentland@....com>,
	Leo Li <sunpeng.li@....com>,
	Rodrigo Siqueira <siqueira@...lia.com>,
	Alex Deucher <alexander.deucher@....com>,
	Christian König <christian.koenig@....com>,
	David Airlie <airlied@...il.com>,
	Simona Vetter <simona@...ll.ch>,
	Maarten Lankhorst <maarten.lankhorst@...ux.intel.com>,
	Maxime Ripard <mripard@...nel.org>,
	Thomas Zimmermann <tzimmermann@...e.de>,
	Matthew Brost <matthew.brost@...el.com>,
	Danilo Krummrich <dakr@...nel.org>,
	Philipp Stanner <phasta@...nel.org>,
	Alexander Viro <viro@...iv.linux.org.uk>,
	Christian Brauner <brauner@...nel.org>,
	Jan Kara <jack@...e.cz>,
	Sumit Semwal <sumit.semwal@...aro.org>,
	Alexander Potapenko <glider@...gle.com>,
	Marco Elver <elver@...gle.com>,
	Dmitry Vyukov <dvyukov@...gle.com>,
	"Michael S. Tsirkin" <mst@...hat.com>,
	Jason Wang <jasowang@...hat.com>,
	Xuan Zhuo <xuanzhuo@...ux.alibaba.com>,
	Eugenio Pérez <eperezma@...hat.com>,
	Andrew Morton <akpm@...ux-foundation.org>,
	Uladzislau Rezki <urezki@...il.com>,
	Nikolay Aleksandrov <razor@...ckwall.org>,
	Ido Schimmel <idosch@...dia.com>,
	"David S. Miller" <davem@...emloft.net>,
	Eric Dumazet <edumazet@...gle.com>,
	Jakub Kicinski <kuba@...nel.org>,
	Paolo Abeni <pabeni@...hat.com>,
	Simon Horman <horms@...nel.org>,
	Taimur Hassan <Syed.Hassan@....com>,
	Wayne Lin <Wayne.Lin@....com>,
	Alex Hung <alex.hung@....com>,
	Aurabindo Pillai <aurabindo.pillai@....com>,
	Dillon Varone <Dillon.Varone@....com>,
	George Shen <george.shen@....com>,
	Aric Cyr <aric.cyr@....com>,
	Cruise Hung <Cruise.Hung@....com>,
	Mario Limonciello <mario.limonciello@....com>,
	Sunil Khatri <sunil.khatri@....com>,
	Dominik Kaszewski <dominik.kaszewski@....com>,
	Bagas Sanjaya <bagasdotme@...il.com>,
	David Hildenbrand <david@...nel.org>,
	Peter Zijlstra <peterz@...radead.org>,
	Lorenzo Stoakes <lorenzo.stoakes@...cle.com>,
	Max Kellermann <max.kellermann@...os.com>,
	"Nysal Jan K.A." <nysal@...ux.ibm.com>,
	Ryan Roberts <ryan.roberts@....com>,
	Alexey Skidanov <alexey.skidanov@...el.com>,
	Vlastimil Babka <vbabka@...e.cz>,
	Kent Overstreet <kent.overstreet@...ux.dev>,
	Vitaly Wool <vitaly.wool@...sulko.se>,
	Harry Yoo <harry.yoo@...cle.com>,
	Mateusz Guzik <mjguzik@...il.com>,
	NeilBrown <neil@...wn.name>,
	Amir Goldstein <amir73il@...il.com>,
	Jeff Layton <jlayton@...nel.org>,
	Ivan Lipski <ivan.lipski@....com>,
	Tao Zhou <tao.zhou1@....com>,
	YiPeng Chai <YiPeng.Chai@....com>,
	Hawking Zhang <Hawking.Zhang@....com>,
	Lyude Paul <lyude@...hat.com>,
	Daniel Almeida <daniel.almeida@...labora.com>,
	Luben Tuikov <luben.tuikov@....com>,
	Matthew Auld <matthew.auld@...el.com>,
	Roopa Prabhu <roopa@...ulusnetworks.com>,
	Mao Zhu <zhumao001@...suo.com>,
	Shaomin Deng <dengshaomin@...rlc.com>,
	Charles Han <hanchunchao@...pur.com>,
	Jilin Yuan <yuanjilin@...rlc.com>,
	Swaraj Gaikwad <swarajgaikwad1925@...il.com>,
	George Anthony Vernon <contact@...rnon.com>
Subject: [PATCH 11/14] drm/gem/shmem: Describe @shmem and @size parameters

Sphinx reports kernel-doc warnings:

WARNING: ./drivers/gpu/drm/drm_gem_shmem_helper.c:104 function parameter 'shmem' not described in 'drm_gem_shmem_init'
WARNING: ./drivers/gpu/drm/drm_gem_shmem_helper.c:104 function parameter 'size' not described in 'drm_gem_shmem_init'

Describe the parameters.

Fixes: e3f4bdaf2c5bfe ("drm/gem/shmem: Extract drm_gem_shmem_init() from drm_gem_shmem_create()")
Signed-off-by: Bagas Sanjaya <bagasdotme@...il.com>
---
 drivers/gpu/drm/drm_gem_shmem_helper.c | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/drivers/gpu/drm/drm_gem_shmem_helper.c b/drivers/gpu/drm/drm_gem_shmem_helper.c
index 93b9cff89080f9..7f73900abcbb9d 100644
--- a/drivers/gpu/drm/drm_gem_shmem_helper.c
+++ b/drivers/gpu/drm/drm_gem_shmem_helper.c
@@ -96,7 +96,8 @@ static int __drm_gem_shmem_init(struct drm_device *dev, struct drm_gem_shmem_obj
 /**
  * drm_gem_shmem_init - Initialize an allocated object.
  * @dev: DRM device
- * @obj: The allocated shmem GEM object.
+ * @shmem: The allocated shmem GEM object.
+ * @size: shmem GEM object size
  *
  * Returns:
  * 0 on success, or a negative error code on failure.
-- 
An old man doll... just what I always wanted! - Clara

Powered by blists - more mailing lists