Received: by 2002:ab2:7b86:0:b0:1f7:5705:b850 with SMTP id q6csp1461137lqh; Mon, 6 May 2024 08:20:43 -0700 (PDT) X-Forwarded-Encrypted: i=3; AJvYcCU9zCLNtWCxoxXILXrKl0GcjASiMwUREsAyPxKVV5XnUmrw2wa77sVyuOmn9xbnNwC9koY2tlK7++sTpGA6/OkNNHgRjQF8j7s7dHCiww== X-Google-Smtp-Source: AGHT+IG8wvSbQbj+Kys/UglQOEH8yHgKRt6bAsWvGV2Iw93h/AxFLMmb8hf/18AMdTHNhKlQlCRV X-Received: by 2002:ac8:7f82:0:b0:43a:bee9:eb0 with SMTP id z2-20020ac87f82000000b0043abee90eb0mr9951417qtj.35.1715008842982; Mon, 06 May 2024 08:20:42 -0700 (PDT) ARC-Seal: i=2; a=rsa-sha256; t=1715008842; cv=pass; d=google.com; s=arc-20160816; b=pws0i4Fv6+aPr0wMZ6b0CC7znKgD4nIIw+dqXHhKvEWjDWswcd6CnWTZPxMCL4/9BB 6lyWmz4SJ5x2Y5pcMzIf/0DAPboX/vnGo4r9TPqaNZXVsnGWpFx758Qvqrq21yqISi4e wwkachLjgsQnM8wfolLV5qjYkQxKiEnW90cpenA26Q3rPqxLMS7fx8mRhhMtLNTHIoYV LRNJc2o78Dahj4MikOuTE4wPV1isJeih+w4TWnxjhEYp0k8tqjhNjg0JbZLEO8klrEH0 eWy+mfMzatZkE3PtlDfdL3RnQ76ySNMzA+XSVCG9urH4BwQswi+J6YxONUQwq2K7ueV5 YObA== ARC-Message-Signature: i=2; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=content-transfer-encoding:in-reply-to:from:content-language :references:cc:to:subject:user-agent:mime-version:list-unsubscribe :list-subscribe:list-id:precedence:date:message-id:dkim-signature; bh=lbJi3sRsQv4/3F92ud7PDqyZNpJ7gOb4bwceJKBgBgs=; fh=8Br4Li2oO85Efga2BxOgQpurF3m9JyWjPA8sUya85mI=; b=XAicI3lSbX+8WEbC26KIfHYmdL3rUihsbrDFvPVWjGveY47T0b9nCPbBF4HX+3byRY 2I0HCAh9cdXnW0TEqnVRBum/fsqWslby6YPQNZIyn6s5aDa4BSRI26IYfTX+8JF6EtlL AhWdB0IKrbGMctLyr0yi1hgIWLTfE9GnXTEXJsaDQszf24SUedB3in563BkceL681Jb9 W+yc0oJI2wvJxKLzFAdwaRyFZGjxNij0wxGS8BGjMbH4kBzML35bK+AR2etr0LsMTnpY DyvsKsljU8No/IGF6TOKK+OwYFRFdjd/gRdQ366yJ40BJ7zqn/mgVTYNICgtJumD7yVb JCYg==; dara=google.com ARC-Authentication-Results: i=2; mx.google.com; dkim=pass header.i=@infradead.org header.s=desiato.20200630 header.b=V35oBW5t; arc=pass (i=1 dkim=pass dkdomain=infradead.org); spf=pass (google.com: domain of linux-kernel+bounces-170067-linux.lists.archive=gmail.com@vger.kernel.org designates 147.75.199.223 as permitted sender) smtp.mailfrom="linux-kernel+bounces-170067-linux.lists.archive=gmail.com@vger.kernel.org" Return-Path: Received: from ny.mirrors.kernel.org (ny.mirrors.kernel.org. [147.75.199.223]) by mx.google.com with ESMTPS id u29-20020a05622a199d00b0043a09afe8b9si9860277qtc.128.2024.05.06.08.20.42 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 06 May 2024 08:20:42 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel+bounces-170067-linux.lists.archive=gmail.com@vger.kernel.org designates 147.75.199.223 as permitted sender) client-ip=147.75.199.223; Authentication-Results: mx.google.com; dkim=pass header.i=@infradead.org header.s=desiato.20200630 header.b=V35oBW5t; arc=pass (i=1 dkim=pass dkdomain=infradead.org); spf=pass (google.com: domain of linux-kernel+bounces-170067-linux.lists.archive=gmail.com@vger.kernel.org designates 147.75.199.223 as permitted sender) smtp.mailfrom="linux-kernel+bounces-170067-linux.lists.archive=gmail.com@vger.kernel.org" Received: from smtp.subspace.kernel.org (wormhole.subspace.kernel.org [52.25.139.140]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ny.mirrors.kernel.org (Postfix) with ESMTPS id B08991C21995 for ; Mon, 6 May 2024 15:20:42 +0000 (UTC) Received: from localhost.localdomain (localhost.localdomain [127.0.0.1]) by smtp.subspace.kernel.org (Postfix) with ESMTP id 4657A15535E; Mon, 6 May 2024 15:20:38 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=infradead.org header.i=@infradead.org header.b="V35oBW5t" 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 smtp.subspace.kernel.org (Postfix) with ESMTPS id A157B13DDC1 for ; Mon, 6 May 2024 15:20:35 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=90.155.92.199 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1715008837; cv=none; b=hlN27gwbMFzDzZJnNudssCACRZ5NPZyJG9mswS5yeb+B2B99IYkApSRl1WNTTumHKBIP0jE0WFfSi2fPvCupnsIprJAiB8qpTLEDtJ3ACARE5P5kb7tud+KiKMKUtQ5hyPvO6m6ZX8J8jNHBmOM69iEl+313sAFKq8r4ZjWEXhs= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1715008837; c=relaxed/simple; bh=BapJg+2LI+ANgEUnvNkNxdLMzL3lAUyjiHwonn5Rezk=; h=Message-ID:Date:MIME-Version:Subject:To:Cc:References:From: In-Reply-To:Content-Type; b=QYgGLr1KSn6UburFqkDbN+nOBYaOOL1pSokF1BUqTTh4JgUoYY/YeUZMZMHU7ToyhQ9FzhalFfXJ7E85vo9jF9Lf22or6uIDJpGhmpFa2U6hhqyh/DvRSbGSiwGid2A3aDDzR4lkONmIJrChd6KTqHbqhpQZ7QjS7h0DATht2dA= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=none (p=none dis=none) header.from=infradead.org; spf=none smtp.mailfrom=infradead.org; dkim=pass (2048-bit key) header.d=infradead.org header.i=@infradead.org header.b=V35oBW5t; arc=none smtp.client-ip=90.155.92.199 Authentication-Results: smtp.subspace.kernel.org; dmarc=none (p=none dis=none) header.from=infradead.org Authentication-Results: smtp.subspace.kernel.org; spf=none smtp.mailfrom=infradead.org DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=infradead.org; s=desiato.20200630; h=Content-Transfer-Encoding:Content-Type :In-Reply-To:From:References:Cc:To:Subject:MIME-Version:Date:Message-ID: Sender:Reply-To:Content-ID:Content-Description; bh=lbJi3sRsQv4/3F92ud7PDqyZNpJ7gOb4bwceJKBgBgs=; b=V35oBW5tMGA1DOU1+QCyQ0jnlM LEmTzB2AtdH6YFIWRz+PJuvOh/6vNoiTRdZZHqxWPB5G1Z/8OjF3FyDgWzsHazm+lP+BcZPmXGPuv vkaF/hdyUt+jPsup1BCFlwj9Lg316gqV0cVY3+hFMtz2udAxwK/MO0eIvV2sxKUCplYiObqFA0skE 54abL650PLu0dUJgv3o9x6SLSitLubZ2M8l8UKKsePpKk6VZIJmMdpC9Udd+WhkBxVYFq4y6cNPh0 Lx9rtOF0TalfRjN+v+wM7gZqrvItb9qZZ/ZlMvrz1e7MIDQQIXEsxAKj3sM8kRzFCbd/pgtf7uRa0 i0OZkB1Q==; Received: from [2600:381:229a:b4a5:8543:7865:e9d3:dc68] by desiato.infradead.org with esmtpsa (Exim 4.97.1 #2 (Red Hat Linux)) id 1s408j-00000001kWa-1qWX; Mon, 06 May 2024 15:20:30 +0000 Message-ID: <4138c586-8a56-4328-b7dc-bbfc7850e238@infradead.org> Date: Mon, 6 May 2024 08:20:22 -0700 Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 User-Agent: Mozilla Thunderbird Subject: Re: [PATCH] most: fix current kernel-doc warnings To: Jeff Johnson , Parthiban Veerasooran , Christian Gromm Cc: linux-kernel@vger.kernel.org References: <20240504-most-kdoc-v1-1-378c468ccd85@quicinc.com> Content-Language: en-US From: Randy Dunlap In-Reply-To: <20240504-most-kdoc-v1-1-378c468ccd85@quicinc.com> Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 7bit On 5/4/24 6:25 PM, Jeff Johnson wrote: > Follow up on the prior work [1] from Randy Dunlap and fix the current > set of W=1 kernel-doc warnings in drivers/most/: > > drivers/most/most_snd.c:58: warning: Excess struct member 'opened' description in 'channel' > drivers/most/most_usb.c:69: warning: Function parameter or struct member 'dev' not described in 'most_dci_obj' > drivers/most/most_usb.c:69: warning: Excess struct member 'kobj' description in 'most_dci_obj' > drivers/most/most_usb.c:122: warning: Function parameter or struct member 'dev' not described in 'most_dev' > drivers/most/most_usb.c:122: warning: Function parameter or struct member 'clear_work' not described in 'most_dev' > drivers/most/most_usb.c:122: warning: Function parameter or struct member 'on_netinfo' not described in 'most_dev' > drivers/most/most_usb.c:650: warning: Function parameter or struct member 'on_netinfo' not described in 'hdm_request_netinfo' > > Link: https://lore.kernel.org/r/20230113063947.23174-1-rdunlap@infradead.org [1] > Signed-off-by: Jeff Johnson Tested-by: Randy Dunlap Acked-by: Randy Dunlap Thanks. > --- > drivers/most/most_snd.c | 1 - > drivers/most/most_usb.c | 6 +++++- > 2 files changed, 5 insertions(+), 2 deletions(-)