On Fri, Sep 04, 2020 at 04:36:31PM +0300, Jarkko Sakkinen wrote: > On Fri, Sep 04, 2020 at 03:25:07AM -0700, Sean Christopherson wrote: > > On Mon, Aug 24, 2020 at 10:49:41PM +0300, Jarkko Sakkinen wrote: > > > This documentation should be moved to Documentation/x86/sgx.rst. > > > > > > It is easier to read from there and then it will be included by kdoc > > > to the kernel documentation. In here it is not addressed by kdoc and > > > it is unnecessarily hard to read. > > > > I'm confused, this is all picked up by kernel-doc. What am I missing? > > Right of course, it is in the .h file now. Sorry, it is me being blind. No worries. > Was it before in the .S file? Yeah, it was originally in the .S file with an #ifdef hack to trick kernel-doc into parsing the comment. It got moved to the .h when the vDSO was changed to be directly callable from C.