From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mail-pl1-f171.google.com (mail-pl1-f171.google.com [209.85.214.171]) (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 57702380FC8 for ; Sun, 12 Jul 2026 22:30:06 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.214.171 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1783895407; cv=none; b=RGIYPnV0TWeszu9EuQjeBs+paK5+fBzBQzMPshWJm3RE0Zs06ghpxGvNGK+yro0VoShgjlljGw7JdFDUYCfJBx5TzYUt3d3H3zzvlvBL2rlGeRzgYfbD4/2xmo5Hcywi38ZEmhYE6upuUL6qDnlLQnGolMt8nTLq2gszqVZGADM= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1783895407; c=relaxed/simple; bh=h4Vryts5/HJkz1V5caojW1TWYW0a9IEe9ExT/gVUbuU=; h=From:To:Cc:Subject:Date:Message-ID:MIME-Version; b=WuYPFewvS4FKXL3qiuphZuF+ffe5YVccnheXGfiDVnfRGzCHxGH0HiWqYtqBM3S5wLmfghWV3fHdgNgG1wZ8N+KOgZ5VINnJp2jPKJvHbGLR6qogWZNiwqFk6OU3yZkuBf3J1K0AiNmOtIl8TFDuOpV9d5sTYtMIApSX5drul60= 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=Hq7g4VFl; arc=none smtp.client-ip=209.85.214.171 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="Hq7g4VFl" Received: by mail-pl1-f171.google.com with SMTP id d9443c01a7336-2cad4170e8eso27986865ad.3 for ; Sun, 12 Jul 2026 15:30:06 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20251104; t=1783895405; x=1784500205; 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:content-type; bh=6oxtH7JnenqWTHEDhaGlPkoYn8q2KAF+d8dgovCM58M=; b=Hq7g4VFlv6kY2QLfb/WtqbSl2qGMYWwd6/JqSVJjFGG9/gWPPw45zAqidrecIVhb8U uXy6UFftSgznRgjX8Z3kqlyCgKFA8yqbwxbxR/O7HWobWENtA8/q3Hfi/SKyAmlohGQa 63SBMY7Ud639NsT22/eJl6/ynS0iAZqMo0beoijkoyca9k4gzoV8010kv3cH+7XiVWRZ jJpmOSVWi1VKKSdtsdgo6dqSFE6KXYxZxoauM9WHIg7PKokjrGuXH2ja9lWw31CiVBBW rfz0LsUI7gI9X6CMl1gK+j24GJqXKJfvqf4eoghkfzE4VG5U/CSOqAGD0b18izo0tXUS xS3w== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20251104; t=1783895405; x=1784500205; 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:content-type; bh=6oxtH7JnenqWTHEDhaGlPkoYn8q2KAF+d8dgovCM58M=; b=ckD2vAHqvSdL24eW1DcqVfWROZGVZFpIUzpzRQaPQ5UsSzRAX5iphTEldX9w12llvg wYNWXbBi5kTG+UdzGXZsnbSmqY5hccGTyH7I+d+BGR89VykSIgM0PyJEgRFzy5kHsNDn UGX2UzByc6wvjF4XyiZP5vwKxW9dtj1ZtHRP46wmtwUZZBWb3Wedg4hvLKvF5SaSosJF wJbSrhaGbM8c7hYm6gc/61hKBt6fph+/uQ871c6otFkFVVam2lEQYfhLBOTfLJ95mUq5 lawkVcuSd9fi4dDXpma2LLe84YwOpcRlS9JHS/zJzWGV5bAiuctP6p9VHrW7z7tdHVs8 YqfQ== X-Forwarded-Encrypted: i=1; AHgh+RpqKsSkYXC3q+PbanW4oBtJFSNSvESu7C4mPeNmR0DSuS5nTArK8Zzk+bK5juf7CWXZ/chE2giIwd9u2SU=@vger.kernel.org X-Gm-Message-State: AOJu0YyNPvsFRMG3cNrYlbbgmUeAUI6hAzM6dHRojJY00uB3lt2qObE6 lcCWdAJKWQ58QJ971xdZbkbDv7NJMY1cZyKM3Y2bTl3sijwUgxVqDf40 X-Gm-Gg: AfdE7cmQSiDPtX1uGmvKJgtf5nCrvMoqcXxJNZNPwnjzBiTE0McKYrpt3QyyAggmgLi 1M39+2qOhbznMNbAHZXqlMjHdaEUfw0qlneehOC6td3jiKCmjGG21vW7c6YRe6az64xmNxAlu3G UGBH52amYOTmJDII54DTvkJMQHIStV9+Q76tWq3z5rCwZAaIiKHxF06PEXLHAkYnXS4ZbjY92sK 6okdC7sqBfDOf73EQYvHPqjmNOiEqTGIq15vv1Lh2qPdISU2qQCNLR1OyM78aEjaxSESE3647Qt 4d8New6QFq2Ch1RfsGiHWWA/ZVdjb3tTjGLtyMPxRXxRjxN+xp2WU1CEe57usU/F54PMHSM1Lm0 TD+/kvBkWU+0ymNlEla4IHiY9Jq7NgdITOQA80KYbLxFeiZeDOVKc1pKAvd9np+ZplhTWBwBG/s dJdrL4gF2PDw2T X-Received: by 2002:a17:903:1a2b:b0:2c8:1f58:55dd with SMTP id d9443c01a7336-2ce9e79f35amr63957415ad.9.1783895405574; Sun, 12 Jul 2026 15:30:05 -0700 (PDT) Received: from kdev.. ([108.180.130.139]) by smtp.gmail.com with ESMTPSA id d9443c01a7336-2ccc9d3bc1fsm89048375ad.55.2026.07.12.15.30.04 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sun, 12 Jul 2026 15:30:05 -0700 (PDT) From: Babanpreet Singh To: Jonathan Cameron Cc: David Lechner , =?UTF-8?q?Nuno=20S=C3=A1?= , Andy Shevchenko , Greg Kroah-Hartman , linux-iio@vger.kernel.org, linux-staging@lists.linux.dev, linux-kernel@vger.kernel.org, Babanpreet Singh Subject: [PATCH] staging: iio: frequency: remove incorrect kernel-doc markings in dds.h Date: Sun, 12 Jul 2026 22:30:04 +0000 Message-ID: <20260712223004.7-1-bbnpreetsingh@gmail.com> X-Mailer: git-send-email 2.47.3 Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: 8bit The 13 comment blocks in dds.h noting which sysfs attribute each convenience macro creates are opened with the kernel-doc /** marker, but they are not kernel-doc: there is no identifier to document. Running kernel-doc on the file emits 103 warnings: $ scripts/kernel-doc -none drivers/staging/iio/frequency/dds.h Warning: drivers/staging/iio/frequency/dds.h:10 Cannot find identifier on line: * /sys/bus/iio/devices/.../out_altvoltageX_frequencyY The header is not scanned during normal builds (build-time kernel-doc checks cover .c files), so the warnings only show up when kernel-doc is invoked on the file directly. The comments have carried the /** marker since the file was introduced in commit 4851d97d87c8 ("Staging: IIO: dds.h convenience macros"). The attributes themselves are already documented in drivers/staging/iio/Documentation/sysfs-bus-iio-dds, so demote the comments to plain /* style rather than converting them into kernel-doc for the macros. No functional change. Assisted-by: Claude:claude-sonnet-5 Signed-off-by: Babanpreet Singh --- drivers/staging/iio/frequency/dds.h | 26 +++++++++++++------------- 1 file changed, 13 insertions(+), 13 deletions(-) diff --git a/drivers/staging/iio/frequency/dds.h b/drivers/staging/iio/frequency/dds.h index b2ca8bb971e8..d5f0139b79f0 100644 --- a/drivers/staging/iio/frequency/dds.h +++ b/drivers/staging/iio/frequency/dds.h @@ -7,7 +7,7 @@ #ifndef IIO_DDS_H_ #define IIO_DDS_H_ -/** +/* * /sys/bus/iio/devices/.../out_altvoltageX_frequencyY */ @@ -15,14 +15,14 @@ IIO_DEVICE_ATTR(out_altvoltage##_channel##_frequency##_num, \ _mode, _show, _store, _addr) -/** +/* * /sys/bus/iio/devices/.../out_altvoltageX_frequencyY_scale */ #define IIO_CONST_ATTR_FREQ_SCALE(_channel, _string) \ IIO_CONST_ATTR(out_altvoltage##_channel##_frequency_scale, _string) -/** +/* * /sys/bus/iio/devices/.../out_altvoltageX_frequencysymbol */ @@ -30,7 +30,7 @@ IIO_DEVICE_ATTR(out_altvoltage##_channel##_frequencysymbol, \ _mode, _show, _store, _addr) -/** +/* * /sys/bus/iio/devices/.../out_altvoltageX_phaseY */ @@ -38,14 +38,14 @@ IIO_DEVICE_ATTR(out_altvoltage##_channel##_phase##_num, \ _mode, _show, _store, _addr) -/** +/* * /sys/bus/iio/devices/.../out_altvoltageX_phaseY_scale */ #define IIO_CONST_ATTR_PHASE_SCALE(_channel, _string) \ IIO_CONST_ATTR(out_altvoltage##_channel##_phase_scale, _string) -/** +/* * /sys/bus/iio/devices/.../out_altvoltageX_phasesymbol */ @@ -53,7 +53,7 @@ IIO_DEVICE_ATTR(out_altvoltage##_channel##_phasesymbol, \ _mode, _show, _store, _addr) -/** +/* * /sys/bus/iio/devices/.../out_altvoltageX_pincontrol_en */ @@ -61,7 +61,7 @@ IIO_DEVICE_ATTR(out_altvoltage##_channel##_pincontrol_en, \ _mode, _show, _store, _addr) -/** +/* * /sys/bus/iio/devices/.../out_altvoltageX_pincontrol_frequency_en */ @@ -69,7 +69,7 @@ IIO_DEVICE_ATTR(out_altvoltage##_channel##_pincontrol_frequency_en,\ _mode, _show, _store, _addr) -/** +/* * /sys/bus/iio/devices/.../out_altvoltageX_pincontrol_phase_en */ @@ -77,7 +77,7 @@ IIO_DEVICE_ATTR(out_altvoltage##_channel##_pincontrol_phase_en, \ _mode, _show, _store, _addr) -/** +/* * /sys/bus/iio/devices/.../out_altvoltageX_out_enable */ @@ -85,7 +85,7 @@ IIO_DEVICE_ATTR(out_altvoltage##_channel##_out_enable, \ _mode, _show, _store, _addr) -/** +/* * /sys/bus/iio/devices/.../out_altvoltageX_outY_enable */ @@ -94,7 +94,7 @@ IIO_DEVICE_ATTR(out_altvoltage##_channel##_out##_output##_enable,\ _mode, _show, _store, _addr) -/** +/* * /sys/bus/iio/devices/.../out_altvoltageX_outY_wavetype */ @@ -102,7 +102,7 @@ IIO_DEVICE_ATTR(out_altvoltage##_channel##_out##_output##_wavetype,\ _mode, NULL, _store, _addr) -/** +/* * /sys/bus/iio/devices/.../out_altvoltageX_outY_wavetype_available */ base-commit: 2e2f2de7532cbbc2269de8be20ec709606c6e79b -- 2.43.0