From: Adrian Hunter <adrian.hunter@intel.com> To: Lee Jones <lee.jones@linaro.org>, ulf.hansson@linaro.org Cc: linux-arm-kernel@lists.infradead.org, linux-kernel@vger.kernel.org, Ritesh Harjani <riteshh@codeaurora.org>, Asutosh Das <asutoshd@codeaurora.org>, Venkat Gopalakrishnan <venkatg@codeaurora.org> Subject: Re: [PATCH 14/15] mmc: host: cqhci: Demote faux kerneldoc header down to basic comment block Date: Thu, 2 Jul 2020 09:43:19 +0300 [thread overview] Message-ID: <049e68ad-50fb-31d6-0a94-3f7c676a75e7@intel.com> (raw) In-Reply-To: <20200701124702.908713-15-lee.jones@linaro.org> On 1/07/20 3:47 pm, Lee Jones wrote: > cqhci_host_alloc_tdl()'s function header is the only one in > kerneldoc format. Which seems odd as it's not part of an > external API and isn't referenced anywhere else. Seeing as > there has also been no attempt to describe the expected > function arguments either, we're going to assume that this is > not actually a bona fide kerneldoc use-case. > > Fixes the following W=1 kernel build warning: > > drivers/mmc/host/cqhci.c:163: warning: Function parameter or member 'cq_host' not described in 'cqhci_host_alloc_tdl' > > Cc: Adrian Hunter <adrian.hunter@intel.com> > Cc: Ritesh Harjani <riteshh@codeaurora.org> > Cc: Asutosh Das <asutoshd@codeaurora.org> > Cc: Venkat Gopalakrishnan <venkatg@codeaurora.org> > Signed-off-by: Lee Jones <lee.jones@linaro.org> Acked-by: Adrian Hunter <adrian.hunter@intel.com> > --- > drivers/mmc/host/cqhci.c | 2 +- > 1 file changed, 1 insertion(+), 1 deletion(-) > > diff --git a/drivers/mmc/host/cqhci.c b/drivers/mmc/host/cqhci.c > index 75934f3c117eb..8cc277b4ffe9e 100644 > --- a/drivers/mmc/host/cqhci.c > +++ b/drivers/mmc/host/cqhci.c > @@ -144,7 +144,7 @@ static void cqhci_dumpregs(struct cqhci_host *cq_host) > CQHCI_DUMP(": ===========================================\n"); > } > > -/** > +/* > * The allocated descriptor table for task, link & transfer descritors > * looks like: > * |----------| >
WARNING: multiple messages have this Message-ID (diff)
From: Adrian Hunter <adrian.hunter@intel.com> To: Lee Jones <lee.jones@linaro.org>, ulf.hansson@linaro.org Cc: Venkat Gopalakrishnan <venkatg@codeaurora.org>, Ritesh Harjani <riteshh@codeaurora.org>, linux-kernel@vger.kernel.org, linux-arm-kernel@lists.infradead.org, Asutosh Das <asutoshd@codeaurora.org> Subject: Re: [PATCH 14/15] mmc: host: cqhci: Demote faux kerneldoc header down to basic comment block Date: Thu, 2 Jul 2020 09:43:19 +0300 [thread overview] Message-ID: <049e68ad-50fb-31d6-0a94-3f7c676a75e7@intel.com> (raw) In-Reply-To: <20200701124702.908713-15-lee.jones@linaro.org> On 1/07/20 3:47 pm, Lee Jones wrote: > cqhci_host_alloc_tdl()'s function header is the only one in > kerneldoc format. Which seems odd as it's not part of an > external API and isn't referenced anywhere else. Seeing as > there has also been no attempt to describe the expected > function arguments either, we're going to assume that this is > not actually a bona fide kerneldoc use-case. > > Fixes the following W=1 kernel build warning: > > drivers/mmc/host/cqhci.c:163: warning: Function parameter or member 'cq_host' not described in 'cqhci_host_alloc_tdl' > > Cc: Adrian Hunter <adrian.hunter@intel.com> > Cc: Ritesh Harjani <riteshh@codeaurora.org> > Cc: Asutosh Das <asutoshd@codeaurora.org> > Cc: Venkat Gopalakrishnan <venkatg@codeaurora.org> > Signed-off-by: Lee Jones <lee.jones@linaro.org> Acked-by: Adrian Hunter <adrian.hunter@intel.com> > --- > drivers/mmc/host/cqhci.c | 2 +- > 1 file changed, 1 insertion(+), 1 deletion(-) > > diff --git a/drivers/mmc/host/cqhci.c b/drivers/mmc/host/cqhci.c > index 75934f3c117eb..8cc277b4ffe9e 100644 > --- a/drivers/mmc/host/cqhci.c > +++ b/drivers/mmc/host/cqhci.c > @@ -144,7 +144,7 @@ static void cqhci_dumpregs(struct cqhci_host *cq_host) > CQHCI_DUMP(": ===========================================\n"); > } > > -/** > +/* > * The allocated descriptor table for task, link & transfer descritors > * looks like: > * |----------| > _______________________________________________ linux-arm-kernel mailing list linux-arm-kernel@lists.infradead.org http://lists.infradead.org/mailman/listinfo/linux-arm-kernel
next prev parent reply other threads:[~2020-07-02 6:44 UTC|newest] Thread overview: 58+ messages / expand[flat|nested] mbox.gz Atom feed top 2020-07-01 12:46 [PATCH 00/15] Clean-up MMC's W=1 build warnings Lee Jones 2020-07-01 12:46 ` Lee Jones 2020-07-01 12:46 ` [PATCH 01/15] mmc: core: quirks: Mark fixups as __maybe_unused Lee Jones 2020-07-01 12:46 ` Lee Jones 2020-07-01 12:46 ` [PATCH 02/15] mmc: core: sdio_io: Provide description for sdio_set_host_pm_flags()'s 'flag' arg Lee Jones 2020-07-01 12:46 ` Lee Jones 2020-07-01 12:46 ` [PATCH 03/15] mmc: core: regulator: Add missing documetation for 'mmc' and 'ios' Lee Jones 2020-07-01 12:46 ` Lee Jones 2020-07-01 12:46 ` [PATCH 04/15] mmc: host: sdhci-s3c: Provide documentation for missing struct properties Lee Jones 2020-07-01 12:46 ` Lee Jones 2020-07-05 23:53 ` Jaehoon Chung 2020-07-05 23:53 ` Jaehoon Chung 2020-07-01 12:46 ` [PATCH 05/15] mmc: host: mtk-sd: Demote msdc_recheck_sdio_irq() function header Lee Jones 2020-07-01 12:46 ` Lee Jones 2020-07-01 12:46 ` Lee Jones 2020-07-01 13:09 ` Matthias Brugger 2020-07-01 13:09 ` Matthias Brugger 2020-07-01 13:09 ` Matthias Brugger 2020-07-01 12:46 ` [PATCH 06/15] mmc: host: atmel-mci: Provide 2 new and correct 1 existing property description Lee Jones 2020-07-01 12:46 ` Lee Jones 2020-07-01 12:46 ` [PATCH 07/15] mmc: core: queue: Correct misspelling of 'mq' in mmc_init_request()'s docs Lee Jones 2020-07-01 12:46 ` Lee Jones 2020-07-01 12:46 ` [PATCH 08/15] mmc: host: dw_mmc-exynos: Add kerneldoc descriptions of for 'dev' args Lee Jones 2020-07-01 12:46 ` Lee Jones 2020-07-05 23:53 ` Jaehoon Chung 2020-07-05 23:53 ` Jaehoon Chung 2020-07-01 12:46 ` [PATCH 09/15] mmc: host: rtsx_pci_sdmmc: Remove set but unused variable 'err' Lee Jones 2020-07-01 12:46 ` Lee Jones 2020-07-01 12:46 ` [PATCH 10/15] mmc: host: rtsx_usb_sdmmc: " Lee Jones 2020-07-01 12:46 ` Lee Jones 2020-07-01 12:46 ` [PATCH 11/15] mmc: host: sdhci-of-arasan: Correct formatting and provide missing function arg(s) Lee Jones 2020-07-01 12:46 ` Lee Jones 2020-07-08 7:53 ` Michal Simek 2020-07-08 7:53 ` Michal Simek 2020-07-01 12:46 ` [PATCH 12/15] mmc: host: sdhci-msm: Staticify local function sdhci_msm_dump_vendor_regs() Lee Jones 2020-07-01 12:46 ` Lee Jones 2020-07-01 12:47 ` [PATCH 13/15] mmc: host: sdhci-msm: Demote faux kerneldoc header down to basic comment block Lee Jones 2020-07-01 12:47 ` Lee Jones 2020-07-01 12:47 ` [PATCH 14/15] mmc: host: cqhci: " Lee Jones 2020-07-01 12:47 ` Lee Jones 2020-07-02 6:43 ` Adrian Hunter [this message] 2020-07-02 6:43 ` Adrian Hunter 2020-07-01 12:47 ` [PATCH 15/15] mmc: host: sdhci-iproc: Tell the compiler that ACPI functions may not be used Lee Jones 2020-07-01 12:47 ` Lee Jones 2020-07-02 19:42 ` Scott Branden 2020-07-02 19:42 ` Scott Branden 2020-07-02 20:13 ` Lee Jones 2020-07-02 20:13 ` Lee Jones 2020-07-02 20:49 ` Scott Branden 2020-07-02 20:49 ` Scott Branden 2020-07-07 6:47 ` [PATCH v2 15/15] mmc: host: sdhci-iproc: Do not define 'struct acpi_device_id' when !CONFIG_ACPI Lee Jones 2020-07-07 6:47 ` Lee Jones 2020-07-07 15:47 ` Scott Branden 2020-07-07 15:47 ` Scott Branden 2020-07-08 13:20 ` Ulf Hansson 2020-07-08 13:20 ` Ulf Hansson 2020-07-07 6:50 ` [PATCH 00/15] Clean-up MMC's W=1 build warnings Ulf Hansson 2020-07-07 6:50 ` Ulf Hansson
Reply instructions: You may reply publicly to this message via plain-text email using any one of the following methods: * Save the following mbox file, import it into your mail client, and reply-to-all from there: mbox Avoid top-posting and favor interleaved quoting: https://en.wikipedia.org/wiki/Posting_style#Interleaved_style * Reply using the --to, --cc, and --in-reply-to switches of git-send-email(1): git send-email \ --in-reply-to=049e68ad-50fb-31d6-0a94-3f7c676a75e7@intel.com \ --to=adrian.hunter@intel.com \ --cc=asutoshd@codeaurora.org \ --cc=lee.jones@linaro.org \ --cc=linux-arm-kernel@lists.infradead.org \ --cc=linux-kernel@vger.kernel.org \ --cc=riteshh@codeaurora.org \ --cc=ulf.hansson@linaro.org \ --cc=venkatg@codeaurora.org \ /path/to/YOUR_REPLY https://kernel.org/pub/software/scm/git/docs/git-send-email.html * If your mail client supports setting the In-Reply-To header via mailto: links, try the mailto: linkBe sure your reply has a Subject: header at the top and a blank line before the message body.
This is an external index of several public inboxes, see mirroring instructions on how to clone and mirror all data and code used by this external index.