From patchwork Sun Apr 23 05:48:45 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Randy Dunlap X-Patchwork-Id: 86664 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a59:b0ea:0:b0:3b6:4342:cba0 with SMTP id b10csp2069977vqo; Sun, 23 Apr 2023 00:27:16 -0700 (PDT) X-Google-Smtp-Source: AKy350aSZkuRYywU+jSXKWrnxamQOYjHAL08/VJc+SS+EEVZzupwrFoFSyPyNt8INXoUjm23QMqE X-Received: by 2002:a05:6a21:170d:b0:ef:1d4e:cf3e with SMTP id nv13-20020a056a21170d00b000ef1d4ecf3emr11401433pzb.50.1682234836185; Sun, 23 Apr 2023 00:27:16 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1682234836; cv=none; d=google.com; s=arc-20160816; b=yf9OPGSIIkPFYCx4j3bIKEVfXzeSe7XG+T30QUxGWXZOJe6/YvqYQDRlgBqgkuXnkO mjb0af9OudB+ySyGBtNZl5KLaQCvKMMCLNtGExESYy+kVi7AUuVvezLTmG6ned0VefMl Sf8/JC9DdWC8Sfli29WWk9XXvUGP3sL25I3QYfKvfr7QfKHHwcmc+um49RRRezs9QVlm M8Ws4RH+6iOz/8n7vf7WBs5NDRpUw/PKpMSMvgiTYYXWY6K1TAr+Lyb4EppDOdn2q4iT wMo0Uz42mer5Yp8aMZsWdeDZQFfN4VoZtkPVOVWCmTHQ7owMkdWQj2PzIhNynJeTVna1 +1oQ== 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=vWpzRzo8cm9efAzaoFwYkqDS+jJeQhHNqJ+MkOQpCN4=; b=bAh/hymhmZ9t/uFAH5Hvu/L7QoFlDFp6vVQu0Glm9ExX81S3fB4HFpfca+D9vrqlV3 WfqBbYVI0Rm9u3xLYCwiw7ahx6AzWz7Ae3GsCFB+v7OZL26wZ1FB/6yh1YVE89B2Svby 5olQ4lxdh/hT6zZVx+Yk6y+q3A2DrMhFETBzWEyK1WI5gyww9uCRchnr4o2hoTATB/0I UbaMt/qjb1aEhnWd28QF7p3iX0WIHh+ZKKbsH0EwJv6F2c5FnsPV9JPrgApoYI/2i+Aq 26SaG7sWQrOsxr59YlKrGhpP9nW1u2wqDzkfUsH34pCYzKFFsfiNmsSSLzn49Y9+60E+ Jv+g== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@infradead.org header.s=bombadil.20210309 header.b=Z0rNnvsw; 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 bs129-20020a632887000000b005200cd1a9bdsi8119537pgb.827.2023.04.23.00.27.02; Sun, 23 Apr 2023 00:27:16 -0700 (PDT) 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=Z0rNnvsw; 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 S229944AbjDWFsy (ORCPT + 99 others); Sun, 23 Apr 2023 01:48:54 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:43384 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229516AbjDWFsx (ORCPT ); Sun, 23 Apr 2023 01:48:53 -0400 Received: from bombadil.infradead.org (bombadil.infradead.org [IPv6:2607:7c80:54:3::133]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 376FE19B1 for ; Sat, 22 Apr 2023 22:48:50 -0700 (PDT) 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=vWpzRzo8cm9efAzaoFwYkqDS+jJeQhHNqJ+MkOQpCN4=; b=Z0rNnvswabJzlpm94qEF+uOGN+ opX9a8X/xSZZyiF4ewvOhUVjIUhgVuU3ZukEaaBk00W1DWkGbO+EJwDcTF3tmUsW2EB2Kli4jbAoh kFwCU90vsDjyuxzIcOwc4WlZjnboLjmrN3Gx9TKczkqiql0Ea7Vfmtn6K48P8Ufaf5s997wBobHBh A//3rqE3S63FmLMafJ/yQbmqSWnvvZ+Fd+EUEYUlxuSvE9woly3sP+EYyH+QCc1SuMNkSXP6yUDxB zCD30TxbGP8+2C0Go6v8T+KrdrQeH2c1udGiaswq8Cm7L8bA36qMtUz1Jt+znb7DMp/YdLZDVM4gT Kyzq1WnQ==; Received: from [2601:1c2:980:9ec0::2764] (helo=bombadil.infradead.org) by bombadil.infradead.org with esmtpsa (Exim 4.96 #2 (Red Hat Linux)) id 1pqSae-00DneG-2R; Sun, 23 Apr 2023 05:48:48 +0000 From: Randy Dunlap To: linux-kernel@vger.kernel.org Cc: Randy Dunlap , kernel test robot , Arnd Bergmann , Kristoffer Ericson , Russell King , patches@armlinux.org.uk Subject: [PATCH] arm: HP Jornada 7XX: fix kernel-doc warnings Date: Sat, 22 Apr 2023 22:48:45 -0700 Message-Id: <20230423054845.27204-1-rdunlap@infradead.org> X-Mailer: git-send-email 2.40.0 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,T_SCC_BODY_TEXT_LINE 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?1763951075884876506?= X-GMAIL-MSGID: =?utf-8?q?1763951075884876506?= Fix kernel-doc warnings from the kernel test robot: jornada720_ssp.c:24: warning: Function parameter or member 'jornada_ssp_lock' not described in 'DEFINE_SPINLOCK' jornada720_ssp.c:24: warning: expecting prototype for arch/arm/mac(). Prototype was for DEFINE_SPINLOCK() instead jornada720_ssp.c:34: warning: Function parameter or member 'byte' not described in 'jornada_ssp_reverse' jornada720_ssp.c:57: warning: Function parameter or member 'byte' not described in 'jornada_ssp_byte' jornada720_ssp.c:85: warning: Function parameter or member 'byte' not described in 'jornada_ssp_inout' Fixes: 69ebb22277a5 ("[ARM] 4506/1: HP Jornada 7XX: Addition of SSP Platform Driver") Signed-off-by: Randy Dunlap Reported-by: kernel test robot Link: lore.kernel.org/r/202304210535.tWby3jWF-lkp@intel.com Cc: Arnd Bergmann Cc: Kristoffer Ericson Cc: Russell King Cc: patches@armlinux.org.uk --- KernelVersion: 6.3-rc7 arch/arm/mach-sa1100/jornada720_ssp.c | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff -- a/arch/arm/mach-sa1100/jornada720_ssp.c b/arch/arm/mach-sa1100/jornada720_ssp.c --- a/arch/arm/mach-sa1100/jornada720_ssp.c +++ b/arch/arm/mach-sa1100/jornada720_ssp.c @@ -1,5 +1,5 @@ // SPDX-License-Identifier: GPL-2.0-only -/** +/* * arch/arm/mac-sa1100/jornada720_ssp.c * * Copyright (C) 2006/2007 Kristoffer Ericson @@ -26,6 +26,7 @@ static unsigned long jornada_ssp_flags; /** * jornada_ssp_reverse - reverses input byte + * @byte: input byte to reverse * * we need to reverse all data we receive from the mcu due to its physical location * returns : 01110111 -> 11101110 @@ -46,6 +47,7 @@ EXPORT_SYMBOL(jornada_ssp_reverse); /** * jornada_ssp_byte - waits for ready ssp bus and sends byte + * @byte: input byte to transmit * * waits for fifo buffer to clear and then transmits, if it doesn't then we will * timeout after rounds. Needs mcu running before its called. @@ -77,6 +79,7 @@ EXPORT_SYMBOL(jornada_ssp_byte); /** * jornada_ssp_inout - decide if input is command or trading byte + * @byte: input byte to send (may be %TXDUMMY) * * returns : (jornada_ssp_byte(byte)) on success * : %-ETIMEDOUT on timeout failure