Re: linux-next: build warning after merge of the rcu tree

From: Paul E. McKenney
Date: Mon Dec 07 2020 - 11:47:46 EST


On Mon, Dec 07, 2020 at 07:20:28PM +1100, Stephen Rothwell wrote:
> Hi all,
>
> After merging the rcu tree, today's linux-next build (htmldocs) produced
> this warning:
>
> Documentation/core-api/mm-api:49: mm/slab_common.c:569: WARNING: Inline literal start-string without end-string.
> Documentation/core-api/mm-api:49: mm/slab_common.c:595: WARNING: Inline literal start-string without end-string.
>
> Maybe introduced by commit
>
> f7c3fb4fc476 ("mm: Add kmem_last_alloc() to return last allocation for memory block")
>
> (or one of the following ones).

I freely confess that I have absolutely no idea what it doesn't like.
It is complaining about this header comment, correct?

/**
* kmem_last_alloc_stack - Get return address and stack for last allocation
* @object: object for which to find last-allocation return address.
* @stackp: %NULL or pointer to location to place return-address stack.
* @nstackp: maximum number of return addresses that may be stored.
*
* If the pointer references a slab-allocated object and if sufficient
* debugging is enabled, return the return address for the corresponding
* allocation. If stackp is non-%NULL in %CONFIG_STACKTRACE kernels running
* the slub allocator, also copy the return-address stack into @stackp,
* limited by @nstackp. Otherwise, return %NULL or an appropriate error
* code using %ERR_PTR().
*
* Return: return address from last allocation, %NULL or negative error code.
*/

Thanx, Paul