From nobody Mon Dec 1 22:06:12 2025 Received: from mail-qv1-f52.google.com (mail-qv1-f52.google.com [209.85.219.52]) (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 F310728F5 for ; Mon, 1 Dec 2025 04:26:54 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.219.52 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1764563216; cv=none; b=DgZKSo1F07OJDLtQ/JC6Tnaq9AXF3CUOaUrQa0o96qskTsaH8bGzfR5iyICym5rJgqqTU407lsecqPm7WtYVcPpHIc8rBJr8HX0n0K3bbNYYCx17PJTimQMYDL+8mnTgpeatfL8kdoD1Yzn7lxMHs/8pp9v7nSXfAwKBWPeLhUY= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1764563216; c=relaxed/simple; bh=s2zZcpkhEWJzD4hdcW5jRWBegv/r6soWrUEvNqdRjVU=; h=From:To:Cc:Subject:Date:Message-Id:MIME-Version; b=om2hj7p3BQfdNimleQDfVjqmOJluuNnyJ0GcKlysrYi8ln9B1njLLe6izGL2zrOdfj968XW0FfaYnGXP2sgBak1mUoghiD3M+FQlGQvH5yH/32n5Vy2tN1OH//28YvDOd0lNRaKQL8NvvaV94HV+yqiQTw53zSrvi3bXL8p6vAU= 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=RRGbC9U2; arc=none smtp.client-ip=209.85.219.52 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="RRGbC9U2" Received: by mail-qv1-f52.google.com with SMTP id 6a1803df08f44-88059c28da1so36935796d6.2 for ; Sun, 30 Nov 2025 20:26:54 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1764563214; x=1765168014; darn=vger.kernel.org; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:from:to:cc:subject:date:message-id:reply-to; bh=iA2L2HQEqrwIONxNXAAo9wwBSUWk3QOPio/3w8+Rs+0=; b=RRGbC9U2lARf+wuNHcpl6t/YojrhsvUVyxkJ/o9wprDqqykQ8GDQQILLj++UbMQya/ lfsG0u5RbAJzveDg4VqoaQXqkc+NM1tv5TZPjFOJKJS6xCJeXXG7n0SrwXKo3Tvcj65w +NjToBT9oxvyygqrWunT3kAG9jRGfa7HIWhDJQO9pPyGw0zUiujuEfW+6GDmYGuYpehU w8qIHJmywOFr+dFD870HtJd/Xj3cM8fAZsYVeOkRY9K9PnXPq5GzLp/GTZChrAT/jpWq WICpmvuQStpSarROYSU7GcQfaj58DEzu1e3V1WLknYEkcsnFSB/etjefYxid0yabBl+A 83lQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1764563214; x=1765168014; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:x-gm-gg:x-gm-message-state:from:to:cc:subject:date :message-id:reply-to; bh=iA2L2HQEqrwIONxNXAAo9wwBSUWk3QOPio/3w8+Rs+0=; b=jzXsoH8CDJbjSPrhbtP15TVOUkpATxwm+l/56PEdWEyPV7jUoIXa4mtNiqtbrFzuK9 ciQgYg973zZ2NMsyCIq8JumLQMzuhCQsBFDht5xVJet7G5MvdY7zm/SXoHRrUW9Jn/ds qnBrLLgyZIHVasG5A5D2E5jiQe3DRLjnDGXv9q0H6Pww65kOZtSu0BX7ygYEy9FZslze KAVTzsbwNLwZuYofJNhNZjy9ps2XS/ljzkyzlY7fycnQkVO8+xnTpKW9cwnzbrJnznpD LMl1JGdgFhmgo84JFs17Q4E+sz0f029M5vyMjBGJCzU923Gt4IZ5mp2HQ8rb8sYvM3f4 4oyQ== X-Forwarded-Encrypted: i=1; AJvYcCXnboHVlwE5jWGADcH2luOta9Av+6Rp+uncLaesrMl2SGgyO/vpGPt9qlTaLhuavB5dU7FTA9UX1X0uBco=@vger.kernel.org X-Gm-Message-State: AOJu0YxyUHNWgRSpXPv8x8yx526YLSkAVIn5d11gYAL9N3Qdo8bGoV2B +9GVRpBBjgr9HRP0r7gstAtdAzYpDSwRCWuGU9UsXT59JQz8wgARdXwi X-Gm-Gg: ASbGncuPeroJLJrVlOPQ9TpsS4mRBdJMbE+SO0P4kWgOsP5uBQSkfxotObak7agmW1u hVnI3ImNxY0C/Yo8HgZnCz2SfI6ToMFq/xkONaWNoRJIMQ3gOPl8V0FzPn1IJ94x7eNZcXn0SEh whhm4xzvLIP4EMd3OIa1B13QXZ3SQVWIXEgtmyjBWwlx2KUyAejTwQUr87qHf8zqkL3HCPXwE44 GRUWMrF/Hze3QJRH4mnAyCkaN9t34Z9xgZcUd1vVcFInfk1JEcIYFYCE30TfyV+hd+jmvflVHxn zqZNtZcA3mevyOcvhUeF+6NljAIDnZDNdJA4oyMNrsxIgKHB5kh6P3VxUnILbYQoeSCZ0Cpy+wE BpzIIo9fTfvcNg/oskKnS9k/u8Mta0mevuQ9lsTu/1BbFdii4yPuYfFwxdx6Kq5Hru1lnJiCXbH Svx4mEEAQtHwCjZhZTcQTYsxVdcghxYGBYQHDnN7jKJyM= X-Google-Smtp-Source: AGHT+IHJNgnwvHT8MT6+kFZLJD0Hr6y23R2yf99SVlSjIE66NXGl1ukySq/D0tYSFKVIS/2/Iy5WIA== X-Received: by 2002:a05:6214:e85:b0:87b:cbf7:5eae with SMTP id 6a1803df08f44-8847c57cd6cmr710418546d6.59.1764563213698; Sun, 30 Nov 2025 20:26:53 -0800 (PST) Received: from kernel-internship-machine.. ([143.110.209.46]) by smtp.gmail.com with ESMTPSA id 6a1803df08f44-88652b494e0sm75621836d6.26.2025.11.30.20.26.52 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sun, 30 Nov 2025 20:26:53 -0800 (PST) From: Vivek BalachandharTN To: Lee Jones , Pavel Machek Cc: linux-leds@vger.kernel.org, linux-kernel@vger.kernel.org, Vivek Balachandhar TN Subject: [PATCH] leds: lm3692x: fix kernel-doc for struct lm3692x_led Date: Mon, 1 Dec 2025 04:26:12 +0000 Message-Id: <20251201042612.2099239-1-vivek.balachandhar@gmail.com> X-Mailer: git-send-email 2.34.1 Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Building with W=3D1 reports several kernel-doc warnings in drivers/leds/leds-lm3692x.c: Warning: leds-lm3692x.c:122 struct member 'boost_ctrl' not described in 'lm3692x_led' Warning: leds-lm3692x.c:122 struct member 'brightness_ctrl' not described in 'lm3692x_led' Warning: leds-lm3692x.c:122 struct member 'enabled' not described in 'lm3692x_led' These fields were added to struct lm3692x_led but the corresponding kernel-doc comment was not updated. Convert the kernel-doc block to use the "@member: description" style consistently and document the boost_ctrl, brightness_ctrl and enabled fields. This keeps the documentation in sync with the implementation and silences the W=3D1 warnings. Signed-off-by: Vivek BalachandharTN --- drivers/leds/leds-lm3692x.c | 3 +++ 1 file changed, 3 insertions(+) diff --git a/drivers/leds/leds-lm3692x.c b/drivers/leds/leds-lm3692x.c index c319ff4d70b2..1d64ceb5ac85 100644 --- a/drivers/leds/leds-lm3692x.c +++ b/drivers/leds/leds-lm3692x.c @@ -104,6 +104,9 @@ * @regulator: LED supply regulator pointer * @led_enable: LED sync to be enabled * @model_id: Current device model ID enumerated + * @boost_ctrl: Cached configuration for the boost control register + * @brightness_ctrl: Cached configuration for brightness/brightness control + * @enabled: Cached enable state of the device */ struct lm3692x_led { struct mutex lock; --=20 2.34.1