From patchwork Fri Jun 26 06:57:33 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Lee Jones X-Patchwork-Id: 11627035 Return-Path: Received: from mail.kernel.org (pdx-korg-mail-1.web.codeaurora.org [172.30.200.123]) by pdx-korg-patchwork-2.web.codeaurora.org (Postfix) with ESMTP id 6D9256C1 for ; Fri, 26 Jun 2020 10:09:40 +0000 (UTC) Received: from merlin.infradead.org (merlin.infradead.org [205.233.59.134]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.kernel.org (Postfix) with ESMTPS id 41821206C0 for ; Fri, 26 Jun 2020 10:09:40 +0000 (UTC) Authentication-Results: mail.kernel.org; dkim=pass (2048-bit key) header.d=lists.infradead.org header.i=@lists.infradead.org header.b="nlwih2VJ"; dkim=fail reason="signature verification failed" (2048-bit key) header.d=infradead.org header.i=@infradead.org header.b="iSjtc1BZ"; dkim=fail reason="signature verification failed" (2048-bit key) header.d=linaro.org header.i=@linaro.org header.b="oMN+5SES" DMARC-Filter: OpenDMARC Filter v1.3.2 mail.kernel.org 41821206C0 Authentication-Results: mail.kernel.org; dmarc=fail (p=none dis=none) header.from=linaro.org Authentication-Results: mail.kernel.org; spf=none smtp.mailfrom=linux-arm-kernel-bounces+patchwork-linux-arm=patchwork.kernel.org@lists.infradead.org DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=lists.infradead.org; s=merlin.20170209; h=Sender:Content-Transfer-Encoding: Content-Type:Cc:List-Subscribe:List-Help:List-Post:List-Archive: List-Unsubscribe:List-Id:MIME-Version:References:In-Reply-To:Message-Id:Date: Subject:To:From:Reply-To:Content-ID:Content-Description:Resent-Date: Resent-From:Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID:List-Owner; bh=g1bN4omL93gi+KA4OYivC1oTPJaf8YGbqWrCKvxkThM=; b=nlwih2VJamonVj8FjwyiIMKP5 RZ9oTwqA9+7SsgQ+EWZ8Bv6nrudz4jbdN4M4jF/tqF9QgC6XN5GOQR1fcbuuJqfal+5S4OGhP2l20 1d4c6zFbDpzCDVj7i0/gZDxjCaxGHoHmGTwzLZcFXnUDpGmPHH57RnZkbA1ni3q1FR88a5h1l57Bo XN5Qx1WR/FrMM/SP3VBl6P329nc1AyXMTi4UFHAr0pMZNkBEa0tzzs0Ar2vozVl24ijlj+smdsEgT vWNkZsiY4FdMUvGghff2ttojFUTyv63tF2E2iIXpmg3eJ9bNze5eC8KWj0VOS7kFWWMGRcQH8AsGv jpH940VSA==; Received: from localhost ([::1] helo=merlin.infradead.org) by merlin.infradead.org with esmtp (Exim 4.92.3 #3 (Red Hat Linux)) id 1jolGn-0002AY-Qn; Fri, 26 Jun 2020 10:07:42 +0000 Received: from casper.infradead.org ([90.155.50.34]) by merlin.infradead.org with esmtps (Exim 4.92.3 #3 (Red Hat Linux)) id 1jolDV-0000bm-7Y for linux-arm-kernel@merlin.infradead.org; Fri, 26 Jun 2020 10:04:17 +0000 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=infradead.org; s=casper.20170209; h=Content-Transfer-Encoding:MIME-Version: References:In-Reply-To:Message-Id:Date:Subject:Cc:To:From:Sender:Reply-To: Content-Type:Content-ID:Content-Description; bh=y9hN7NO0rdQRJARX8qa7eYKYz3O3kVESkS3PoJ7SKiY=; b=iSjtc1BZgTKdqbfVuMrzS0dcif JJG0G3MwQ67+0Cb/zNqE3oo9gWM4/mKXVdVaBwYS6d+Q0mw5dWJ4qhxl6NCyNQvXEygOyLSEaWAeA /2AYfRc48dD5kSoPXBBuMfG2kZiMbUchnKdK6SKX1qqKtOXmLqrpwxZ/5g1bsqmDPDCE7t2GtVcSY f1eE1igtqGc3+l9vT2BYj6x8PAwtVqWf41b5N0Kxyl0yNyJlN0X6Wflmn8ayb04EZ9Uip18vX4zAY MF8qgp4ckwK0fp4zDoeBAslNfmJGygI7TQM1WaMUr4YCvlAYN0o0X3cPw5W50Yj1OE/w+Su1d3OXm ajlwc22g==; Received: from mail-ej1-x641.google.com ([2a00:1450:4864:20::641]) by casper.infradead.org with esmtps (Exim 4.92.3 #3 (Red Hat Linux)) id 1jolBW-0003uN-3i for linux-arm-kernel@lists.infradead.org; Fri, 26 Jun 2020 10:02:30 +0000 Received: by mail-ej1-x641.google.com with SMTP id i14so8774846ejr.9 for ; Fri, 26 Jun 2020 03:02:13 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linaro.org; s=google; h=from:to:cc:subject:date:message-id:in-reply-to:references :mime-version:content-transfer-encoding; bh=y9hN7NO0rdQRJARX8qa7eYKYz3O3kVESkS3PoJ7SKiY=; b=oMN+5SESRViJGi4oMdoYffiAIfTV0HTw712Nu4lIwJpvz3ph6VHskhTuPqAub7zRL1 BAHisNhPGZdpQe+zfCmznmkwfxUPe7KErp4/mTy+EGkED1oAvKKb4P7Yilw1CkWtsmr4 pyanrIHcJ/dwK+IBBHBKGdCgFPOr46YkenbRq+nAdBC74VVOJINtEEVCGRI9yNxx4WDy Ubr1PSc7g8MlWhEYIkfNBKICDjb7tVLvgQDVz57Vs6VvhNJ1nojyIXvKv2ZbAa2wu1Bu L+p17Rtqd4X1tEwjktgKojLmmbeKxn21eBdfeZensHH0xSrtfQdEQ4C4aKJ8NavBdcji hAHw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references:mime-version:content-transfer-encoding; bh=y9hN7NO0rdQRJARX8qa7eYKYz3O3kVESkS3PoJ7SKiY=; b=lvGzhNMnegAvnkiUmiP+FvN5mAO7sB89Uvs3Z4oE4w6/5GQG2F6Jm12ObSzmXPkr4R VpLaFZEWQQaizw7zOTv344MrlP8ixVRo+DUGe1p8Sh+eqB0MFs4Wm7LU21B9GlYXhVy9 NEJuy7SFE6+i8bTYpIoINVTHcTVjVlOdUb9PatzsZpYImI0LiJc2gYxulpG1iOyl4nGj eKTzdP9YNddpjW6L8VwkGpvBXxELOIzY9YMjYOFTWnMc8KKXsmSbrS5yqHGCGNlBsVdx 04UOEO630j2kSsZjRIDA5biHL9SPWBDOfdHhfrTIGSQjZ8Oh1l3FWfndRcLjlVCj/jtJ EXog== X-Gm-Message-State: AOAM531ZjcDHp5XfTuOWjQBphMYym84JUA3GN/noIqilcqGzm8OsL7Fv cFkjUhLJc9/nzSUwJRV8YEhC/H/OsxU= X-Google-Smtp-Source: ABdhPJzCrrAiKXmS/P3/z8bW+Zozzihsle1ZeNtAdmBePwrKgRx2OeGMoZCsXgJ2BWVeEnC+h/bs6A== X-Received: by 2002:adf:828b:: with SMTP id 11mr2309054wrc.58.1593154666455; Thu, 25 Jun 2020 23:57:46 -0700 (PDT) Received: from localhost.localdomain ([2.27.35.144]) by smtp.gmail.com with ESMTPSA id x18sm15355269wmi.35.2020.06.25.23.57.45 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 25 Jun 2020 23:57:45 -0700 (PDT) From: Lee Jones To: broonie@kernel.org, lgirdwood@gmail.com Subject: [PATCH 4/9] regulator: stpmic1_regulator: Properly document 'struct stpmic1_regulator_cfg' Date: Fri, 26 Jun 2020 07:57:33 +0100 Message-Id: <20200626065738.93412-5-lee.jones@linaro.org> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20200626065738.93412-1-lee.jones@linaro.org> References: <20200626065738.93412-1-lee.jones@linaro.org> MIME-Version: 1.0 X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20200626_110214_659908_64B9BFF0 X-CRM114-Status: GOOD ( 12.44 ) X-Spam-Score: -2.1 (--) X-Spam-Report: SpamAssassin version 3.4.4 on casper.infradead.org summary: Content analysis details: (-2.1 points, 5.0 required) pts rule name description ---- ---------------------- -------------------------------------------------- -0.0 RCVD_IN_DNSWL_NONE RBL: Sender listed at https://www.dnswl.org/, no trust [2a00:1450:4864:20:0:0:0:641 listed in] [list.dnswl.org] -1.9 BAYES_00 BODY: Bayes spam probability is 0 to 1% [score: 0.0000] -0.0 SPF_PASS SPF: sender matches SPF record 0.0 SPF_HELO_NONE SPF: HELO does not publish an SPF Record -0.1 DKIM_VALID Message has at least one valid DKIM or DK signature -0.1 DKIM_VALID_EF Message has a valid DKIM or DK signature from envelope-from domain -0.1 DKIM_VALID_AU Message has a valid DKIM or DK signature from author's domain 0.1 DKIM_SIGNED Message has a DKIM or DK signature, not necessarily valid X-BeenThere: linux-arm-kernel@lists.infradead.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: Pascal Paillet , Lee Jones , linux-kernel@vger.kernel.org, linux-arm-kernel@lists.infradead.org Sender: "linux-arm-kernel" Errors-To: linux-arm-kernel-bounces+patchwork-linux-arm=patchwork.kernel.org@lists.infradead.org In kerneldoc format, data structures have to start with 'struct' else the kerneldoc tooling/parsers/validators get confused. Fixes the following W=1 kernel build warning: drivers/regulator/stpmic1_regulator.c:25: warning: cannot understand function prototype: 'struct stpmic1_regulator_cfg ' Cc: Pascal Paillet Signed-off-by: Lee Jones --- drivers/regulator/stpmic1_regulator.c | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/drivers/regulator/stpmic1_regulator.c b/drivers/regulator/stpmic1_regulator.c index adc9973d1b2f7..73e0ab2baeaa6 100644 --- a/drivers/regulator/stpmic1_regulator.c +++ b/drivers/regulator/stpmic1_regulator.c @@ -15,7 +15,7 @@ #include /** - * stpmic1 regulator description: this structure is used as driver data + * struct stpmic1 regulator description: this structure is used as driver data * @desc: regulator framework description * @mask_reset_reg: mask reset register address * @mask_reset_mask: mask rank and mask reset register mask