From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-7.0 required=3.0 tests=BAYES_00, HEADER_FROM_DIFFERENT_DOMAINS,MAILING_LIST_MULTI,SIGNED_OFF_BY,SPF_HELO_NONE, SPF_PASS autolearn=no autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id 2A50DC433E1 for ; Wed, 15 Jul 2020 02:54:34 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by mail.kernel.org (Postfix) with ESMTP id 126BE20729 for ; Wed, 15 Jul 2020 02:54:33 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1728140AbgGOCyc convert rfc822-to-8bit (ORCPT ); Tue, 14 Jul 2020 22:54:32 -0400 Received: from mail-lf1-f67.google.com ([209.85.167.67]:45493 "EHLO mail-lf1-f67.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1726971AbgGOCyc (ORCPT ); Tue, 14 Jul 2020 22:54:32 -0400 Received: by mail-lf1-f67.google.com with SMTP id s16so229535lfp.12; Tue, 14 Jul 2020 19:54:30 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:references:in-reply-to:from:date :message-id:subject:to:cc:content-transfer-encoding; bh=ViMoiRYbnye9Bhm7FBkCgDKaz65TFLMn2cnFe8DTw7g=; b=eqliB1+W5FFbnBIcIJWsbJ0nTXSAi6LMOZO7drDgv0RJlEb1PSKh4j+DzEHenWEtdu AX/rTJkYWhtmY8ukF9JfVCAydO2mLmkhcvWXxiMPI5MOOck4xv090vZn8ahQ5QfAz86Z DeBvhvxSnsDzYvzbwX2QBecSG2OW9WDBWnDHOvRspQuQGtW5nAtIsV1V5LTf2pO3sNVh Pck13qLbLqBmXuhroIXiOaLdJh1awGLGqmdM1UBOqx6NPG6eOZcHxkjg++fPxd9uBpvS G7rGXu/XjCY9DBziQe7fNpd7eGc0DpDzf5Y/Neo99gBpCI5X1aJDEfuaUeSRC5NRMKCU /kXA== X-Gm-Message-State: AOAM532InGl6nnHmBm30WN3DLoBWrgxtiqiMI135evJZPzHeURyudTCJ XzfeFhVmhtAuZf9z5vaWikCEK2lm9j0= X-Google-Smtp-Source: ABdhPJzaOHutYV9oPPssrwvpfcW11L408zPrEMSDLeH4LFWmt7qiNeyRjvaNg5izXfA2HLA8WQ9vgg== X-Received: by 2002:ac2:5619:: with SMTP id v25mr3630383lfd.117.1594781669485; Tue, 14 Jul 2020 19:54:29 -0700 (PDT) Received: from mail-lj1-f179.google.com (mail-lj1-f179.google.com. [209.85.208.179]) by smtp.gmail.com with ESMTPSA id f13sm184059lfs.29.2020.07.14.19.54.29 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Tue, 14 Jul 2020 19:54:29 -0700 (PDT) Received: by mail-lj1-f179.google.com with SMTP id b25so866467ljp.6; Tue, 14 Jul 2020 19:54:29 -0700 (PDT) X-Received: by 2002:a2e:99cf:: with SMTP id l15mr3740000ljj.294.1594781669067; Tue, 14 Jul 2020 19:54:29 -0700 (PDT) MIME-Version: 1.0 References: <20200714111546.1755231-1-lee.jones@linaro.org> <20200714111546.1755231-10-lee.jones@linaro.org> In-Reply-To: <20200714111546.1755231-10-lee.jones@linaro.org> From: Chen-Yu Tsai Date: Wed, 15 Jul 2020 10:54:18 +0800 X-Gmail-Original-Message-ID: Message-ID: Subject: Re: [PATCH 09/17] dma: sun4i-dma: Demote obvious misuse of kerneldoc to standard comment blocks To: Lee Jones Cc: Dan Williams , Vinod Koul , linux-arm-kernel , linux-kernel , "open list:DMA GENERIC OFFLOAD ENGINE SUBSYSTEM" , Maxime Ripard , =?UTF-8?Q?Emilio_L=C3=B3pez?= Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: 8BIT Sender: linux-kernel-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org On Tue, Jul 14, 2020 at 7:16 PM Lee Jones wrote: > > No attempt has been made to document any of the demoted functions here. > > Fixes the following W=1 kernel build warning(s): > > drivers/dma/sun4i-dma.c:321: warning: Function parameter or member 'priv' not described in '__execute_vchan_pending' > drivers/dma/sun4i-dma.c:321: warning: Function parameter or member 'vchan' not described in '__execute_vchan_pending' > drivers/dma/sun4i-dma.c:435: warning: Function parameter or member 'chan' not described in 'generate_ndma_promise' > drivers/dma/sun4i-dma.c:435: warning: Function parameter or member 'src' not described in 'generate_ndma_promise' > drivers/dma/sun4i-dma.c:435: warning: Function parameter or member 'dest' not described in 'generate_ndma_promise' > drivers/dma/sun4i-dma.c:435: warning: Function parameter or member 'len' not described in 'generate_ndma_promise' > drivers/dma/sun4i-dma.c:435: warning: Function parameter or member 'sconfig' not described in 'generate_ndma_promise' > drivers/dma/sun4i-dma.c:435: warning: Function parameter or member 'direction' not described in 'generate_ndma_promise' > drivers/dma/sun4i-dma.c:501: warning: Function parameter or member 'chan' not described in 'generate_ddma_promise' > drivers/dma/sun4i-dma.c:501: warning: Function parameter or member 'src' not described in 'generate_ddma_promise' > drivers/dma/sun4i-dma.c:501: warning: Function parameter or member 'dest' not described in 'generate_ddma_promise' > drivers/dma/sun4i-dma.c:501: warning: Function parameter or member 'len' not described in 'generate_ddma_promise' > drivers/dma/sun4i-dma.c:501: warning: Function parameter or member 'sconfig' not described in 'generate_ddma_promise' > drivers/dma/sun4i-dma.c:577: warning: Function parameter or member 'contract' not described in 'get_next_cyclic_promise' > drivers/dma/sun4i-dma.c:596: warning: Function parameter or member 'vd' not described in 'sun4i_dma_free_contract' > > Cc: Maxime Ripard > Cc: Chen-Yu Tsai > Cc: "Emilio López" > Signed-off-by: Lee Jones Acked-by: Chen-Yu Tsai