Mauro Carvalho Chehab <mchehab@xxxxxxxxxx> writes: > This is a follow-up of the discussions taken here: > > https://lore.kernel.org/linux-doc/20230704132812.02ba97ba@maurocar-mobl2/T/#t > > I sent a previous version as RFC. This is basically what we had there, with some > improvements at test_list.py. > > It adds a new extension that allows documenting tests using the same tool we're > using for DRM unit tests at IGT GPU tools: https://gitlab.freedesktop.org/drm/igt-gpu-tools. > > While kernel-doc has provided documentation for in-lined functions/struct comments, > it was not meant to document tests. > > Tests need to be grouped by the test functions. It should also be possible to produce > other outputs from the documentation, to integrate it with test suites. For instance, > Internally at Intel, we use the comments to generate DOT files hierarchically grouped > per feature categories. > > This is meant to be an initial series to start documenting kunit. I've played with this a bit...a couple of quick impressions: - That's quite a chunk of Python code to be adding. I've not yet had the chance to read it through properly, will hopefully be able to do so soon. A bit more commenting would not have gone amiss here... - I kind of think that this should go under dev-tools rather than being a new top-level directory. Is there a reason not to put it there? Thanks, jon
