From patchwork Fri Feb 17 18:53:26 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Andy Shevchenko X-Patchwork-Id: 58749 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:adf:eb09:0:0:0:0:0 with SMTP id s9csp13158wrn; Fri, 17 Feb 2023 10:54:53 -0800 (PST) X-Google-Smtp-Source: AK7set+iyHx5nZ2zV8ZvqnM0XrlsP/UcL4YXW3tnrS4k9P1Ki6mLB5hquOPByDEAg9R3eraN6aAV X-Received: by 2002:a17:903:1251:b0:196:8d33:f083 with SMTP id u17-20020a170903125100b001968d33f083mr6302773plh.28.1676660092649; Fri, 17 Feb 2023 10:54:52 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1676660092; cv=none; d=google.com; s=arc-20160816; b=mPw/dQFtGejsALOxdiHhOYxlo1JH0Wh3kFM1zlxccinc8VG+ZDrHXoTF8MHlYlhsK6 MkWsXvbVd/sS2l25yeClYdHgoYrQxDPHAGkRbErKeWQCaRWxoMxrWMuDK2eZz/fxiQOJ H+PtvejAJhIPT/kN4zbawUKtbBPXTO6skC9rB2WOuoVTXEVSX8N0bGP4p1xqPVEYiF2J 9XnP8cmX4udjPB4yotWXx0BqW6yuBT2korNtvzgsMldU8c/Y1PraySpe4KbDcF+HangD BrmczetpknarWuXjTXXu/kU8tsum/IDFVimEQfjYrn1ehPhJ3HK+ueFIT4NaYe6ILJ+t XEWA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :message-id:date:subject:cc:to:from:dkim-signature; bh=qpBxRdwG+Mbqarw1K0dbj6YZY7U/zj7WRjArorcv3vg=; b=RrtXazZoj39+voJtRNQh0+oDok75I3ZwEsf2MDtbAzphK/kHN+l8Amm2kQbonCC6Qm Kc6Xk4JN8zWX2nj5LQnJfadozwShF0mq5n0ssAi3ut2yNf6Qik1HYxrnptzXHRmXHGPq Q1vT34EfyOpcwzL2aglj9WM6nH2MyBTxz48+HxSciu/Cuox1JteXlov517clGM/wWdtY EXT1/frswBNrvIiaXSYpDf+yAqzMMBib6OnugN+izD8KBrwCjeC2v6iAuZ1Y9FIPJNhG Mc7l1DP4tK5Q7Aib4kCmQWkEF82uXL+MngDoHKbd9FFmGoXJ8lUIp+6oZA0q0pdSb2PI CzsA== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@intel.com header.s=Intel header.b=Tdvmt9qh; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=intel.com Received: from out1.vger.email (out1.vger.email. [2620:137:e000::1:20]) by mx.google.com with ESMTP id l193-20020a6391ca000000b004fbc6ff65efsi5167671pge.724.2023.02.17.10.54.38; Fri, 17 Feb 2023 10:54:52 -0800 (PST) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) client-ip=2620:137:e000::1:20; Authentication-Results: mx.google.com; dkim=pass header.i=@intel.com header.s=Intel header.b=Tdvmt9qh; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=intel.com Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S229595AbjBQSwv (ORCPT + 99 others); Fri, 17 Feb 2023 13:52:51 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:51594 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229506AbjBQSwu (ORCPT ); Fri, 17 Feb 2023 13:52:50 -0500 Received: from mga04.intel.com (mga04.intel.com [192.55.52.120]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 673312D64 for ; Fri, 17 Feb 2023 10:52:48 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=intel.com; i=@intel.com; q=dns/txt; s=Intel; t=1676659968; x=1708195968; h=from:to:cc:subject:date:message-id:mime-version: content-transfer-encoding; bh=qWdXU8+AY5bvvKgSyD0R0V06MxM7iYNdZ+POrljfklg=; b=Tdvmt9qhN/8ykGqX1s205FJ/IhLyGekC4WqZI20nWgsf1ax/jKk5lTlx nqyCCdF85dmS42ZG8UXBgQvKSskY6eBDYZUtzuUJZOQCWOiZzbdHOVPwc k6vQGj9Ipy4keimsMLf1/cmFkZN6dJ79bP0P8XhCbfwGWRsvq2O4RQxMQ JjxflXwQ0D4afpALjNyUtDPT1YmuQC+2G9b73OZhBxcripY3molvLVgjQ lLCZTw2Kw2gJDBr4ItvQcHJyzbb+FEETNaiNs6TqvVY2Is4lvCtbBDRyh qyxpyZwBrFN8/gExmT704PtLrEzigu/2bqLFA//Bv2F4j+YxyqrJgYXjC g==; X-IronPort-AV: E=McAfee;i="6500,9779,10624"; a="330725611" X-IronPort-AV: E=Sophos;i="5.97,306,1669104000"; d="scan'208";a="330725611" Received: from fmsmga003.fm.intel.com ([10.253.24.29]) by fmsmga104.fm.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 17 Feb 2023 10:52:48 -0800 X-ExtLoop1: 1 X-IronPort-AV: E=McAfee;i="6500,9779,10624"; a="759472538" X-IronPort-AV: E=Sophos;i="5.97,306,1669104000"; d="scan'208";a="759472538" Received: from black.fi.intel.com ([10.237.72.28]) by FMSMGA003.fm.intel.com with ESMTP; 17 Feb 2023 10:52:46 -0800 Received: by black.fi.intel.com (Postfix, from userid 1003) id 769481A6; Fri, 17 Feb 2023 20:53:27 +0200 (EET) From: Andy Shevchenko To: Mark Brown , Aidan MacDonald , linux-kernel@vger.kernel.org Cc: Andy Shevchenko Subject: [PATCH v1 1/1] regmap-irq: Place kernel doc of struct regmap_irq_chip in order Date: Fri, 17 Feb 2023 20:53:26 +0200 Message-Id: <20230217185326.23490-1-andriy.shevchenko@linux.intel.com> X-Mailer: git-send-email 2.39.1 MIME-Version: 1.0 X-Spam-Status: No, score=-4.3 required=5.0 tests=BAYES_00,DKIMWL_WL_HIGH, DKIM_SIGNED,DKIM_VALID,DKIM_VALID_EF,RCVD_IN_DNSWL_MED,SPF_HELO_NONE, SPF_NONE autolearn=ham autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on lindbergh.monkeyblade.net Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org X-getmail-retrieved-from-mailbox: =?utf-8?q?INBOX?= X-GMAIL-THRID: =?utf-8?q?1758105533293841929?= X-GMAIL-MSGID: =?utf-8?q?1758105533293841929?= It seems that a couple of members got lost theirorder, put them back. Besides that, split field descriptions into groups in the same way as it's done in the structure definition. Signed-off-by: Andy Shevchenko --- include/linux/regmap.h | 11 +++++++---- 1 file changed, 7 insertions(+), 4 deletions(-) diff --git a/include/linux/regmap.h b/include/linux/regmap.h index f26432dc02ef..853d98e0c74d 100644 --- a/include/linux/regmap.h +++ b/include/linux/regmap.h @@ -1554,6 +1554,7 @@ struct regmap_irq_chip_data; * @use_ack: Use @ack register even if it is zero. * @ack_invert: Inverted ack register: cleared bits for ack. * @clear_ack: Use this to set 1 and 0 or vice-versa to clear interrupts. + * @status_invert: Inverted status register: cleared bits are active interrupts. * @wake_invert: Inverted wake register: cleared bits are wake enabled. * @type_invert: Invert the type flags. Deprecated, use config registers * instead. @@ -1565,18 +1566,19 @@ struct regmap_irq_chip_data; * @clear_on_unmask: For chips with interrupts cleared on read: read the status * registers before unmasking interrupts to clear any bits * set when they were masked. + * @runtime_pm: Hold a runtime PM lock on the device when accessing it. * @not_fixed_stride: Used when chip peripherals are not laid out with fixed * stride. Must be used with sub_reg_offsets containing the * offsets to each peripheral. Deprecated; the same thing * can be accomplished with a @get_irq_reg callback, without * the need for a @sub_reg_offsets table. - * @status_invert: Inverted status register: cleared bits are active interrupts. - * @runtime_pm: Hold a runtime PM lock on the device when accessing it. * * @num_regs: Number of registers in each control bank. + * * @irqs: Descriptors for individual IRQs. Interrupt numbers are * assigned based on the index in the array of the interrupt. * @num_irqs: Number of descriptors. + * * @num_type_reg: Number of type registers. Deprecated, use config registers * instead. * @num_virt_regs: Number of non-standard irq configuration registers. @@ -1584,6 +1586,7 @@ struct regmap_irq_chip_data; * instead. * @num_config_bases: Number of config base registers. * @num_config_regs: Number of config registers for each config base register. + * * @handle_pre_irq: Driver specific callback to handle interrupt from device * before regmap_irq_handler process the interrupts. * @handle_post_irq: Driver specific callback to handle interrupt from device @@ -1631,13 +1634,13 @@ struct regmap_irq_chip { unsigned int use_ack:1; unsigned int ack_invert:1; unsigned int clear_ack:1; + unsigned int status_invert:1; unsigned int wake_invert:1; - unsigned int runtime_pm:1; unsigned int type_invert:1; unsigned int type_in_mask:1; unsigned int clear_on_unmask:1; + unsigned int runtime_pm:1; unsigned int not_fixed_stride:1; - unsigned int status_invert:1; int num_regs;