From patchwork Mon Aug 29 23:31:49 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Frank Rowand X-Patchwork-Id: 12958536 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 DB188ECAAD4 for ; Mon, 29 Aug 2022 23:32:42 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S229651AbiH2Xcl (ORCPT ); Mon, 29 Aug 2022 19:32:41 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:45378 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229488AbiH2Xcj (ORCPT ); Mon, 29 Aug 2022 19:32:39 -0400 Received: from mail-oa1-x2e.google.com (mail-oa1-x2e.google.com [IPv6:2001:4860:4864:20::2e]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id CEB3282848; Mon, 29 Aug 2022 16:32:38 -0700 (PDT) Received: by mail-oa1-x2e.google.com with SMTP id 586e51a60fabf-11c5505dba2so12935167fac.13; Mon, 29 Aug 2022 16:32:38 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc; bh=zCCrxwttgbjoHUFJXgo6b/XsRuRpmo/BC4fXPdswmEY=; b=kz3FwI+wQpYmECto1j3t7UVr+XwvZi9hNcExNwUFXNxa5r/hFFG8/DswIEPj7xVSBU qWHiaRhMEEy8z+D1svO+bGldvLZBTRjbdJj0LfL3ty+A5jPOvT8jVKz456ZHzjWHTuGR bP1Wv/vTiqQWYfOxbuKUaHvtuCpG624OILzqCkvUDCf6kuZ/IHpYWkf0odGha8jhEy2C DKPmqH8/bKMF/54p0eEG89FDEDV9vAbqihLxosQm9+YQDNmQLSSY6+N6KlYygsigO1ZO WK5uLjfq2po8cSa30xwtujNdvGLU88SAfjT4tNAtohSQNupNKdP7Bf+R95c95/8R6qKn z7qA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-message-state:from:to:cc; bh=zCCrxwttgbjoHUFJXgo6b/XsRuRpmo/BC4fXPdswmEY=; b=P+7OWO/Ei4h5KpTG7Iy2Qk8I3LzebePF8lx+/mcMg5UxwDdkAlj75x/pQCCHzobnwC kPJNM8a0AV4096WP/7HA0x9E/Q/iHBqxBov2gVUwhNa4QMR9fpq0yDY/BeFFZ9+uBBLO 4oAkX3hRyZ+q23UwH/Gr6VeRM4vLgrxaBd4Jy6gTxhcZR66OUryxxt0QAf4f+eYwdsZZ 6Uh0fOMMvIqwEla1e69fnfQQjD8IH7hwWfKGLHLhuQ9lqJVuGM4XLY6Qh59RDbrun/1e eHgtgW4jgsZkG3ebh0WIfz0tjvC6nmwcznuD7pTGgypIR2vTKaO7fakgPEEcJpYqGOdx Jl3A== X-Gm-Message-State: ACgBeo12o2OD7D8sUbv7+s3oLzweXkIU7staKSDY9c6hA9bTNJ9wUcAH sTT+w7RN0nUwgA1KTvZb5iObOkS0368= X-Google-Smtp-Source: AA6agR4Xp2gdmkaqUZy4gjFgnGcMvbPg7exr/0seoU1LHcMYmt7U8xiB6w5TKWzNoQSGQ5UCZPW0cQ== X-Received: by 2002:a05:6870:240d:b0:11e:ff35:5ce8 with SMTP id n13-20020a056870240d00b0011eff355ce8mr3069268oap.232.1661815958106; Mon, 29 Aug 2022 16:32:38 -0700 (PDT) Received: from xps8900.attlocal.net ([2600:1700:2442:6db0:dd06:f7b4:b579:6561]) by smtp.gmail.com with ESMTPSA id bu28-20020a0568300d1c00b0063b24357269sm4183611otb.13.2022.08.29.16.32.36 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 29 Aug 2022 16:32:37 -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 v3 1/2] ktap_v2: change version to 2-rc in KTAP specification Date: Mon, 29 Aug 2022 18:31:49 -0500 Message-Id: <20220829233150.3564612-2-frowand.list@gmail.com> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20220829233150.3564612-1-frowand.list@gmail.com> References: <20220829233150.3564612-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 d0a9565b0f44..b9a57ceddd4f 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 Mon Aug 29 23:31:50 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Frank Rowand X-Patchwork-Id: 12958537 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 2E110C0502E for ; Mon, 29 Aug 2022 23:32:44 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S229684AbiH2Xcm (ORCPT ); Mon, 29 Aug 2022 19:32:42 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:45388 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229601AbiH2Xck (ORCPT ); Mon, 29 Aug 2022 19:32:40 -0400 Received: from mail-ot1-x32d.google.com (mail-ot1-x32d.google.com [IPv6:2607:f8b0:4864:20::32d]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 225D980F57; Mon, 29 Aug 2022 16:32:40 -0700 (PDT) Received: by mail-ot1-x32d.google.com with SMTP id 6-20020a9d0106000000b0063963134d04so6990662otu.3; Mon, 29 Aug 2022 16:32:40 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc; bh=pcwb/p5+jybv9fHerrohgcSzr7MnKBdlSMhQ4dihg0o=; b=C7J0eUMt5+vJdczODpeq86N9bO2dDO1VQb/5YrmWv1PMUiRDIjHFGP2gaJk9xmOSG/ WsBif31jiznmqa21fK1NRx9m+oNgiG0cmEwJ9KstmIncsvQ9j11wNaZqEFUH4SR0P5vq iWFQZu5mjBB4G6K0jLMq/n/tqm3+73TUqRZHuGvtZAVnM8Ee9USrxzcg2OW+OTgoC3Zm wsKSQiKu5TNJFwPAcLxz+DtmO3ysL8kr30Ks26Le2Xw3ZgFJHm6p8/NCJsdjPFPXZ2R5 mHYl7TQ6WYVU1R/L+MKO3De7e7yo2CldLaSZ5a1ZfQ4Z94dNUK1fFNzd+rMaWUU0IraQ hqTA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-message-state:from:to:cc; bh=pcwb/p5+jybv9fHerrohgcSzr7MnKBdlSMhQ4dihg0o=; b=mCo2yCi+BaMo4wpx7K6VJsLZpy8Ox6CSf3uaq5qlwmMYlciKopAUXkdvNUYUqtuXD9 oDjWufNuUP2hf5lzmcMrL68n3BI3mjFRQSHorJICmHtbHPbicPrsbXBJCULGUl5P6NHc aOekpOLI9YRu7ZXpDPfN+iLruek/CKZOaBG0kqVG64OSI+Q7mEUNLtDBGQrurIOry/iD Ikr2qtmC6vayIbshdAiUuJtPMdjTqMO1e8t6JNsc4QqC5BLed8iVAzeWr1Lu4jqXl6tX /xxHGvuAtUi7N9obpwbla95Ra9k+/ngV33ThQAyf8fyfSvVyiLNnaKOSSe8h3mdab+75 v8RQ== X-Gm-Message-State: ACgBeo30W+p4zZVGjlws7WOgZ6qnxVu5wJFYm5ZEcdxitLBQZ8rnZEqj t+jmAM+olu6qbfc8m7bSs48= X-Google-Smtp-Source: AA6agR7so/qOD3k8QI/sorSQtm+h9+oaifcFsM0/9jO8R7DDJjiEXSC/Y8aivOkbLfXussd2YDsOdg== X-Received: by 2002:a9d:12d:0:b0:639:41f8:df09 with SMTP id 42-20020a9d012d000000b0063941f8df09mr7417644otu.98.1661815959492; Mon, 29 Aug 2022 16:32:39 -0700 (PDT) Received: from xps8900.attlocal.net ([2600:1700:2442:6db0:dd06:f7b4:b579:6561]) by smtp.gmail.com with ESMTPSA id bu28-20020a0568300d1c00b0063b24357269sm4183611otb.13.2022.08.29.16.32.38 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 29 Aug 2022 16:32:39 -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 v3 2/2] ktap_v2: change "version 1" to "version 2" in examples Date: Mon, 29 Aug 2022 18:31:50 -0500 Message-Id: <20220829233150.3564612-3-frowand.list@gmail.com> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20220829233150.3564612-1-frowand.list@gmail.com> References: <20220829233150.3564612-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 --- Changes since patch version 2: - refresh version 2 patch 2/2 for new context 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 b9a57ceddd4f..ff77f4aaa6ef 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. @@ -202,9 +203,9 @@ An example of a test with two nested subtests: :: - 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 @@ -215,11 +216,11 @@ An example format with multiple levels of nested testing: :: - 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 @@ -250,21 +251,21 @@ Example KTAP output -------------------- :: - 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