On Wed, Nov 30 2022 at 01:59, Jason A. Donenfeld wrote: > On Tue, Nov 29, 2022 at 11:02:29PM +0100, Thomas Gleixner wrote: >> > + * Returns a pointer to the first state in the allocation. >> >> I have serious doubts that this statement is correct. > > "Returns the address of the first state in the allocation" is better I > guess. Does not even come close to correct. As my previous hint of 'using this as template for the (hint:missing) man page' did not work well, may I suggest that you look at the various return statements in that function and validate whether your proposed return value documentation is valid for all of them? Thanks, tglx