From patchwork Wed May 4 22:51:51 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Frank Rowand X-Patchwork-Id: 12838839 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 5488DC433EF for ; Wed, 4 May 2022 22:56:29 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S240670AbiEDW6x (ORCPT ); Wed, 4 May 2022 18:58:53 -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 Precedence: bulk List-ID: X-Mailing-List: linux-kselftest@vger.kernel.org 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 '=' signs: Documentation/dev-tools/ktap.rst:3: WARNING: Title overline too short. =================================================== The Kernel Test Anything Protocol (KTAP), version 2-rc =================================================== 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/ktap.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 =================================================== -The Kernel Test Anything Protocol (KTAP), version 1 +The Kernel Test Anything Protocol (KTAP), version 2-rc =================================================== TAP, or the Test Anything Protocol is a format for specifying test results used From patchwork Wed May 4 22:51:52 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Frank Rowand X-Patchwork-Id: 12838763 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 80B25C433F5 for ; Wed, 4 May 2022 22:55:08 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1379828AbiEDW6l (ORCPT ); Wed, 4 May 2022 18:58:41 -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 Precedence: bulk List-ID: X-Mailing-List: linux-kselftest@vger.kernel.org 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/ktap.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 with. For example: - "KTAP version 1" +- "KTAP version 2" - "TAP version 13" - "TAP version 14" @@ -46,7 +47,7 @@ Note that, in KTAP, subtests also begin with a version line, which denotes the start of the nested test results. This differs from TAP14, which uses a separate "Subtest" line. -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 versions listed here for compatibility with existing tests and frameworks. @@ -204,9 +205,9 @@ An example of a test with two nested subtests: .. code-block:: none - 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 testing: .. code-block:: none - 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 - 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