Re: [PATCH] [v2] Documentation: document ktime_get_*() APIs

From: Jonathan Corbet
Date: Mon Jul 23 2018 - 11:23:09 EST


On Tue, 10 Jul 2018 16:46:41 +0200
Arnd Bergmann <arnd@xxxxxxxx> wrote:

> As Dave Chinner points out, we don't have a proper documentation for the
> ktime_get() family of interfaces, making it rather unclear which of the
> over 30 (!) interfaces one should actually use in a driver or elsewhere
> in the kernel.
>
> I wrote up an explanation from how I personally see the interfaces,
> documenting what each of the functions do and hopefully making it a bit
> clearer which should be used where.
>
> This is the first time I tried writing .rst format documentation, so
> in addition to any mistakes in the content, I probably also introduce
> nonstandard formatting ;-)

It looks good to me - I guess you really can teach an old dog new
tricks :)

I've (finally) applied this, thanks.

jon