On Tue, Nov 05, 2019 at 12:36:59AM +0200, Jarkko Sakkinen wrote: > On Mon, Nov 04, 2019 at 01:21:22PM -0800, Sean Christopherson wrote: > > On Mon, Nov 04, 2019 at 10:01:41PM +0200, Jarkko Sakkinen wrote: > > > The subordinate clause of last sentence of the sgx_ioc_enclave_pages() > > > does not provide any insight not already provided. Thus, remove it. > > > > Isn't the whole point of the documentation to help the user understand > > *how* to use the API, not simply state exactly what the code does? > > For kdoc it should explain in clear and concise way ... what the function does. /Jarkko
