Re: [RFC] Add kernel-doc test script

From: Randy Dunlap
Date: Tue Nov 17 2020 - 19:24:17 EST


On 11/17/20 2:36 PM, Eduardo Habkost wrote:
> Add a kernel-doc test script to tools/testing/kernel-doc.
>
> radix_tree_lookup_slot test case provided by Matthew Wilcox.
>
> Signed-off-by: Eduardo Habkost <ehabkost@xxxxxxxxxx>

Very good idea.

I have had a kernel-doc test source file for (?) 10-12 years,
while I was the docs maintainer.

I didn't have the "expected" files for comparison.
I just used $web_browser.

> ---
> tools/testing/kernel-doc/test-case.h | 111 ++++++++++
> .../testing/kernel-doc/test-case.man.expected | 150 ++++++++++++++
> .../kernel-doc/test-case.none.expected | 0
> .../kernel-doc/test-case.rst2.expected | 195 ++++++++++++++++++
> .../kernel-doc/test-case.rst3.expected | 195 ++++++++++++++++++
> tools/testing/kernel-doc/test.sh | 90 ++++++++
> 6 files changed, 741 insertions(+)
> create mode 100644 tools/testing/kernel-doc/test-case.h
> create mode 100644 tools/testing/kernel-doc/test-case.man.expected
> create mode 100644 tools/testing/kernel-doc/test-case.none.expected
> create mode 100644 tools/testing/kernel-doc/test-case.rst2.expected
> create mode 100644 tools/testing/kernel-doc/test-case.rst3.expected
> create mode 100755 tools/testing/kernel-doc/test.sh

thanks.
--
~Randy