From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mail-pl1-f179.google.com (mail-pl1-f179.google.com [209.85.214.179]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 1607A33F595 for ; Thu, 16 Apr 2026 05:41:15 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.214.179 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1776318077; cv=none; b=SHVaOjM1+SQQ0omkZTrpTKSKpOiAJH6Q+38EaT/AIa3w5leXJQwo7RLHW0EgxoA1Legc/J4EnTN7yVpdewbZkwOw3flZHPqMAoehWYV1N2cxKzijpgReY7qpc40hM8YnKH4zirN6Tq3XyNZQKX5IWJ5QqVsG6s+56kVvDPCCkVQ= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1776318077; c=relaxed/simple; bh=IvLO3UgIfErQY6AqaYtmmRdkEYdt0UIpEUIZDMSNT/A=; h=Message-ID:Date:MIME-Version:To:Cc:References:Subject:From: In-Reply-To:Content-Type; b=JZm9SEm0nqfigE5wiIlMvu69TotfinIlSJXLcm4sUaCfLfKZxq5QvTyh108doZFVVo/DY11y6tBVoZaWn3Q5eWVKP3kCOGfQqGzO+Aw0K4AZQkt9cixRaHq4tZIbqpCStl2Cm7BewrqW/XPUt/W0WaRVMMFtIuiTEjYsv3BoQ+0= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=YjdyffSE; arc=none smtp.client-ip=209.85.214.179 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="YjdyffSE" Received: by mail-pl1-f179.google.com with SMTP id d9443c01a7336-2b2503753efso66842995ad.0 for ; Wed, 15 Apr 2026 22:41:15 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20251104; t=1776318075; x=1776922875; darn=vger.kernel.org; h=content-transfer-encoding:in-reply-to:from:content-language:subject :references:cc:to:user-agent:mime-version:date:message-id:from:to:cc :subject:date:message-id:reply-to; bh=Cag2ptL6wrm0V5bGbrcQIfwBYr+GeQUuV1iySRth4GY=; b=YjdyffSETEAoC3gwx50GHuvyi8nz7urfr+gUq6LyAP71Xkv4imTvb46FHNbdP+fZLG O+B5+lr7ZyLIPmL+CVlHb158iGp062ggwaWHHuT/ztayMHU52Cy4u3y3CDZGBcIMIQsw Y8smB5TLS+Eu5pc/nKNKYtFEdcyY3qgC3SPd4HyHLlb1pxyQETdD4JkBTOqpe5XhESfS upOe+v5p0GL0HkyLcQPByv+hZMtXTOp3CW5GdEDYfcF0JERZMEoXJuMWeBnfkwUh5fZ0 RpatPUzIvdb0MB04U82mWJDn8s/ICJ6JoEV6qA5LoGUM62Q8CalF9IwSe1es0eQchw5c w8+Q== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20251104; t=1776318075; x=1776922875; h=content-transfer-encoding:in-reply-to:from:content-language:subject :references:cc:to:user-agent:mime-version:date:message-id:x-gm-gg :x-gm-message-state:from:to:cc:subject:date:message-id:reply-to; bh=Cag2ptL6wrm0V5bGbrcQIfwBYr+GeQUuV1iySRth4GY=; b=CtL8wEHB7aOskDZ+0k4cB+miyy7Qgz3k1PHAFfpr3Q7dvEIjB04X0rMkuGiIxVvMg8 3vC/agenLgwWvNX0RvFiD81f/RankgF4Aq+o6R8oFI2cOhKShmEN+DuH5oYZERqVZKim nFrtP69odXMD0cN/5+W2uf+vwz+6h/GasfaMJzcTCzexg6eHD6PRjre/8WdwkvyMLWNW 8k8r444ikk/fdLzT9Cn+YAvSFh9MGgC2aykcJq91vbswex/2xY7aox8BW787qLGdm0VZ X28w0J/anLd2BfiqN5VR6Or8oTsleFwdjbDKCeVK2N1QBazHV6J/yjfy4TquaL9ksPpI WHOA== X-Forwarded-Encrypted: i=1; AFNElJ8qPeipStlsI8EAzn42plVcmQb4JiRPOsr7YweznqZrSes+5vfClADNiE0LQaJw1hTX1SW9jFQMGmBddXk=@vger.kernel.org X-Gm-Message-State: AOJu0Yz4MauzoZjcLI4Wl1cIih3G2Nqw++v5YKM983isBPP7wHmAZ/3n P7g3af4XX36ic3xgwIyIay/3a5hrZsRxM5d5LW7iu5QsDJ8g7uIF9Irz X-Gm-Gg: AeBDietbS6YUrjlFGc9WOq342am8vFQua48PUuPlfjASgXmQbQFSIIlrvgaDtNieP3w e82f3q2B5CPgjs3tipz2T8EHRz9gCeYxRNZovpaDKtwtFr4F2zDsaufq6ZPd84CPbTNJqnsikax /sYT8lBJbbpS/c/G3FYDjG0vuGXdpANzOQV9d7RBqNKbxqCjIM3pYwQ7CSoVTJ/8wtEqSQq0xnO kpU3svRlZqgqth81UVvtVF/J6Rpl0EwsdgTyfDjNXlIlgcXJgRdmn/oFZitxujMwaCaFv6nfPBG 0QlVL0feRK15yF54TDuuusVuzRfl8UHH+EQTw7qYy4KsYysCC/uPUZWf+MYeqf1QIZ4m3Ynhgtd k3VOigXl6yuderYitgb+yF4VReqWuVm2it2fPq8TDClFs5USpdVoItgsSDuaS29jJjYV2A19xBw j0k9CiDuE9qoZk7mXtgUGl/fYMU8OovfMeBTxZO8VwMd8yEF/PnO05HvSj60H5v1n72yOq X-Received: by 2002:a17:902:c94d:b0:2b2:3eec:c75f with SMTP id d9443c01a7336-2b2d5a3837emr259023135ad.28.1776318075370; Wed, 15 Apr 2026 22:41:15 -0700 (PDT) Received: from [10.0.2.15] (KD106167137155.ppp-bb.dion.ne.jp. [106.167.137.155]) by smtp.gmail.com with ESMTPSA id d9443c01a7336-2b4782b6704sm55716045ad.75.2026.04.15.22.41.13 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Wed, 15 Apr 2026 22:41:14 -0700 (PDT) Message-ID: <6d754f54-d1c8-4175-a0f0-dd51eb26930d@gmail.com> Date: Thu, 16 Apr 2026 14:41:12 +0900 Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 User-Agent: Mozilla Thunderbird To: sanjayembeddedse@gmail.com Cc: airlied@gmail.com, corbet@lwn.net, dri-devel@lists.freedesktop.org, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, maarten.lankhorst@linux.intel.com, mripard@kernel.org, simona@ffwll.ch, skhan@linuxfoundation.org, tzimmermann@suse.de References: Subject: Re: [PATCH] Documentation/gpu: resolve kerneldoc duplicate declaration warning Content-Language: en-US From: Akira Yokosawa In-Reply-To: Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Hello, > On 18 March 2026 8:06:12 pm IST, Sanjay Chitroda wrote: >>From: Sanjay Chitroda >> >>kernel-doc build with `make htmldocs` reports following WARNINGS. >> >> Documentation/gpu/drm-kms:360: ../drivers/gpu/drm/drm_fourcc.c:397: >> WARNING: Duplicate C declaration, also defined at gpu/drm-kms:35. >> Declaration is '.. c:function:: >> const struct drm_format_info * drm_format_info (u32 format)'. >> >> Documentation/gpu/drm-kms:491: ../drivers/gpu/drm/drm_modeset_lock.c:377: >> WARNING: Duplicate C declaration, also defined at gpu/drm-kms:48. >> Declaration is '.. c:function:: int drm_modeset_lock >> (struct drm_modeset_lock *lock, struct drm_modeset_acquire_ctx *ctx)'. >> >> Documentation/gpu/drm-uapi:607: ../drivers/gpu/drm/drm_ioctl.c:923: >> WARNING: Duplicate C declaration, also defined at gpu/drm-uapi:69. >> Declaration is '.. c:function:: >> bool drm_ioctl_flags (unsigned int nr, unsigned int *flags)'. >> >>Add :no-identifiers: to prevent duplicate identifier generation and >>keep the function documented at its implementation site. >> >>No functional change. >> >>Link: https://lore.kernel.org/oe-kbuild-all/202512302319.1PGGt3CN-lkp@intel.com/ >>Signed-off-by: Sanjay Chitroda >>--- >> Documentation/gpu/drm-kms.rst | 2 ++ >> Documentation/gpu/drm-uapi.rst | 3 ++- >> 2 files changed, 4 insertions(+), 1 deletion(-) >> >>diff --git a/Documentation/gpu/drm-kms.rst b/Documentation/gpu/drm-kms.rst >>index 2292e65f044c..0f0f90b3186d 100644 >>--- a/Documentation/gpu/drm-kms.rst >>+++ b/Documentation/gpu/drm-kms.rst >>@@ -356,6 +356,7 @@ Format Functions Reference >> >> .. kernel-doc:: include/drm/drm_fourcc.h >> :internal: >>+ :no-identifiers: drm_format_info >> >> .. kernel-doc:: drivers/gpu/drm/drm_fourcc.c >> :export: >>@@ -487,6 +488,7 @@ KMS Locking >> >> .. kernel-doc:: include/drm/drm_modeset_lock.h >> :internal: >>+ :no-identifiers: drm_modeset_lock >> >> .. kernel-doc:: drivers/gpu/drm/drm_modeset_lock.c >> :export: >>diff --git a/Documentation/gpu/drm-uapi.rst b/Documentation/gpu/drm-uapi.rst >>index d98428a592f1..73b49e0dcda8 100644 >>--- a/Documentation/gpu/drm-uapi.rst >>+++ b/Documentation/gpu/drm-uapi.rst >>@@ -603,6 +603,7 @@ DRM specific patterns. Note that ENOTTY has the slightly unintuitive meaning of >> >> .. kernel-doc:: include/drm/drm_ioctl.h >> :internal: >>+ :no-identifiers: drm_ioctl_flags >> >> .. kernel-doc:: drivers/gpu/drm/drm_ioctl.c >> :export: >>@@ -761,4 +762,4 @@ Stable uAPI events >> From ``drivers/gpu/drm/scheduler/gpu_scheduler_trace.h`` >> >> .. kernel-doc:: drivers/gpu/drm/scheduler/gpu_scheduler_trace.h >>- :doc: uAPI trace events >>\ No newline at end of file >>+ :doc: uAPI trace events > > Hi all, > > Requesting your input on the change. > Is there anything that I missed or required correction ? Your patch is ignored because there is no duplicate in those identifiers. As you are well aware of, you can have a function and a struct of the same name. It is a long-standing bug (almost 6 years now!) in Sphinx C-domain support. Please have a look at my earlier email: https://lore.kernel.org/f735ce0b-db1e-49bc-86ac-b5ab8e4aec31@gmail.com/ It is dated "26 Mar 2024", but the issue remains unresolved. I'd appreciate if you could make some contribution for fixing the Sphinx bug. Regards, Akira PS: Please ignore several typos I made in the earlier email ;-)