From nobody Fri May 8 11:23:41 2026 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id 64669C35296 for ; Wed, 4 May 2022 23:07:42 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1381947AbiEDXFf (ORCPT ); Wed, 4 May 2022 19:05:35 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:46228 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1379520AbiEDW6J (ORCPT ); Wed, 4 May 2022 18:58:09 -0400 Received: from mail-io1-xd30.google.com (mail-io1-xd30.google.com [IPv6:2607:f8b0:4864:20::d30]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 2E13053A7F; Wed, 4 May 2022 15:52:03 -0700 (PDT) Received: by mail-io1-xd30.google.com with SMTP id o190so3054250iof.10; Wed, 04 May 2022 15:52:03 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=from:to:cc:subject:date:message-id:in-reply-to:references :mime-version:content-transfer-encoding; bh=N4IM2LeuBxLjZOXI4Ac+itNTVFMU+JztF68jOZmjG9Q=; b=q1aYKbBjaX3cEmdXnV9RE0f59cZqJopxNNmkQ5+M5CRU4vjlKL22zb2e66ZDJSSDFs tyBFpf7BAhvO2MyJ3tdgS392YiOk1hKSAHozAX6LDrjXtxZgXTM9adnM8/qANvw37Z2n NwkTxHvFAOV5ej3T0RHCBg60hUWy9Sspo4sN1XEZmCGbeuArKLs5DTejC/hnhJcd7juj R4uqcOs5S5EJuyz6rJhRxGylwpsbYjAs9kV4HesTFG1rL6Fxhh2pqpSxGq76c4Jtb736 JpFQQI/R36/PglqCbmi9cEJf/K1woE2fMPRws/QkX2LKmHubgkt8V+yGytyhk19Rj4si 70GA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references:mime-version:content-transfer-encoding; bh=N4IM2LeuBxLjZOXI4Ac+itNTVFMU+JztF68jOZmjG9Q=; b=k+0QvcsJ4m7oUNeRklPa+DWCf0yJKdumVsYI1R9YJgbvCbFTxNsOq/P6ly9KZI/9qZ 6cRyu0Uiofrd+BPXRMiAcbpEyeaBhwZwPqPYArvPyGdMMbu6KQzrSUetBS2lpK9SXfuc lNoXxegZzfGQYdudD4wV9OOVNcUkHlrSARcH59GvARrFY9LpnEjMfomC9cKvyh5n1A+U crWygdaAaxBe+K1S4dVywsmaVRQSDOXcfJbOA+DhC2xK2KjcF9zfpooPgtqRcEhXpZ5m IBVpkEOB//bVmxkzNbdbUnlW24dX2AayBSRKkDI+TC+vWPdHQRXHE45zNPUNBDcCEVIe 6EeA== X-Gm-Message-State: AOAM531xmqqszg/REhLjGuZEIL3HhxirICPnudpAh0oKZK5Hw2yj4YXQ 4EDvfgo9TH1Xeg1KnIHztBY= X-Google-Smtp-Source: ABdhPJzriMH8Zg3BqmSxGLS9g9rQRt9WUwBzLpDDk8CXMJ4QPnos7XK8RBHz2OynQMhHnhCCZz/2IQ== X-Received: by 2002:a05:6638:24d2:b0:32a:caa9:e679 with SMTP id y18-20020a05663824d200b0032acaa9e679mr10419338jat.41.1651704720842; Wed, 04 May 2022 15:52:00 -0700 (PDT) Received: from xps8900.attlocal.net ([2600:1700:2442:6db0:94d4:5fe2:e117:e7c3]) by smtp.gmail.com with ESMTPSA id i25-20020a02b699000000b0032b608e2926sm66372jam.9.2022.05.04.15.52.00 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 04 May 2022 15:52:00 -0700 (PDT) From: frowand.list@gmail.com To: Frank Rowand , David Gow , Shuah Khan , Kees Cook , Tim.Bird@sony.com, Brendan Higgins Cc: Jonathan Corbet , rmr167@gmail.com, guillaume.tucker@collabora.com, dlatypov@google.com, kernelci@groups.io, kunit-dev@googlegroups.com, linux-kselftest@vger.kernel.org, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org Subject: [PATCH v2 1/2] ktap_v2: change version to 2-rc in KTAP specification Date: Wed, 4 May 2022 17:51:51 -0500 Message-Id: <20220504225152.1451440-2-frowand.list@gmail.com> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20220504225152.1451440-1-frowand.list@gmail.com> References: <20220504225152.1451440-1-frowand.list@gmail.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Type: text/plain; charset="utf-8" From: Frank Rowand Prepare KTAP Specification for the process of creating version 2. The version will remain "2-rc" until the final commit to complete Version 2. Adding the "-rc" ensures that none of the development versions will be mistaken for the completed version 2. After this commit, Sphinx complains that we now need more '=3D' signs: Documentation/dev-tools/ktap.rst:3: WARNING: Title overline too short. =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D The Kernel Test Anything Protocol (KTAP), version 2-rc =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D This warning will disappear in the final commit for the release of version 2, when the "-rc" is removed. Signed-off-by: Frank Rowand --- Documentation/dev-tools/ktap.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Documentation/dev-tools/ktap.rst b/Documentation/dev-tools/kta= p.rst index 5ee735c6687f..37b5dc61bfb8 100644 --- a/Documentation/dev-tools/ktap.rst +++ b/Documentation/dev-tools/ktap.rst @@ -1,7 +1,7 @@ .. SPDX-License-Identifier: GPL-2.0 =20 =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D -The Kernel Test Anything Protocol (KTAP), version 1 +The Kernel Test Anything Protocol (KTAP), version 2-rc =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D =20 TAP, or the Test Anything Protocol is a format for specifying test results= used --=20 Frank Rowand From nobody Fri May 8 11:23:41 2026 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id EE433C3527C for ; Wed, 4 May 2022 23:07:40 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1381604AbiEDXFU (ORCPT ); Wed, 4 May 2022 19:05:20 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:45462 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1379277AbiEDW6K (ORCPT ); Wed, 4 May 2022 18:58:10 -0400 Received: from mail-io1-xd2a.google.com (mail-io1-xd2a.google.com [IPv6:2607:f8b0:4864:20::d2a]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id DCB4D5469A; Wed, 4 May 2022 15:52:06 -0700 (PDT) Received: by mail-io1-xd2a.google.com with SMTP id r27so3077787iot.1; Wed, 04 May 2022 15:52:06 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=from:to:cc:subject:date:message-id:in-reply-to:references :mime-version:content-transfer-encoding; bh=qPy6cGZiVn9/0omaO+YfLe4SKbdSU3+fUcFNm6w49Kc=; b=Z5e4PVqRZ3ZwoKj8x9aPrzkkAEc0QVBpouupChjpPGGs4ajRWKxB6FZqVsoR2YAGBt eCzrjaFYsRh5fEZA7ef7WccYCWAerqmiVC1zHW6jHk0KfmPtLgnZ/ThACwcGsmkC4Kty hzTHeyQDQTOmoVIIkT2H3HWXY5/v2bCbc89iuDJdLyDWaj1NKGnn9p/hyC81o/GTk46H 6d+OsQqZzSH2MElJy8Q/EL4ZXfRu06OY0w9Do835t34y/O23+meMHNRG/p7W6XT9rij8 pFLMC353sef/SqIO/cDIABK+IDr5lp1lDNQtuzoOtxfCbSrggYOFD4coy+ZvuFpJNlWy X9vw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references:mime-version:content-transfer-encoding; bh=qPy6cGZiVn9/0omaO+YfLe4SKbdSU3+fUcFNm6w49Kc=; b=cFmahDDmHHD9HCMz3BuqdTQznHQr3x5ARtqcnAByhRrN7LBq3qUlWU7sAlvKVebti5 RCaAZp0sE7dITU22bv4c4zvUMMIK+oqjqXGiu4M26qizGdfX13VStGKhqTD29Fjte9GE pvqWnXSt6e8+8yovo57r2mTAiDnW/clYWwpUl5fT/uTWHcwQlmZ2pYP//xNUQ3oTyhQ7 rywXId35jX9EdozOnpMFRN+cvJIeR1TmL4VyRAO35OQB4hOtVt59e4LBUbVTK6NSZDDy FJdV4cNmP7bTSSuQsO/4keO160RTVHSE925jujDN/vG1nJE1pRxNJjP29NCUgX4T5g7I dXqw== X-Gm-Message-State: AOAM530dpB/vlGryv9clHPhF1YstvcdcNj+TdZZBSvBaDOLxTOl1ad9U ENttdBVK9b5NGUsRJmIdOjA= X-Google-Smtp-Source: ABdhPJzSQVwE7Bb+9mGRgCfNyffXiYGtwDfkeBKWE6u3UzUmpHek9/hw9VzPJkOGmhwIFOTMJskXFA== X-Received: by 2002:a05:6638:144b:b0:321:589b:a8ea with SMTP id l11-20020a056638144b00b00321589ba8eamr10245216jad.296.1651704721781; Wed, 04 May 2022 15:52:01 -0700 (PDT) Received: from xps8900.attlocal.net ([2600:1700:2442:6db0:94d4:5fe2:e117:e7c3]) by smtp.gmail.com with ESMTPSA id i25-20020a02b699000000b0032b608e2926sm66372jam.9.2022.05.04.15.52.00 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 04 May 2022 15:52:01 -0700 (PDT) From: frowand.list@gmail.com To: Frank Rowand , David Gow , Shuah Khan , Kees Cook , Tim.Bird@sony.com, Brendan Higgins Cc: Jonathan Corbet , rmr167@gmail.com, guillaume.tucker@collabora.com, dlatypov@google.com, kernelci@groups.io, kunit-dev@googlegroups.com, linux-kselftest@vger.kernel.org, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org Subject: [PATCH v2 2/2] ktap_v2: change "version 1" to "version 2" in examples Date: Wed, 4 May 2022 17:51:52 -0500 Message-Id: <20220504225152.1451440-3-frowand.list@gmail.com> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20220504225152.1451440-1-frowand.list@gmail.com> References: <20220504225152.1451440-1-frowand.list@gmail.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Type: text/plain; charset="utf-8" From: Frank Rowand Change the "version line" in example output from "KTAP version 1" to "KTAP version 2". Change version that should be used by compliant tests from 1 to 2. Signed-off-by: Frank Rowand --- Documentation/dev-tools/ktap.rst | 23 ++++++++++++----------- 1 file changed, 12 insertions(+), 11 deletions(-) diff --git a/Documentation/dev-tools/ktap.rst b/Documentation/dev-tools/kta= p.rst index 37b5dc61bfb8..c78bb46a4430 100644 --- a/Documentation/dev-tools/ktap.rst +++ b/Documentation/dev-tools/ktap.rst @@ -39,6 +39,7 @@ version of the (K)TAP standard the result is compliant wi= th. =20 For example: - "KTAP version 1" +- "KTAP version 2" - "TAP version 13" - "TAP version 14" =20 @@ -46,7 +47,7 @@ Note that, in KTAP, subtests also begin with a version li= ne, which denotes the start of the nested test results. This differs from TAP14, which uses a separate "Subtest" line. =20 -While, going forward, "KTAP version 1" should be used by compliant tests, = it +While, going forward, "KTAP version 2" should be used by compliant tests, = it is expected that most parsers and other tooling will accept the other vers= ions listed here for compatibility with existing tests and frameworks. =20 @@ -204,9 +205,9 @@ An example of a test with two nested subtests: =20 .. code-block:: none =20 - KTAP version 1 + KTAP version 2 1..1 - KTAP version 1 + KTAP version 2 1..2 ok 1 test_1 not ok 2 test_2 @@ -217,11 +218,11 @@ An example format with multiple levels of nested test= ing: =20 .. code-block:: none =20 - KTAP version 1 + KTAP version 2 1..2 - KTAP version 1 + KTAP version 2 1..2 - KTAP version 1 + KTAP version 2 1..2 not ok 1 test_1 ok 2 test_2 @@ -252,21 +253,21 @@ Example KTAP output -------------------- .. code-block:: none =20 - KTAP version 1 + KTAP version 2 1..1 - KTAP version 1 + KTAP version 2 1..3 - KTAP version 1 + KTAP version 2 1..1 # test_1: initializing test_1 ok 1 test_1 ok 1 example_test_1 - KTAP version 1 + KTAP version 2 1..2 ok 1 test_1 # SKIP test_1 skipped ok 2 test_2 ok 2 example_test_2 - KTAP version 1 + KTAP version 2 1..3 ok 1 test_1 # test_2: FAIL --=20 Frank Rowand