Re: [PATCH] scripts/lib/kdoc: apply pending TODO renames

[Jonathan Corbet <corbet@lwn.net>]

Sanjai <sanjai@myyahoo.com> writes:

> The TODO comments requested these renames after the removal of
> kernel-doc.pl.
> kernel-doc.pl was removed in commit 683e8cbaba7f
> ("docs: remove kernel-doc.pl"),
>
> so the renames can now be applied:
>
> - rename emit_msg() to emit_message()
> - rename output_declaration() to store_declaration()
>
> Signed-off-by: Sanjai <sanjai@myyahoo.com>
> ---
>  tools/lib/python/kdoc/kdoc_parser.py | 86 ++++++++++++++--------------
>  1 file changed, 42 insertions(+), 44 deletions(-)

Perhaps the new name is a better one, but what is the real benefit to
the kernel from this much churn.  That is an especially pertinent
question when there is a lot of other kernel-doc work going on that will
surely end up conflicting with this sort of change...?

Thanks,

jon