Re: [PATCH v2] Documentation: highmem: Use literal block for *kmap_local_folio() example

From: Matthew Wilcox
Date: Wed Jun 15 2022 - 22:21:57 EST


On Thu, Jun 16, 2022 at 08:38:38AM +0700, Bagas Sanjaya wrote:
> On 6/15/22 21:37, Matthew Wilcox wrote:
> > On Wed, Jun 15, 2022 at 05:15:10PM +0700, Bagas Sanjaya wrote:
> >> These warnings above are due to comments in code example of
> >> kmap_atomic() inside kernel-doc comment of *kmap_local_folio() are enclosed
> >
> > You still seem to think this has something to do with kmap_local_folio().
> > It has nothing to do with kmap_local_folio(). Your next version of this
> > patch should not mention kmap_local_folio() anywhere.
> >
>
> But I think mentioning kmap_local_folio() is necessary in the patch
> subject, because we know the original warning is pointed to kernel-doc
> comment of that funcion.

No it doesn't. It just gives a line number. At least, all you quoted
was the line number.