On Wed, 07 Dec 2016, Daniel Vetter <daniel.vetter at ffwll.ch> wrote: > Spotted while auditing our ioctl table. Also nuke the > not-really-kerneldoc comments, we don't document internals and > definitely don't want to mislead people with the old dragons.
Not just specific to this patch, but I'm not sure I agree with the "we don't document internals" in general. That seems to be something that just started happening without much discussion. We have *loads* of complicated functions that would benefit from documentation, even if they're internal (i.e. not exported). BR, Jani. -- Jani Nikula, Intel Open Source Technology Center