From patchwork Wed Jan 27 11:25:51 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Lee Jones X-Patchwork-Id: 371500 Delivered-To: patch@linaro.org Received: by 2002:a02:a60d:0:0:0:0:0 with SMTP id c13csp173846jam; Wed, 27 Jan 2021 03:34:04 -0800 (PST) X-Google-Smtp-Source: ABdhPJz7brxOo++wD1Ly2N+AYoAFCkMLaLzUH/w9Hr/r/0HXwZnp67LXET7YDj3cuRJwxyNSYNlf X-Received: by 2002:aa7:dc0d:: with SMTP id b13mr8679815edu.170.1611747244133; Wed, 27 Jan 2021 03:34:04 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1611747244; cv=none; d=google.com; s=arc-20160816; b=vJMhZeoMGK5WSzbbFAS2wT72Ox+a2NnP1cK7IfqbZWGxjJmdTLewIXXckWxv1GeYEP mD4XvX0XttmgwYQocxVP+8aqSinRKLeEhIvHP+hZ8sAdzi1WO9O4/GYU2d7rvyOgDckO RNcXbuipXwbLp5yFNelcWxRWGyQIX8ZMHdnl0pkQVXVfMVwKzb7hoYegMOsct6AdmHqP ev/SnzmPIWKX0/S8+AblANRpGPhR80SCCrJIiSKhseTGwtbqV/NOKt8KVzJNDWffLl7S ralPv4z5v6YAp/a0iMQxvOUPpn8McXOph3xAKxaEafCll17+yei93bhVTobn8rbKXqBj qEcw== 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 :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature; bh=mwkTQ1nP1bLt6tR6lEnllegWqUs+MQYhQRklBiDlKoQ=; b=uro+hMxMHs761UqBuU05UJdd/u7VPIBo6XiuAU59rYMyG4h0Ml7Wci1npETR/GwDaz hamJZuNAOz1Qt167Od4Apz3J4ryTkwv7F+fDpJaexYGbzDSCGRsCiBDEas7HGvyYZUQu GJyISnFOHQ/v4I/5mmNG9kMvGMFd51cptVEp7o5Av8DrqcqW5Zj0jAxYYgO0e6TWJIXI rrT5iM+Dv/6KfQ94OUxnnN86hxL00ojvh3p3HLQ9Z4Iif1F+pIE/hI61us/0vuhqOmtq sBDhIXUIfxZdGOOsodZpxFs7i1hpRukOWajLxufQBys0dVg3NK9N4sOEIJfzBhQBSuwd A/uw== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=TECRuVSe; spf=pass (google.com: domain of linux-usb-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=linux-usb-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=linaro.org Return-Path: Received: from vger.kernel.org (vger.kernel.org. [23.128.96.18]) by mx.google.com with ESMTP id w16si869329edi.602.2021.01.27.03.34.03; Wed, 27 Jan 2021 03:34:04 -0800 (PST) Received-SPF: pass (google.com: domain of linux-usb-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) client-ip=23.128.96.18; Authentication-Results: mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=TECRuVSe; spf=pass (google.com: domain of linux-usb-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=linux-usb-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=linaro.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S236875AbhA0Lcw (ORCPT + 3 others); Wed, 27 Jan 2021 06:32:52 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:34240 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S236691AbhA0Lan (ORCPT ); Wed, 27 Jan 2021 06:30:43 -0500 Received: from mail-wm1-x32b.google.com (mail-wm1-x32b.google.com [IPv6:2a00:1450:4864:20::32b]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 04917C06121D for ; Wed, 27 Jan 2021 03:26:11 -0800 (PST) Received: by mail-wm1-x32b.google.com with SMTP id j18so1224132wmi.3 for ; Wed, 27 Jan 2021 03:26:10 -0800 (PST) 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=mwkTQ1nP1bLt6tR6lEnllegWqUs+MQYhQRklBiDlKoQ=; b=TECRuVSe4dnnPdOZ3qR5o+DV52hnLhGLAxQdA7gxPlQOxjeODPEdP7CQAZHat31ble wLQoPMy9pOhXcsz/6tW7pPJcKNhgLbTohtlvHttbI1k49AZeWJjjDOh7L8kG5ReuzLEi 828/CAZHL6Lzyi/TChi7d3krhiR23NS8cUjvSXXeCm5f0cnpqmm+WZFQNkUfiqwbCRzl 1abB6e9DEowFsRE9W6sVuPyJCU9t3ODjhnKbxw1EkJ7MGR7wZ/NfZvJIS4O3HEZSbiC/ nWkbPp8U6agq6crMMXjtYH+QYnybAS+CXhs6eNbh33tcQpA4S3joP06IZzVINNJ8A4N4 CHdQ== 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=mwkTQ1nP1bLt6tR6lEnllegWqUs+MQYhQRklBiDlKoQ=; b=VyOMUJVvHBJTO0sNrmr1ghYu337t48QyQ9WwRct/kncgB8NqF1qLGNfXMTJaBZ6H0E NH60zO1FzfPFfVG7Nx/EfmBWQtKKMzaZJvNfINoXwu+gjJS5cwzYSduQ2iGutfC7aK0Y 54shZ0WJ4aCPfGs/bZKIwixKtclC9raLfiqzc6k6IzOL4ILmchzoYnG1IQmQqQ4vTh7x oSGKtv7Av+jaRCD7K0eEz0TzESllLD6Ncv5GF8a7rJUwWaUBGe6WrbxJwkZi4FK4+Wzv p+mI1/z77ykYNZeMJ/gPHR7R7oQPQBKYXs8ZphArb0Mdrrd0sjuySuvOV2SiXdWSWJ5W zzBw== X-Gm-Message-State: AOAM533/0T9WUslwmbfd1gBLPIJ4WPGfN62mgx1SRCndzzLUxhU2Inx6 KWvJIwkbz29qGYf52S7C7fw9dA== X-Received: by 2002:a1c:8002:: with SMTP id b2mr3944058wmd.94.1611746769810; Wed, 27 Jan 2021 03:26:09 -0800 (PST) Received: from dell.default ([91.110.221.188]) by smtp.gmail.com with ESMTPSA id m2sm2040065wml.34.2021.01.27.03.26.08 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 27 Jan 2021 03:26:09 -0800 (PST) From: Lee Jones To: lee.jones@linaro.org Cc: linux-kernel@vger.kernel.org, Andreas Noever , Michael Jamet , Mika Westerberg , Yehezkel Bernat , linux-usb@vger.kernel.org Subject: [PATCH 09/12] thunderbolt: swit: Demote a bunch of non-conformant kernel-doc headers Date: Wed, 27 Jan 2021 11:25:51 +0000 Message-Id: <20210127112554.3770172-10-lee.jones@linaro.org> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20210127112554.3770172-1-lee.jones@linaro.org> References: <20210127112554.3770172-1-lee.jones@linaro.org> MIME-Version: 1.0 Precedence: bulk List-ID: X-Mailing-List: linux-usb@vger.kernel.org Fixes the following W=1 kernel build warning(s): drivers/thunderbolt/switch.c:540: warning: Function parameter or member 'port' not described in 'tb_wait_for_port' drivers/thunderbolt/switch.c:540: warning: Function parameter or member 'wait_if_unplugged' not described in 'tb_wait_for_port' drivers/thunderbolt/switch.c:599: warning: Function parameter or member 'port' not described in 'tb_port_add_nfc_credits' drivers/thunderbolt/switch.c:599: warning: Function parameter or member 'credits' not described in 'tb_port_add_nfc_credits' drivers/thunderbolt/switch.c:653: warning: Function parameter or member 'port' not described in 'tb_port_clear_counter' drivers/thunderbolt/switch.c:653: warning: Function parameter or member 'counter' not described in 'tb_port_clear_counter' drivers/thunderbolt/switch.c:730: warning: Function parameter or member 'port' not described in 'tb_init_port' drivers/thunderbolt/switch.c:1348: warning: Function parameter or member 'sw' not described in 'tb_plug_events_active' drivers/thunderbolt/switch.c:1348: warning: Function parameter or member 'active' not described in 'tb_plug_events_active' drivers/thunderbolt/switch.c:2654: warning: Function parameter or member 'sw' not described in 'tb_sw_set_unplugged' Cc: Andreas Noever Cc: Michael Jamet Cc: Mika Westerberg Cc: Yehezkel Bernat Cc: linux-usb@vger.kernel.org Signed-off-by: Lee Jones --- drivers/thunderbolt/switch.c | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) -- 2.25.1 diff --git a/drivers/thunderbolt/switch.c b/drivers/thunderbolt/switch.c index cdba05e72486b..ce1b120d1cd46 100644 --- a/drivers/thunderbolt/switch.c +++ b/drivers/thunderbolt/switch.c @@ -523,7 +523,7 @@ int tb_port_state(struct tb_port *port) return phy.state; } -/** +/* * tb_wait_for_port() - wait for a port to become ready * * Wait up to 1 second for a port to reach state TB_PORT_UP. If @@ -587,7 +587,7 @@ int tb_wait_for_port(struct tb_port *port, bool wait_if_unplugged) return 0; } -/** +/* * tb_port_add_nfc_credits() - add/remove non flow controlled credits to port * * Change the number of NFC credits allocated to @port by @credits. To remove @@ -644,7 +644,7 @@ int tb_port_set_initial_credits(struct tb_port *port, u32 credits) return tb_port_write(port, &data, TB_CFG_PORT, ADP_CS_5, 1); } -/** +/* * tb_port_clear_counter() - clear a counter in TB_CFG_COUNTER * * Return: Returns 0 on success or an error code on failure. @@ -718,7 +718,7 @@ int tb_port_disable(struct tb_port *port) return __tb_port_enable(port, false); } -/** +/* * tb_init_port() - initialize a port * * This is a helper method for tb_switch_alloc. Does not check or initialize @@ -1337,7 +1337,7 @@ int tb_switch_reset(struct tb_switch *sw) return res.err; } -/** +/* * tb_plug_events_active() - enable/disable plug events on a switch * * Also configures a sane plug_events_delay of 255ms. @@ -2647,7 +2647,7 @@ void tb_switch_remove(struct tb_switch *sw) device_unregister(&sw->dev); } -/** +/* * tb_sw_set_unplugged() - set is_unplugged on switch and downstream switches */ void tb_sw_set_unplugged(struct tb_switch *sw)