Received: by 2002:a05:7208:20d2:b0:82:bbfa:f723 with SMTP id z18csp38235rbz; Tue, 7 May 2024 09:54:10 -0700 (PDT) X-Forwarded-Encrypted: i=3; AJvYcCUdQ5I6p7HnXT1fo2R1XENeYu5IPwY9CSfisjwk7flpcE1OyINcqfkZ2cr+3DK2BRmNcI1+/kZbuML+Wy8UdcZqStBTsHljEf6gCLBTqw== X-Google-Smtp-Source: AGHT+IFhxwo5JNM/QoGxnCNxOnaQ7MrdOoBLcselAM7rprHO1WGpYVJxezXW6jgz/PnH6l0ma5hP X-Received: by 2002:a05:620a:100e:b0:790:9817:309d with SMTP id af79cd13be357-792b24800c5mr54158785a.9.1715100849831; Tue, 07 May 2024 09:54:09 -0700 (PDT) ARC-Seal: i=2; a=rsa-sha256; t=1715100849; cv=pass; d=google.com; s=arc-20160816; b=ctwAALJTAlzKkjE7TVwtr8U9XIXw+Mfgqcfo9gmBLJ/8ccSWQeFvCmwoKjxXGNl2mq dSxb1/r2mK5cP2MdimdC2IZttlPpy/8BcmmUE64Uc9JDj3wUBajL17/MfNt9LiXrm+vi CvSEkvX+Zv+sQPGmkWyI+z5W4UIP7s9BYChICVPWVdmPFOBKnG57XEib0AcCozr8E27O oe6r9IqhR5LLmcu2aVYYvki7PBdLhTYVAcPJDvhJiJ3FHOT5vwNPvuueFn34WhwDrsmt i17TLaDUKu9794Y3eZjSujkahltSLaUIEpgc8ITpDoXjYK7/UR9u5ojsAu/smuKScLCI 6flQ== ARC-Message-Signature: i=2; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=cc:to:message-id:content-transfer-encoding:mime-version :list-unsubscribe:list-subscribe:list-id:precedence:subject:date :from:dkim-signature; bh=rj2hrVncl777xEeIIYsyi0O4tpS+y0ABrwy5SSclyG8=; fh=CTaLi84bbCCu0dZoVMq01fQdbp3evX0ZeU7C6O+IR0g=; b=AYhgBhpnT27Dde2PCpHDzJFxTQNKkWtii/qLHf9SMsKHJKGDHYpMndbV8saRz2tc4c qu1XW0PbKjbAJLPbfPvTmlFoC13vfUQINWavnpKTErsU1A8V0N5/oav1mByaRA1v618/ ndafIFAl4ZVeYfC0ocGW59nTm9gCunH8AX90MMXiPRBXJm1J5o5MfTfTxyyMXjjRC1VM V5mlMPxzhcmsiPdSwi4qVMZweWsHZCrX8j8bm+l2rzLEkR2YdxvEVL4CN6OlBa/3zzc7 vJ99Hb2LJP2ebUL5yAAmmVjhWGGHB8QD4xbQTIvMp7TwKnrdA72cXrk1ahx6DdXixa/m Opvw==; dara=google.com ARC-Authentication-Results: i=2; mx.google.com; dkim=pass header.i=@kernel.org header.s=k20201202 header.b=QoUqMrT8; arc=pass (i=1 dkim=pass dkdomain=kernel.org); spf=pass (google.com: domain of linux-kernel+bounces-171879-linux.lists.archive=gmail.com@vger.kernel.org designates 147.75.199.223 as permitted sender) smtp.mailfrom="linux-kernel+bounces-171879-linux.lists.archive=gmail.com@vger.kernel.org"; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=kernel.org Return-Path: Received: from ny.mirrors.kernel.org (ny.mirrors.kernel.org. [147.75.199.223]) by mx.google.com with ESMTPS id n6-20020a05620a294600b007928afb3f3bsi7833164qkp.407.2024.05.07.09.54.09 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 07 May 2024 09:54:09 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel+bounces-171879-linux.lists.archive=gmail.com@vger.kernel.org designates 147.75.199.223 as permitted sender) client-ip=147.75.199.223; Authentication-Results: mx.google.com; dkim=pass header.i=@kernel.org header.s=k20201202 header.b=QoUqMrT8; arc=pass (i=1 dkim=pass dkdomain=kernel.org); spf=pass (google.com: domain of linux-kernel+bounces-171879-linux.lists.archive=gmail.com@vger.kernel.org designates 147.75.199.223 as permitted sender) smtp.mailfrom="linux-kernel+bounces-171879-linux.lists.archive=gmail.com@vger.kernel.org"; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=kernel.org Received: from smtp.subspace.kernel.org (wormhole.subspace.kernel.org [52.25.139.140]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ny.mirrors.kernel.org (Postfix) with ESMTPS id 8DDDE1C21065 for ; Tue, 7 May 2024 16:54:09 +0000 (UTC) Received: from localhost.localdomain (localhost.localdomain [127.0.0.1]) by smtp.subspace.kernel.org (Postfix) with ESMTP id A9EF6C148; Tue, 7 May 2024 16:54:02 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b="QoUqMrT8" Received: from smtp.kernel.org (aws-us-west-2-korg-mail-1.web.codeaurora.org [10.30.226.201]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id D691854BEA for ; Tue, 7 May 2024 16:54:01 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=10.30.226.201 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1715100841; cv=none; b=YVoJ9dTqfQvtHS2finE+dfw42AQwcom/+5HIifRhq0nUeDrDsRKMx1lXGNLqgWGJE8etiX/CACkOToYUcVaMss2aQmaa8+cV0/raVAohHs6Fi0d/7n+MR3Zzw0NNZXBpb44CFnTBCW21phIl23v7APmoEdbBiFxJ2AnITeiA2jo= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1715100841; c=relaxed/simple; bh=eUXXlN5WmbzUqPc3MNXUPvyWjAsiVrCHuEnIwmmE8aA=; h=From:Date:Subject:MIME-Version:Content-Type:Message-Id:To:Cc; b=WfmUo02Dr9FYprhQaiFHAXDiwqzG8E00cA8T3ul522V/XBn7C3MDkgXk4Rx00HT7sgb1p181D1QD2apkA33Yx9okFoMyTyE6Y1dyKF4aL5suLqJT4rlJ/2pettYq/Y8WHyCsLy+KvHkaiGKkNbcsrqm46MAjzDDNKVpjAajpHmA= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=QoUqMrT8; arc=none smtp.client-ip=10.30.226.201 Received: by smtp.kernel.org (Postfix) with ESMTPSA id 326CBC2BBFC; Tue, 7 May 2024 16:54:00 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1715100841; bh=eUXXlN5WmbzUqPc3MNXUPvyWjAsiVrCHuEnIwmmE8aA=; h=From:Date:Subject:To:Cc:From; b=QoUqMrT81/7Exykpl+/tofkBTn+amyXCCotBtgwtwMQa+sN97AH7FlfCy+7gyeLKz nJB4XXJX1YPz+ZZ5rENu4LyeqQcO2Zw/OBOo4HMMfoJW5QzwSmlzXvpvQCZeE4OOtk dtfCtckwsoRKWQ5/o/e2eqqwzv0G0E0VV1Oad8qme+xsDzsJMf+YZLh47O/rqdJF90 GUXYIt1YUmlBqZFi1AlRu6fUULAuS/m04eC0ya7pKiwpFWBkYGFDE4B4pn8mq4//LX PyhUGjXPz1+tg4DBMQgv2WxJ32HRtW/Wm2v02unD7PODRIwq8LX1cQ9cR1o2ZMnoWB fNOows3B5WugQ== From: Simon Horman Date: Tue, 07 May 2024 17:53:56 +0100 Subject: [PATCH v2] mfd: idt8a340_reg: Start comments with '/*' Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: 7bit Message-Id: <20240507-clockmatrix-kernel-doc-v2-1-3138d74192dd@kernel.org> X-B4-Tracking: v=1; b=H4sIAKNcOmYC/4WNQQqDMBBFryKz7pQkKkpXvUdxEZOpDlojExGLe Pem9gBdvv/57+8QSZgi3LIdhFaOHKYE5pKB6+3UEbJPDEaZQpWqQDcGN7zsIrzhQDLRiD44rAp balfnvvQ1pPEs9OTtFD+axD3HJcj7/Fn1N/2rXDVqtK5Vlc3zttXV/Vdeg3TQHMfxAVa1nTK9A AAA To: Lee Jones Cc: linux-kernel@vger.kernel.org X-Mailer: b4 0.12.3 Several comments in idt8a340_reg.h start with '/**', which denotes the start of a Kernel doc, but are otherwise not Kernel docs. Resolve this conflict by starting these comments with '/*' instead. Flagged by ./scripts/kernel-doc -none Signed-off-by: Simon Horman --- Changes in v2: - As suggested by Lee Jones + Update patch prefix to "mfd: idt8a340_reg:" + Update line-wrapping in patch description - Link to v1: https://lore.kernel.org/r/20240504-clockmatrix-kernel-doc-v1-1-acb07a33bb17@kernel.org --- include/linux/mfd/idt8a340_reg.h | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/include/linux/mfd/idt8a340_reg.h b/include/linux/mfd/idt8a340_reg.h index 0c706085c205..53a222605526 100644 --- a/include/linux/mfd/idt8a340_reg.h +++ b/include/linux/mfd/idt8a340_reg.h @@ -61,7 +61,7 @@ #define HW_Q8_CTRL_SPARE (0xa7d4) #define HW_Q11_CTRL_SPARE (0xa7ec) -/** +/* * Select FOD5 as sync_trigger for Q8 divider. * Transition from logic zero to one * sets trigger to sync Q8 divider. @@ -70,7 +70,7 @@ */ #define Q9_TO_Q8_SYNC_TRIG BIT(1) -/** +/* * Enable FOD5 as driver for clock and sync for Q8 divider. * Enable fanout buffer for FOD5. * @@ -78,7 +78,7 @@ */ #define Q9_TO_Q8_FANOUT_AND_CLOCK_SYNC_ENABLE_MASK (BIT(0) | BIT(2)) -/** +/* * Select FOD6 as sync_trigger for Q11 divider. * Transition from logic zero to one * sets trigger to sync Q11 divider. @@ -87,7 +87,7 @@ */ #define Q10_TO_Q11_SYNC_TRIG BIT(1) -/** +/* * Enable FOD6 as driver for clock and sync for Q11 divider. * Enable fanout buffer for FOD6. *