From patchwork Mon Feb 13 07:03:24 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Randy Dunlap X-Patchwork-Id: 56057 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:adf:eb09:0:0:0:0:0 with SMTP id s9csp2210742wrn; Sun, 12 Feb 2023 23:08:59 -0800 (PST) X-Google-Smtp-Source: AK7set9xybGcSGdgLtzYciKat8QYPXAw4tFmyI8bAoSRMKmWZtCFQSPJQ5AkRu3iCQCge0pltWit X-Received: by 2002:a17:907:d08c:b0:8a9:e031:c4b7 with SMTP id vc12-20020a170907d08c00b008a9e031c4b7mr21407711ejc.4.1676272139234; Sun, 12 Feb 2023 23:08:59 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1676272139; cv=none; d=google.com; s=arc-20160816; b=1LRNm8Zp5qYmahZ3EQVgGPTILdtkqcL19QF8ji67j79lmE6ayENnX25O3PCMSVL6jT AnQrqgMTu/heoSAmadJTwFjzKK0x75Fc1BmBvTYuqriGhz87tzjCvTP352HxJ4FeBOce fIPJi0n2L5SizxGfPGlw23tDl2FrGKyQ7STqhU5C2wm8FkvG4CUIWEqE5Vr5w2bAyW+G 5Dqn48CG1OWglgoGmoVxjbIzRkIenWJiekpNpDdftuINiGL3heArjYkBZ7q9+la29pZw ccZgeA2H3pBuum5iR7BOX+RHQwRSq85XrYBds4+DS2ookvL2dAdvvgNzLqdacvwKLysT JF9A== 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=CAMl6bbB4VBhku/eCWB/73USL/Lw7fBbnEebQaGO7JI=; b=mjRM7NavySv2Bpk/eQQg9qOmMkvA6CfuX2hn+zoQo2OJKHGGJDuU7AK0KYCVreoN6+ TAeZpIW0E0HNJgbebSaAO7uPYlVd3TtMxxvFlAruTJ3FvD6yBOSja44mEo1qD/slo0Xv MjGMKNz/R2MvoNOtkbEUo/DRLrQEVprnHbw1KkN9vMR6cLrgaFcHXxOQRCDbUGbGZT/1 2Umadq4eu7a7sXwsSFYgL7LluSnCODwrPSxJbuJf1p/GPOlHkV1F9URLGsn7qWye476y TGruW/Z3Z0C/llm7x80tuaxpS2jAjcgpzCUM/gd6dglz9wqxMnEIFxEqTjSsENt+Nw9f pnPg== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@infradead.org header.s=bombadil.20210309 header.b=VfDbAeWo; 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 Received: from out1.vger.email (out1.vger.email. [2620:137:e000::1:20]) by mx.google.com with ESMTP id p12-20020a170907910c00b0088f88d1d352si11361404ejq.202.2023.02.12.23.08.35; Sun, 12 Feb 2023 23:08:59 -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=@infradead.org header.s=bombadil.20210309 header.b=VfDbAeWo; 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 Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S229712AbjBMHD3 (ORCPT + 99 others); Mon, 13 Feb 2023 02:03:29 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:50848 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229468AbjBMHD1 (ORCPT ); Mon, 13 Feb 2023 02:03:27 -0500 Received: from bombadil.infradead.org (bombadil.infradead.org [IPv6:2607:7c80:54:3::133]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 13F71BDF8 for ; Sun, 12 Feb 2023 23:03:27 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=infradead.org; s=bombadil.20210309; h=Content-Transfer-Encoding: MIME-Version:Message-Id:Date:Subject:Cc:To:From:Sender:Reply-To:Content-Type: Content-ID:Content-Description:In-Reply-To:References; bh=CAMl6bbB4VBhku/eCWB/73USL/Lw7fBbnEebQaGO7JI=; b=VfDbAeWoe5xctNA++Tc2HaNUer FuoNeuqYfG4Vmo/E7G4pbVa+sDQYBkM7aaxFFjdcdzynWmdPOXoezgBvkQ+On+pguoeBG1WeEnpOl o9R+kzwyoN7t2pv1Om6UrFTlnTftz4rOOfvmuZ9yuriOpPbCCd6wACMdE8njolPzcWBek2+85cX+f eu5mRyMioEsfW+mLrN5WJBsXsrbBRzqYhp+/VtRN9Wi+DcDrkQ5Rtjmvvag3N/rIxDStG9GJfGlTL SpUtzx0th4TCOv8ptSvCmLbGDtahZrdA7UVSZ5b+IQz1Q2DrYR9L6fV/JVLBZl0JDiU8B8P+NfYH9 OtVwWydQ==; Received: from [2601:1c2:980:9ec0::df2f] (helo=bombadil.infradead.org) by bombadil.infradead.org with esmtpsa (Exim 4.94.2 #2 (Red Hat Linux)) id 1pRSs1-00DP1S-6k; Mon, 13 Feb 2023 07:03:25 +0000 From: Randy Dunlap To: linux-kernel@vger.kernel.org Cc: Randy Dunlap , Boris Brezillon , Greg Kroah-Hartman , Alexandre Belloni , linux-i3c@lists.infradead.org Subject: [PATCH -next] i3c: fix device.h kernel-doc warnings Date: Sun, 12 Feb 2023 23:03:24 -0800 Message-Id: <20230213070324.1564-1-rdunlap@infradead.org> X-Mailer: git-send-email 2.39.1 MIME-Version: 1.0 X-Spam-Status: No, score=-4.4 required=5.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,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?1757698734422708294?= X-GMAIL-MSGID: =?utf-8?q?1757698734422708294?= Fix all kernel-doc warnings in : include/linux/i3c/device.h:27: warning: contents before sections include/linux/i3c/device.h:196: warning: Excess function parameter 'dev' description in 'dev_to_i3cdev' Fixes: fa838c8ce537 ("i3c: move dev_to_i3cdev() to use container_of_const()") Fixes: 3a379bbcea0a ("i3c: Add core I3C infrastructure") Signed-off-by: Randy Dunlap Cc: Boris Brezillon Cc: Greg Kroah-Hartman Cc: Alexandre Belloni Cc: linux-i3c@lists.infradead.org --- include/linux/i3c/device.h | 13 +++++++------ 1 file changed, 7 insertions(+), 6 deletions(-) diff -- a/include/linux/i3c/device.h b/include/linux/i3c/device.h --- a/include/linux/i3c/device.h +++ b/include/linux/i3c/device.h @@ -18,17 +18,18 @@ /** * enum i3c_error_code - I3C error codes * + * @I3C_ERROR_UNKNOWN: unknown error, usually means the error is not I3C + * related + * @I3C_ERROR_M0: M0 error + * @I3C_ERROR_M1: M1 error + * @I3C_ERROR_M2: M2 error + * * These are the standard error codes as defined by the I3C specification. * When -EIO is returned by the i3c_device_do_priv_xfers() or * i3c_device_send_hdr_cmds() one can check the error code in * &struct_i3c_priv_xfer.err or &struct i3c_hdr_cmd.err to get a better idea of * what went wrong. * - * @I3C_ERROR_UNKNOWN: unknown error, usually means the error is not I3C - * related - * @I3C_ERROR_M0: M0 error - * @I3C_ERROR_M1: M1 error - * @I3C_ERROR_M2: M2 error */ enum i3c_error_code { I3C_ERROR_UNKNOWN = 0, @@ -189,7 +190,7 @@ struct device *i3cdev_to_dev(struct i3c_ /** * dev_to_i3cdev() - Returns the I3C device containing @dev - * @dev: device object + * @__dev: device object * * Return: a pointer to an I3C device object. */