Received: by 2002:a05:6a10:16a7:0:0:0:0 with SMTP id gp39csp4268717pxb; Tue, 17 Nov 2020 16:27:55 -0800 (PST) X-Google-Smtp-Source: ABdhPJz2OBJxT0PcV/hEnlUvbIgbJNGMGEma53iRqAR9KssvWsw+Y554KqCvpuTSNhJTGh8FOtWH X-Received: by 2002:a17:906:dbd6:: with SMTP id yc22mr1035105ejb.252.1605659274997; Tue, 17 Nov 2020 16:27:54 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1605659274; cv=none; d=google.com; s=arc-20160816; b=NfNxTpL3WgbG0HhpDwftSzU+Qwb5DVtzfm0w4pdmciKHFkxhkvG0UK7YUb4G+pbgFu yo9E6e6hH0WvacxjpKMbcnwwiLuoykU3/O0qqWPHP9GD+xTx1kD84ZNGEUhX18psnY8I mlkrlG5bZxd8n733REa6ZsnJWolK/b8QlzqRC+9viWGU8dlLBOvD6f5aivQb0lArhd+D yQOwOX8otpU90vg7x8IHtsg0JJoLZp92i7Lg8fDlWJCeZmzThUn+ajuP0uWuj0I1j2G1 zdqKoQoveVPDOm0rzPlH/taIHhalXlLzo4j2hwLrTxAhkQhzDMtfR3OUR/wV8O9wX+nV rFmw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:content-language :in-reply-to:mime-version:user-agent:date:message-id:from:references :cc:to:subject:dkim-signature; bh=x66IiCb3J78ZY3ZCN379wprOnWskvKlwPEBSJOmY+qk=; b=F0b1kw8JRz9a6usZzvT6IE7D+QdWCq3n/nUJnjoE1q0Bt61rLqSqbjOnBmgrIbUYk6 RG/UYdv5m4D4k4t/+PSrMZxX5tMGrfS0VCftyjirg4+HaQigpShhfAjVelxDJbSgVZNk A5Nb5bdkBIIpTyd9+Itb77wxYS3T2HeWHGtEcPwvQHRsTowULaEXP+nB7TXXN0MeqTUv 9Fy+yCpZjqiQtIBriAZ4RCJHt3FUhGTlnVIUKqCuRAVyuX4jOuha69m3XLqszG2IP9HX kEd7Aimg65atyxc35Cijj7QRRE+vWboAEMphBqlOn6DKOtoa3JNk7oDK6UyqkOsv3S+H d6Zw== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@infradead.org header.s=casper.20170209 header.b="h/ilHSI/"; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Return-Path: Received: from vger.kernel.org (vger.kernel.org. [23.128.96.18]) by mx.google.com with ESMTP id v9si13658548edb.48.2020.11.17.16.27.31; Tue, 17 Nov 2020 16:27:54 -0800 (PST) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) client-ip=23.128.96.18; Authentication-Results: mx.google.com; dkim=pass header.i=@infradead.org header.s=casper.20170209 header.b="h/ilHSI/"; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1726274AbgKRAX4 (ORCPT + 99 others); Tue, 17 Nov 2020 19:23:56 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:49806 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1725767AbgKRAXz (ORCPT ); Tue, 17 Nov 2020 19:23:55 -0500 Received: from casper.infradead.org (casper.infradead.org [IPv6:2001:8b0:10b:1236::1]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 6DE56C0613CF; Tue, 17 Nov 2020 16:23:55 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=infradead.org; s=casper.20170209; h=Content-Transfer-Encoding:Content-Type: In-Reply-To:MIME-Version:Date:Message-ID:From:References:Cc:To:Subject:Sender :Reply-To:Content-ID:Content-Description; bh=x66IiCb3J78ZY3ZCN379wprOnWskvKlwPEBSJOmY+qk=; b=h/ilHSI//Cj40icPF5NAyf72zk oJ2mH8JAKNXT8MvGjd3tA/Ej26ljvchcRTuv5EyhszSepD7NWHZ+Z+pOWObqA+KdnBsCqV/pXmy5N PZwBWzPa1wn0PM63RCJZ5yARcc9ZPO47HlrQwOTMkEYKze79YmLVHuG9yOluaCsZcTOnhaOBphZoZ z+MwcBvumcMA7Ak/HKM6/lLkDvM+nknrtIF/Awt/aF9Y8N3rKM4FVPgVxBiO1elcPG5LIkIM+WwTZ cn8/q0wbw1Rv6QcaujlyJv/jO2uPNMXCbYOVF2x3/e7aIAE+tj9bjU22BQSyJMR/X/qo3pXxQqoEU ddU/0ZTw==; Received: from [2601:1c0:6280:3f0::bcc4] by casper.infradead.org with esmtpsa (Exim 4.92.3 #3 (Red Hat Linux)) id 1kfBGK-0006C5-SH; Wed, 18 Nov 2020 00:23:53 +0000 Subject: Re: [RFC] Add kernel-doc test script To: Eduardo Habkost , Matthew Wilcox Cc: Jonathan Corbet , Paolo Bonzini , linux-kernel@vger.kernel.org, linux-doc@vger.kernel.org References: <20201030144713.201372-1-pbonzini@redhat.com> <20201030144713.201372-3-pbonzini@redhat.com> <20201113152106.7b4a07ee@lwn.net> <20201113223912.GK17076@casper.infradead.org> <20201117212452.GM1235237@habkost.net> <20201117213051.GA29991@casper.infradead.org> <20201117223612.GN1235237@habkost.net> From: Randy Dunlap Message-ID: <16145b8b-3213-8bc9-1826-d3ae006f78fa@infradead.org> Date: Tue, 17 Nov 2020 16:23:49 -0800 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:68.0) Gecko/20100101 Thunderbird/68.12.0 MIME-Version: 1.0 In-Reply-To: <20201117223612.GN1235237@habkost.net> Content-Type: text/plain; charset=utf-8 Content-Language: en-US Content-Transfer-Encoding: 7bit Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org 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 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