On 09/10/2018 02:07 PM, Jarkko Sakkinen wrote: > On Mon, Sep 10, 2018 at 11:57:49AM -0700, Dave Hansen wrote: >> On 09/10/2018 11:21 AM, Sakkinen, Jarkko wrote: >>>> +/* >>>> + * Encrypted mprotect is only supported on anonymous mappings. >>>> + * All VMA's in the requested range must be anonymous. If this >>>> + * test fails on any single VMA, the entire mprotect request fails. >>>> + */ >>> kdoc >> kdoc what? You want this comment in kdoc format? Why? > If there is a header comment for a function anyway, why wouldn't you > put it to kdoc-format? Because this is a shorter and more concise way to document the function. kdoc isn't universally the best thing to do for function comments.