From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from foss.arm.com (foss.arm.com [217.140.110.172]) by smtp.subspace.kernel.org (Postfix) with ESMTP id A04AE3D1CD7 for ; Wed, 8 Apr 2026 14:09:05 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=217.140.110.172 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1775657347; cv=none; b=u3BeaOHCJytLDolRUZ76BwN1doK1tN6knYf9G6I92GztdMx1WjEpM0TckFyvW7hCvP7S2S36J7kGt88EQwB7jFdTugnQL/MkrJsUEvkwo3U8DBjpgi8Jhr9Cm/0avCaRWIKp9sIinVwJuSeWlUdSZtxSt+JKihWyWknueDnj5zs= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1775657347; c=relaxed/simple; bh=NGRGYkcFgbH8rvU4niZmKXkXJd9gpnZOfh8u8Kdq1S4=; h=Message-ID:Date:MIME-Version:Subject:To:Cc:References:From: In-Reply-To:Content-Type; b=Lvcjz96rjYVRD4XL4rXZ8szTFGOd2NCGpxIf1ZOHWPVyImq7M9xvzpKSMv+ezdoE5OOoAOj/ZcuXHYbeFkS3Qz2BkBv2i/kxyBiizv09y6muYS4S9jZGsAicYN2kAwqFwjNUD0DXhY5s9zt4DaB5L4JrQl/t5ue3mVDw1PaH5bc= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=arm.com; spf=pass smtp.mailfrom=arm.com; dkim=pass (1024-bit key) header.d=arm.com header.i=@arm.com header.b=OGdZie0Q; arc=none smtp.client-ip=217.140.110.172 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=arm.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=arm.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (1024-bit key) header.d=arm.com header.i=@arm.com header.b="OGdZie0Q" Received: from usa-sjc-imap-foss1.foss.arm.com (unknown [10.121.207.14]) by usa-sjc-mx-foss1.foss.arm.com (Postfix) with ESMTP id F1B40267F; Wed, 8 Apr 2026 07:08:58 -0700 (PDT) Received: from [10.57.32.88] (unknown [10.57.32.88]) by usa-sjc-imap-foss1.foss.arm.com (Postfix) with ESMTPSA id 0C4C63F632; Wed, 8 Apr 2026 07:09:03 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=simple/simple; d=arm.com; s=foss; t=1775657344; bh=NGRGYkcFgbH8rvU4niZmKXkXJd9gpnZOfh8u8Kdq1S4=; h=Date:Subject:To:Cc:References:From:In-Reply-To:From; b=OGdZie0Q21/+zdVkkTdt3+D5YRb8As+itfAVUtJQl2l3w402KQ0nvo5OshB7J863B h8aX87OjYrcOwwCyUgaJUgoSGAlIuLFqdB/pbYtqys9e7gL6fuVrCle004AAIEBH8r LLjtaTycuh+1fKlOaAdOkBS4mypCRoRFWiyQLG5A= Message-ID: Date: Wed, 8 Apr 2026 15:09:02 +0100 Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 User-Agent: Mozilla Thunderbird Subject: Re: [PATCH] drm/panthor: Fix kernel-doc in panthor_sched.c so it's visible To: Boris Brezillon , Liviu Dudau Cc: dri-devel@lists.freedesktop.org, linux-kernel@vger.kernel.org, Yicong Hui References: <20260408091242.799074-1-steven.price@arm.com> From: Steven Price Content-Language: en-GB In-Reply-To: <20260408091242.799074-1-steven.price@arm.com> Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 7bit On 08/04/2026 10:12, Steven Price wrote: > Various substructures defined in panthor_sched.c have kernel-doc which > is silently ignored because it doesn't include the full path to the > member. Fix these issues so that the kernel-doc text is actually output > by including the name of the parent. > > Fixes: de8548813824 ("drm/panthor: Add the scheduler logical block") > Signed-off-by: Steven Price > --- > drivers/gpu/drm/panthor/panthor_sched.c | 72 ++++++++++++------------- > 1 file changed, 36 insertions(+), 36 deletions(-) > > diff --git a/drivers/gpu/drm/panthor/panthor_sched.c b/drivers/gpu/drm/panthor/panthor_sched.c > index 3bb1cb5a2656..b255354553df 100644 > --- a/drivers/gpu/drm/panthor/panthor_sched.c > +++ b/drivers/gpu/drm/panthor/panthor_sched.c [...] > @@ -416,26 +416,26 @@ struct panthor_queue { > * queue is waiting on. > */ > struct { > - /** @gpu_va: GPU address of the synchronization object. */ > + /** @syncwait.gpu_va: GPU address of the synchronization object. */ > u64 gpu_va; > > - /** @ref: Reference value to compare against. */ > + /** @syncwait.ref: Reference value to compare against. */ > u64 ref; > > - /** @gt: True if this is a greater-than test. */ > + /** @syncwait.gt: True if this is a greater-than test. */ > bool gt; > > - /** @sync64: True if this is a 64-bit sync object. */ > + /** @synwait.sync64: True if this is a 64-bit sync object. */ > bool sync64; Sashiko spotted[1]: > This isn't a bug, but there is a typo here (synwait instead of syncwait). > Will this cause the kernel-doc script to miss this member and generate a > warning? I'm not sure how it thinks it "isn't a bug" (in a patch about fixing the comments), and indeed it will be missing from the output. I'll fix this up and push to drm-misc-next. Thanks, Steve [1] https://sashiko.dev/#/patchset/20260408091242.799074-1-steven.price%40arm.com