Re: [PATCH v3 1/2] media: vimc: stream: add missing function documentation

From: Mauro Carvalho Chehab
Date: Fri Jun 21 2019 - 17:17:15 EST


Em Mon, 17 Jun 2019 10:32:20 -0300
Andrà Almeida <andrealmeid@xxxxxxxxxxxxx> escreveu:

> Add comments at vimc_streamer_s_stream and vimc_streamer_thread, making
> the vimc-stream totally documented.

I'm applying it right now.

Yet, if this is fully documented, IMO you should add it to
Documentation/media/v4l-drivers, replacing the comments to kernel-doc
markups.

That would make easier for the ones to read the comments and, if someone
changes a function call, warnings will be produced, and the developer
will be warned.

Thanks,
Mauro