From patchwork Wed Jan 27 11:25:49 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Lee Jones X-Patchwork-Id: 371507 Delivered-To: patch@linaro.org Received: by 2002:a02:a60d:0:0:0:0:0 with SMTP id c13csp180973jam; Wed, 27 Jan 2021 03:45:20 -0800 (PST) X-Google-Smtp-Source: ABdhPJyov1wvRPgORqLA/urF+buUBpANqakhTGFgvMu8EPiuCJq8SzY91VL7QZwAps2hk0u7y7zZ X-Received: by 2002:a17:906:7e0f:: with SMTP id e15mr6385397ejr.150.1611747920509; Wed, 27 Jan 2021 03:45:20 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1611747920; cv=none; d=google.com; s=arc-20160816; b=SaVrQtzqGz8X9NBqFrv5mcdhKqlssiVsjIjPJNYFkkGauZ0Z8ZX4pJuiV1cO/hdOQ5 lnAadwftbOP/o4yB9Mmc0pYwYTsGsnxEUMGmF3YgxjauRs4zsNj1Z6E/Cd8iW+FcnDIx 71+UYF9wE9JOKOYGljzIlAeeDy23TnR9hNYrQMou3Ax6RzbXr2rTy8ptivFDTlFV3zFV zKkM08zUmAEr/2c3lYeW5f1TLrhXpKHgdlTq4uWhl+ycpKzObkE/iXzGuPgkIYuASJPn ihT8FfAKgPJ9xKwZu195AXotoYAG3WnJ10pgxw1TayKXzsxnQlrjRszvIPnqT3NzG1gT ZZew== 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=uAcqugrgmh8drWeQR+i/2G20G7LeMdKvoS3TGhgRh3k=; b=qggkSQeBmyHK74CGICve+wD56fXfxP7XQUaxx8GpoqZ85JqLhNNPBIIqj97M1z7z0F rIOYGrfN/N9sS2hOg283pWueoAeqGqidlhATXesCgSlxjgoGJjtlZpsdtbppa3QMKz4I l6yRXiqBkFeFv3hwGUjFH2I72WOl8ZyrzXevMzgi6c5giCgde9UgTwiFZGf9WJ9gsSgZ Lvapx3RvO6FfJo02xZPJNsuZHmAAWXBPEyZ8ypEjWrX6KbrjSvn+ELrAraKPpqxEaATG dfG/viRDw9dSsmFjiC+PkAxzW2joyQ6VgifD7/MRgK83hnDggYK/nw155LBCz7r580a4 7Idg== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=ki5sKBbv; 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 ec16si349289ejb.160.2021.01.27.03.45.20; Wed, 27 Jan 2021 03:45:20 -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=ki5sKBbv; 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 S236774AbhA0LoA (ORCPT + 3 others); Wed, 27 Jan 2021 06:44:00 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:33694 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S236636AbhA0L3M (ORCPT ); Wed, 27 Jan 2021 06:29:12 -0500 Received: from mail-wm1-x32f.google.com (mail-wm1-x32f.google.com [IPv6:2a00:1450:4864:20::32f]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 98AD9C061354 for ; Wed, 27 Jan 2021 03:26:08 -0800 (PST) Received: by mail-wm1-x32f.google.com with SMTP id m187so1230433wme.2 for ; Wed, 27 Jan 2021 03:26:08 -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=uAcqugrgmh8drWeQR+i/2G20G7LeMdKvoS3TGhgRh3k=; b=ki5sKBbvUH97xRS17R7ZRIfdT505bJXJc9ycIieG3YZtQaTkl6hn3yT88GSXjJuHaU G8uyBhNCIhFO9tEnbFNRwqusT2pALL0FwFllWU2+xaIXeB0tpu2BvCR8Mm2p7WNtR/EA UF7gMvG9H6vTfL41sL8BMOkYwIpyE8FqlZeVbbVVOVjCtiqekiIPwYXSReB5adhLy7FH YhcNNMOKwxHYfgOX35RJibYYXNdxm9qbFNxss2BxQLPRkK5vMju+WJD0FdzGFUeDAp9J K+fJZ3OwNg6PL/c1WHUJ6qLk0sX/CykQF8o9ZM+aggfzWS9Es44h7IpCPzwKgf+5Yo+f jB5A== 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=uAcqugrgmh8drWeQR+i/2G20G7LeMdKvoS3TGhgRh3k=; b=MagSOxs6CuC5asnKE/0wD+xCzrNzneTLH4xZsep3LiqAlY229xD4H38Gf6DqERTyQ4 B0ljjqjmVHnAeetpN7rDY5hyUGhlpa28cm9BtGWLBiPjyw4QzuWkUWSoeZtIwLsulMvU Zn1I1aRsyW/rE/fJYosz24g4M09ofv8hN2tLauvKV+A9OLXo4Gwql+xKT4ZY5EeaNIAS p11VrV6HRDDPsLzwOIEi6OaGC0v3ZliihGFjweDDFA9vIW3DkyvIoh6d7yIVURYIZs0o d7mPLN2gRGJX6icLjSu9atZJZ3AbXYsYWZw16StvzyKrK/VUYaaNmxgNKgdwTuePRHni F6aw== X-Gm-Message-State: AOAM5306dfwJPArj/i//Pa2P0ka6BmpXqEOXEMHWGD/IJgqOeuGK19Vy 7meyqUYzxHTqxcLFrv5EfnH4Kw== X-Received: by 2002:a7b:cf34:: with SMTP id m20mr3889202wmg.84.1611746767374; Wed, 27 Jan 2021 03:26:07 -0800 (PST) Received: from dell.default ([91.110.221.188]) by smtp.gmail.com with ESMTPSA id m2sm2040065wml.34.2021.01.27.03.26.06 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 27 Jan 2021 03:26:06 -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 07/12] thunderbolt: nhi: Demote some non-conformant kernel-doc headers Date: Wed, 27 Jan 2021 11:25:49 +0000 Message-Id: <20210127112554.3770172-8-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/nhi.c:53: warning: Function parameter or member 'ring' not described in 'ring_interrupt_active' drivers/thunderbolt/nhi.c:53: warning: Function parameter or member 'active' not described in 'ring_interrupt_active' drivers/thunderbolt/nhi.c:114: warning: Function parameter or member 'nhi' not described in 'nhi_disable_interrupts' drivers/thunderbolt/nhi.c:191: warning: Function parameter or member 'ring' not described in 'ring_write_descriptors' drivers/thunderbolt/nhi.c:225: warning: Function parameter or member 'work' not described in 'ring_work' drivers/thunderbolt/nhi.c:599: warning: Function parameter or member 'ring' not described in 'tb_ring_start' drivers/thunderbolt/nhi.c:682: warning: Function parameter or member 'ring' not described in 'tb_ring_stop' 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/nhi.c | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) -- 2.25.1 diff --git a/drivers/thunderbolt/nhi.c b/drivers/thunderbolt/nhi.c index cfc622da4f832..2ba33b53d4eb1 100644 --- a/drivers/thunderbolt/nhi.c +++ b/drivers/thunderbolt/nhi.c @@ -44,7 +44,7 @@ static int ring_interrupt_index(struct tb_ring *ring) return bit; } -/** +/* * ring_interrupt_active() - activate/deactivate interrupts for a single ring * * ring->nhi->lock must be held. @@ -105,7 +105,7 @@ static void ring_interrupt_active(struct tb_ring *ring, bool active) iowrite32(new, ring->nhi->iobase + reg); } -/** +/* * nhi_disable_interrupts() - disable interrupts for all rings * * Use only during init and shutdown. @@ -182,7 +182,7 @@ static bool ring_empty(struct tb_ring *ring) return ring->head == ring->tail; } -/** +/* * ring_write_descriptors() - post frames from ring->queue to the controller * * ring->lock is held. @@ -212,7 +212,7 @@ static void ring_write_descriptors(struct tb_ring *ring) } } -/** +/* * ring_work() - progress completed frames * * If the ring is shutting down then all frames are marked as canceled and @@ -590,7 +590,7 @@ struct tb_ring *tb_ring_alloc_rx(struct tb_nhi *nhi, int hop, int size, } EXPORT_SYMBOL_GPL(tb_ring_alloc_rx); -/** +/* * tb_ring_start() - enable a ring * * Must not be invoked in parallel with tb_ring_stop(). @@ -665,7 +665,7 @@ void tb_ring_start(struct tb_ring *ring) } EXPORT_SYMBOL_GPL(tb_ring_start); -/** +/* * tb_ring_stop() - shutdown a ring * * Must not be invoked from a callback. @@ -754,7 +754,7 @@ void tb_ring_free(struct tb_ring *ring) dev_dbg(&ring->nhi->pdev->dev, "freeing %s %d\n", RING_TYPE(ring), ring->hop); - /** + /* * ring->work can no longer be scheduled (it is scheduled only * by nhi_interrupt_work, ring_stop and ring_msix). Wait for it * to finish before freeing the ring.