Received: by 2002:a05:6902:102b:0:0:0:0 with SMTP id x11csp433069ybt; Wed, 8 Jul 2020 03:33:26 -0700 (PDT) X-Google-Smtp-Source: ABdhPJxcyVAeFIVtLbEezOKYiFAVMbUAZUrVvNcZXyHCFlAZLRIDbCGfytnhLAMtMeTpRwU4b1VQ X-Received: by 2002:a17:906:899:: with SMTP id n25mr48204865eje.298.1594204406701; Wed, 08 Jul 2020 03:33:26 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1594204406; cv=none; d=google.com; s=arc-20160816; b=LsMqhg7nww7h+DvUKXLOwD++CxPgdvTCms0jQ1g/wb7iTh2YsrtTX0wJ2BHxK/JmvT ANevw7mHYe2Frc103JjIbOMGzm89ZxtUBLKAb1eUzLES3opG2STGVop7lcjsOaOqNENS QLsp2ycjP8LuEBVHynbEBKM/thKFuc8cOUFUKXnEIUIOATRNrigXRrFowsRWADz9EJpK zBm1nAtpOTF7jwbOsXTDFyImxREDPQ4C0J18JmqcHdGvcc2gfDl5GgWAR8qo+eVMk8Tx skX2gFPboOyUisMBuo4OKwk3ItPHiHYFX1qSglpBZPxtQaSGCxoYThKmP7bAJBv896/x +0tA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:sender:mime-version:user-agent:message-id :in-reply-to:date:references:subject:cc:to:from; bh=XnzvZhVFjPzZ+9o3F2pjRI6U1GOZV+lt+TzgtsbxeUQ=; b=Se00CAFIJ9Ry0xDXB88y6rDIOJpMQn/mpc3DfqTIx78bg81RsRDyxXyJAT5bgf5xwV Wvm5QP2YOqE9xG/oIMY3NuVMGyHG0LMJ9BNcVHAdVfKH/BKgL6daNounp5xLnWPCXOXL OXHI31MNsaA7RT1v+ueNkFWflbWiaIOu9cAw6QsuYkbKLqwZfMZRvtAj8Cy+2gufpVFq hJbVJn0gWxw8KBsDTClfKjrNVXW2jisWl5Acm9McAHNMuv6SLH9YE2ZErQrWFhU+6GYD 8DAgw3l3h95vh5qTns/V5ru/tgQh76P0nxK6uskMV6KVM7Lh2a4G5ByfmRzdswJQKULG AWfA== ARC-Authentication-Results: i=1; mx.google.com; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Return-Path: Received: from vger.kernel.org (vger.kernel.org. [23.128.96.18]) by mx.google.com with ESMTP id d18si15597497ejt.487.2020.07.08.03.33.02; Wed, 08 Jul 2020 03:33:26 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) client-ip=23.128.96.18; Authentication-Results: mx.google.com; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1728239AbgGHKcQ (ORCPT + 99 others); Wed, 8 Jul 2020 06:32:16 -0400 Received: from smtp05.smtpout.orange.fr ([80.12.242.127]:32856 "EHLO smtp.smtpout.orange.fr" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1728205AbgGHKcQ (ORCPT ); Wed, 8 Jul 2020 06:32:16 -0400 Received: from belgarion ([86.210.166.159]) by mwinf5d09 with ME id 0aY52300c3SgWc603aYBzt; Wed, 08 Jul 2020 12:32:13 +0200 X-ME-Helo: belgarion X-ME-Auth: amFyem1pay5yb2JlcnRAb3JhbmdlLmZy X-ME-Date: Wed, 08 Jul 2020 12:32:13 +0200 X-ME-IP: 86.210.166.159 From: Robert Jarzmik To: Lee Jones Cc: gregkh@linuxfoundation.org, linux-arm-kernel@lists.infradead.org, linux-kernel@vger.kernel.org, linux-usb@vger.kernel.org, Daniel Mack , Haojian Zhuang , Felipe Balbi Subject: Re: [PATCH 06/32] usb: gadget: udc: pxa27x_udc: Fix a bunch of kerneldoc issues References: <20200706133341.476881-1-lee.jones@linaro.org> <20200706133341.476881-7-lee.jones@linaro.org> X-URL: http://belgarath.falguerolles.org/ Date: Wed, 08 Jul 2020 12:32:05 +0200 In-Reply-To: <20200706133341.476881-7-lee.jones@linaro.org> (Lee Jones's message of "Mon, 6 Jul 2020 14:33:15 +0100") Message-ID: <878sfuxpp6.fsf@belgarion.home> User-Agent: Gnus/5.130008 (Ma Gnus v0.8) Emacs/26 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain Sender: linux-kernel-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Lee Jones writes: > Mostly bitrotted argument descriptions/names. Also the removal > of a blank line in the middle of a kerneldoc header, which is > not allowed. > > Fixes the following W=1 kernel build warning(s): > > drivers/usb/gadget/udc/pxa27x_udc.c:398: warning: Function parameter or member 'ep' not described in 'ep_write_UDCCSR' > drivers/usb/gadget/udc/pxa27x_udc.c:398: warning: Excess function parameter 'udc' description in 'ep_write_UDCCSR' > drivers/usb/gadget/udc/pxa27x_udc.c:479: warning: Function parameter or member 'udc' not described in 'set_ep0state' > drivers/usb/gadget/udc/pxa27x_udc.c:479: warning: Excess function parameter 'dev' description in 'set_ep0state' > drivers/usb/gadget/udc/pxa27x_udc.c:506: warning: Excess function parameter 'req' description in 'inc_ep_stats_reqs' > drivers/usb/gadget/udc/pxa27x_udc.c:1476: warning: bad line: > drivers/usb/gadget/udc/pxa27x_udc.c:1697: warning: Function parameter or member 'udc' not described in 'udc_enable' > drivers/usb/gadget/udc/pxa27x_udc.c:1697: warning: Excess function parameter 'dev' description in 'udc_enable' > drivers/usb/gadget/udc/pxa27x_udc.c:1750: warning: Function parameter or member 'g' not described in 'pxa27x_udc_start' > drivers/usb/gadget/udc/pxa27x_udc.c:1750: warning: Excess function parameter 'bind' description in 'pxa27x_udc_start' > drivers/usb/gadget/udc/pxa27x_udc.c:1784: warning: Excess function parameter 'driver' description in 'stop_activity' > drivers/usb/gadget/udc/pxa27x_udc.c:1800: warning: Function parameter or member 'g' not described in 'pxa27x_udc_stop' > drivers/usb/gadget/udc/pxa27x_udc.c:1800: warning: Excess function parameter 'driver' description in 'pxa27x_udc_stop' > drivers/usb/gadget/udc/pxa27x_udc.c:2358: warning: Function parameter or member 'pdev' not described in 'pxa_udc_probe' > drivers/usb/gadget/udc/pxa27x_udc.c:2358: warning: Excess function parameter '_dev' description in 'pxa_udc_probe' > > Cc: Daniel Mack > Cc: Haojian Zhuang > Cc: Robert Jarzmik > Cc: Felipe Balbi > Signed-off-by: Lee Jones Acked-by: Robert Jarzmik Cheers. -- Robert