From patchwork Thu May 20 19:00:58 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Lee Jones X-Patchwork-Id: 12271207 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-17.1 required=3.0 tests=BAYES_00,DKIMWL_WL_HIGH, DKIM_SIGNED,DKIM_VALID,HEADER_FROM_DIFFERENT_DOMAINS,INCLUDES_CR_TRAILER, INCLUDES_PATCH,MAILING_LIST_MULTI,SPF_HELO_NONE,SPF_PASS,USER_AGENT_GIT autolearn=ham autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id C0E64C433ED for ; Thu, 20 May 2021 19:05:08 +0000 (UTC) Received: from desiato.infradead.org (desiato.infradead.org [90.155.92.199]) (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 4C5A161244 for ; Thu, 20 May 2021 19:05:08 +0000 (UTC) DMARC-Filter: OpenDMARC Filter v1.3.2 mail.kernel.org 4C5A161244 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+linux-arm-kernel=archiver.kernel.org@lists.infradead.org DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=lists.infradead.org; s=desiato.20200630; h=Sender:Content-Transfer-Encoding :Content-Type:List-Subscribe:List-Help:List-Post:List-Archive: List-Unsubscribe:List-Id:MIME-Version:References:In-Reply-To:Message-Id:Date: Subject:Cc:To:From:Reply-To:Content-ID:Content-Description:Resent-Date: Resent-From:Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID:List-Owner; bh=GFbKO5yag5Cy/aqH11uCcGwVYFO6cHiALLjhzskUeRw=; b=biXe42S/ZO8HWygIdwKj8twjA+ Mw1KWCf/Pggr2Zz7923DcCyOGuRB90Okku969SWHvpTT+6w7IPhFg6B2y3wogblxDsKLF+t2cbi/S KRvz+zPdpN27GcFFlWqzXUZSETCa3HKZtKUAUI30f9Phq7oTLYxx2ZK+258VL+1HuXtDeM7PyIvdC C20D52V0r1XX92560maPEAMkAPDYGKW+anDBjWvm9dbpdZHoL+KFlPhD2CFsCKrLPva/xPFhXqcKt Y6J9ZYj+r/7ZAn4noeVWefCra50e9L8smNT3JZm02tNqZ8Z8PVqy/7td/ZkARM8NTgo3r/RwUOonN QqZaTV+A==; Received: from localhost ([::1] helo=desiato.infradead.org) by desiato.infradead.org with esmtp (Exim 4.94.2 #2 (Red Hat Linux)) id 1ljnwl-002P1w-BF; Thu, 20 May 2021 19:03:05 +0000 Received: from bombadil.infradead.org ([2607:7c80:54:e::133]) by desiato.infradead.org with esmtps (Exim 4.94.2 #2 (Red Hat Linux)) id 1ljnv9-002Ofa-6G for linux-arm-kernel@desiato.infradead.org; Thu, 20 May 2021 19:01:27 +0000 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:References:In-Reply-To:Message-Id:Date:Subject:Cc:To:From:Sender :Reply-To:Content-Type:Content-ID:Content-Description; bh=m3jb6hnBmFjxzdvzWu+uBOUpuYnuQHaJ3s27d7EHAaY=; b=dSqsfleOVQpFbg3gViG4NyNXDZ XO/4qnci1Mreao4ncTXbQswX7+Txkx2LWJc8Lev4dhybMB1/q015DlHh6eS8DyC492Wci0m6I1pyT BE2hauo2NNeygRgFrDQ/H0Ftw5ns/qU1OS9LTXLkZXfUeJkrxCWm4JvNRv+xE25fzA5yTcHdKvV5d zyM/WNt8ALR1T+2fg00rkqlrcW5uhe6EKcH+2hhnoOSvnMHx0UDtrMlpX6gi81hQlBOgZ6EWoeOPf 0jOIIDgkDwu1CAJadG2byxzOlZFV51OXnmmwJL3Dg72UFNhqOmwRmx0Io3rWJRecQwZpPBOwjOmYI swVuLTLw==; Received: from mail-wr1-x42b.google.com ([2a00:1450:4864:20::42b]) by bombadil.infradead.org with esmtps (Exim 4.94 #2 (Red Hat Linux)) id 1ljnv6-00Gapk-Mx for linux-arm-kernel@lists.infradead.org; Thu, 20 May 2021 19:01:22 +0000 Received: by mail-wr1-x42b.google.com with SMTP id n2so18797644wrm.0 for ; Thu, 20 May 2021 12:01:20 -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=m3jb6hnBmFjxzdvzWu+uBOUpuYnuQHaJ3s27d7EHAaY=; b=K970SYTqN8gULsm5HfoOieuvIDgrrm3n7CEDU2099SAFSAo7d709BIDDecLpOiecca bZROptfK6xiqhDFE+AO87zanxVe5HbR0SC5ObyMb4UZMiKMpfiYlJHffPshEvJgeA+UN V3XG2xCMAY2HTd6MtOFC16ArFARtEWzBocO+cq+CwiAOU6CTEJs7rBuAFIyihY62CbjH 4GRmjZudOmwIQlDL9LvdAis8UI15SzfhgiqM4giwkY+R0L5j/YzK6biBQRaHmV7XUPbc v1TzOIhh4JLz8HV4xmdmBClHHOHwjha1vcMTaeTfrBjxJ31sZoVXCFtmQ5bC7/JQyJxd Bm0g== 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=m3jb6hnBmFjxzdvzWu+uBOUpuYnuQHaJ3s27d7EHAaY=; b=Hq2GDJLW24uylqIJ2o9FiT/xrCxR3+xVbYBP+WNWXA9ygrBt4GX72qz4cIZ/hEX6vv 7bWeExPNs8iQJBvvXHn6z8ehdeW9Ijb43DqKoX3wtqdlcNPtJdjT2rhhYee+JzT85lVh 18WVmp8MlasrBJTtytrIu+k1/cOLLvd4Sq+CuaIjK7xTjIh1/18/7M/FFdNjmm1uyomc a+EukgUtSnTD56j/Zt9csOERN9siKPwhEJQ+tZr9SwtyAMq8rnLGaB6G6kg/JbEbHV0z 0pastxoYN3mc8g5S2q7pCzW4dY6jaigpEHLGqQ/R+CvK830UXjt/hrY6BGwfO4hg/oR6 f9Ww== X-Gm-Message-State: AOAM532j5aP5lblH80+9xtAEitac1MjxjcZ+4HSVzDZ8d4bysZjF6rtZ YEhCpdXhLu7FN85TX9XgN6L2PA== X-Google-Smtp-Source: ABdhPJzQbZvMN96PVkWjIm1fWkUezkxoP+TDMseNMoBt1l63hdRjK8sjh/sSLwnsw30zgcUDQhuUeQ== X-Received: by 2002:a5d:62c7:: with SMTP id o7mr5699770wrv.372.1621537279564; Thu, 20 May 2021 12:01:19 -0700 (PDT) Received: from dell.default ([91.110.221.215]) by smtp.gmail.com with ESMTPSA id p20sm9011899wmq.10.2021.05.20.12.01.18 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 20 May 2021 12:01:19 -0700 (PDT) From: Lee Jones To: lee.jones@linaro.org Cc: linux-kernel@vger.kernel.org, Shawn Guo , Sascha Hauer , Pengutronix Kernel Team , Fabio Estevam , NXP Linux Team , Wolfram Sang , Marek Vasut , linux-i2c@vger.kernel.org, linux-arm-kernel@lists.infradead.org Subject: [PATCH 09/16] i2c: busses: i2c-mxs: Demote barely half complete kernel-doc header Date: Thu, 20 May 2021 20:00:58 +0100 Message-Id: <20210520190105.3772683-10-lee.jones@linaro.org> X-Mailer: git-send-email 2.31.1 In-Reply-To: <20210520190105.3772683-1-lee.jones@linaro.org> References: <20210520190105.3772683-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-20210520_120120_765759_E0F3F682 X-CRM114-Status: GOOD ( 12.97 ) X-BeenThere: linux-arm-kernel@lists.infradead.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: "linux-arm-kernel" Errors-To: linux-arm-kernel-bounces+linux-arm-kernel=archiver.kernel.org@lists.infradead.org Fixes the following W=1 kernel build warning(s): drivers/i2c/busses/i2c-mxs.c:131: warning: Function parameter or member 'timing0' not described in 'mxs_i2c_dev' drivers/i2c/busses/i2c-mxs.c:131: warning: Function parameter or member 'timing1' not described in 'mxs_i2c_dev' drivers/i2c/busses/i2c-mxs.c:131: warning: Function parameter or member 'timing2' not described in 'mxs_i2c_dev' drivers/i2c/busses/i2c-mxs.c:131: warning: Function parameter or member 'dmach' not described in 'mxs_i2c_dev' drivers/i2c/busses/i2c-mxs.c:131: warning: Function parameter or member 'pio_data' not described in 'mxs_i2c_dev' drivers/i2c/busses/i2c-mxs.c:131: warning: Function parameter or member 'addr_data' not described in 'mxs_i2c_dev' drivers/i2c/busses/i2c-mxs.c:131: warning: Function parameter or member 'sg_io' not described in 'mxs_i2c_dev' drivers/i2c/busses/i2c-mxs.c:131: warning: Function parameter or member 'dma_read' not described in 'mxs_i2c_dev' Cc: Shawn Guo Cc: Sascha Hauer Cc: Pengutronix Kernel Team Cc: Fabio Estevam Cc: NXP Linux Team Cc: Wolfram Sang Cc: Marek Vasut Cc: linux-i2c@vger.kernel.org Cc: linux-arm-kernel@lists.infradead.org Signed-off-by: Lee Jones --- drivers/i2c/busses/i2c-mxs.c | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/drivers/i2c/busses/i2c-mxs.c b/drivers/i2c/busses/i2c-mxs.c index f97243f022311..bcfe48e17072c 100644 --- a/drivers/i2c/busses/i2c-mxs.c +++ b/drivers/i2c/busses/i2c-mxs.c @@ -100,7 +100,7 @@ enum mxs_i2c_devtype { MXS_I2C_V2, }; -/** +/* * struct mxs_i2c_dev - per device, private MXS-I2C data * * @dev: driver model device node