On Tue, 5 Dec 2023 15:10:50 +0000 Russell King (Oracle) wrote: > I've raised this before in other subsystems, and it's suggested that > it's better to have it in the .c file. I guess the reason is that it's > more obvious that the function is documented when modifying it, so > there's a higher probability that the kdoc will get updated when the > function is altered. Plus I think people using IDEs (i.e. not me) may use the "jump to definition" functionality, to find the doc? TBH I thought putting kdoc in the C source was documented in the coding style, but I can't find any mention of it now.
