From patchwork Wed Mar 16 20:26:21 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Frank Rowand X-Patchwork-Id: 552067 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 F0579C433EF for ; Wed, 16 Mar 2022 20:26:53 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1358025AbiCPU2H (ORCPT ); Wed, 16 Mar 2022 16:28:07 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:33248 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1357945AbiCPU15 (ORCPT ); Wed, 16 Mar 2022 16:27:57 -0400 Received: from mail-qt1-x82f.google.com (mail-qt1-x82f.google.com [IPv6:2607:f8b0:4864:20::82f]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id BD81D49C81; Wed, 16 Mar 2022 13:26:42 -0700 (PDT) Received: by mail-qt1-x82f.google.com with SMTP id a14so2780052qtx.12; Wed, 16 Mar 2022 13:26:42 -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=2dAbE+k1+P98yqhuKrp0KrJkICiaHBBC5LcqsK2Pq0c=; b=p7Y9YQbdUstS616K33S19Hr05EW4P9gxFQx2RLucq2/CPYGHgDE2L2LJsMeIBMZOTx EsXJNPWOVclZbVFK47j91jvxTyRPRPzSZ01MA0F2zY2mGGjm8zxptHBKAx8Wsa98XcBu ohvO290c1kWk1QiEVYiim8ulIZR3XNiMNf4qxDq6Bo3RPlEvoQcZAMg2YKLNn4q1l44U Bc8IvWxhTFEvvNBp/yFTbc0BBKK9t4x2jrC/UiMAHuF3wzy3vXft/PH/me3/EYoaWQ+q HGGqLfIDDnZ7sJPHHvhVrw9RiItHf/IpXTuyMx/wVxdp2NZKB5c+shGH3z3PCzfTP9VJ ZlRw== 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=2dAbE+k1+P98yqhuKrp0KrJkICiaHBBC5LcqsK2Pq0c=; b=0Rayb2EhMAbdsy+VSLAP/d1g3V0X/gKCsDJPLNOA1J2pEdoa85fFL40A7mTSiBGoux dIP7U6dlZU+o0arxhFCAnVf4iO7eX8mMxo37S9dyBvbEPMaRGaiIEKr0hHNv0w4gPnVB jfAzMLqolVFv7ZUvTm8LviqIvYA8YiocyaGHrOyJogqP9gJY2YG2YLMaMtsXwojIpWPa oXGlbcTSUx+vc2a4StqhdXvOT44OT0EMSqiBvHi8n89TNfw8XJJoPU+on51Z4/lZ9x+J KlaVDBwwKEVZqdaTG2jMRyoa1pDLKeGWIVEMAzP6YkFQL7dRsAAcgjs3XGrufUZ05dVk MBSA== X-Gm-Message-State: AOAM530c/2agNY6JQFGAVKn/i1TkI+kB+cl3kVeIvxvbWg+jkVXFNpLz VzXNh0syzHeB5YI7Rxi6cFg= X-Google-Smtp-Source: ABdhPJyOZuvvqdw8lZ0V5St11Nq8PN/ApbNqpDtJrOY4tS0BZ+6pQ/XOl0BefhkQJanz2o9LlHnyHA== X-Received: by 2002:ac8:5c84:0:b0:2e1:ceaa:d134 with SMTP id r4-20020ac85c84000000b002e1ceaad134mr1307490qta.247.1647462401846; Wed, 16 Mar 2022 13:26:41 -0700 (PDT) Received: from xps8900.attlocal.net ([2600:1700:2442:6db0:7488:f626:3f3b:5607]) by smtp.gmail.com with ESMTPSA id bp9-20020a05622a1b8900b002e0e86b8ac6sm1940074qtb.67.2022.03.16.13.26.40 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 16 Mar 2022 13:26:41 -0700 (PDT) From: frowand.list@gmail.com To: Jonathan Corbet , David Gow , Shuah Khan , Kees Cook , Tim.Bird@sony.com, Brendan Higgins Cc: 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: [RFC PATCH 1/2] Documentation: dev-tools: KTAP spec change version to 2-rc Date: Wed, 16 Mar 2022 15:26:21 -0500 Message-Id: <20220316202622.324866-2-frowand.list@gmail.com> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20220316202622.324866-1-frowand.list@gmail.com> References: <20220316202622.324866-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. 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 Mar 16 20:26:22 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Frank Rowand X-Patchwork-Id: 552066 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 3FE78C43219 for ; Wed, 16 Mar 2022 20:26:55 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1356159AbiCPU2I (ORCPT ); Wed, 16 Mar 2022 16:28:08 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:33260 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1357964AbiCPU17 (ORCPT ); Wed, 16 Mar 2022 16:27:59 -0400 Received: from mail-qt1-x833.google.com (mail-qt1-x833.google.com [IPv6:2607:f8b0:4864:20::833]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id ADC603F8AE; Wed, 16 Mar 2022 13:26:43 -0700 (PDT) Received: by mail-qt1-x833.google.com with SMTP id d15so1704635qty.8; Wed, 16 Mar 2022 13:26:43 -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=Gns4/i7WVTMPvm4NCq+ncvvmRYDMWRv+EPtpCaahO6I=; b=Y4SLtxmwKiGsSL/pt5pVjNOc8tI4eDK8Avvn7lQnt8NjQTgicY9820fpiXjU5jBXAv fR6gCM19reTd6IHxEtYkZ7iXoZMjQi4S3S7cGEndRgEpU2439g9jVmmeuseWAg9KByeI PmuxYYiomzKSbVsLeHA9tPuOggZfxsR+/aFuUXZGsYcg4jdcPw4IFR9MVG9s4R8upKhT BeLDkiNxuMzCQq1vEtkM9Epb071ZocsII6eucqqe9a0hvwVhYPgmWes2tSSvm4GN0szb WgnkQSu9JbMCzjKuK2ZAhGrDF3Inos8eNDllCIV/oRp5jV28vxsrOzN7bj5aaGdRQT9c vdDg== 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=Gns4/i7WVTMPvm4NCq+ncvvmRYDMWRv+EPtpCaahO6I=; b=sXwCKYK6aPh7dQjY0V++LB/qqlvg5E2au/MM7crn6a0Z99zEqagPmWyGZYXGLIbrcv rw5C6dLu3EZ5CxsHp2ck83ail7EvgY/xM/Yfk4ZE+Rxbk0QShYxUUmOZhvIdno5gK+8Z q60Ya12B++F71S24rOH4zaBys0ci0CgpC84h/j9P/5SBVGPzin8XKmfGwNZz6g0nY+YL 0oj1VzMUPdU55tVpfnl+IpCcdXkOxEb8IPBJg1ILccEjdJzzmu//DGEswhJkviFdSlyt a0fnhwDFXwAr3vSDcb7oRxSJsQq5LHOaZdJKJW6UKq2LUycI0IhNXgp9JWcyZG3eU3+L aStA== X-Gm-Message-State: AOAM531AOlUyFL2/QgX+Z+RsrChPCX3Hz2fUn8eed6deeX0SCfpBYUN4 RBlJ5DuaPFs+4fbaj4dVVBs= X-Google-Smtp-Source: ABdhPJwDDTLLFZ3EPcFp8sFnXz3GpraQjpfswl3LzydEvK2e93Q65Q22kyKStXJosR6i+yavMvSWpw== X-Received: by 2002:a05:622a:1808:b0:2e0:6d99:a782 with SMTP id t8-20020a05622a180800b002e06d99a782mr1360726qtc.406.1647462402852; Wed, 16 Mar 2022 13:26:42 -0700 (PDT) Received: from xps8900.attlocal.net ([2600:1700:2442:6db0:7488:f626:3f3b:5607]) by smtp.gmail.com with ESMTPSA id bp9-20020a05622a1b8900b002e0e86b8ac6sm1940074qtb.67.2022.03.16.13.26.41 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 16 Mar 2022 13:26:42 -0700 (PDT) From: frowand.list@gmail.com To: Jonathan Corbet , David Gow , Shuah Khan , Kees Cook , Tim.Bird@sony.com, Brendan Higgins Cc: 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: [RFC PATCH 2/2] Documentation: dev-tools: use literal block instead of code-block Date: Wed, 16 Mar 2022 15:26:22 -0500 Message-Id: <20220316202622.324866-3-frowand.list@gmail.com> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20220316202622.324866-1-frowand.list@gmail.com> References: <20220316202622.324866-1-frowand.list@gmail.com> MIME-Version: 1.0 Precedence: bulk List-ID: X-Mailing-List: linux-kselftest@vger.kernel.org From: Frank Rowand KTAP Specification: Change code-block directives to straightforward literal blocks since the blocks do not contain code. Suggested-by: Jonathan Corbet Signed-off-by: Frank Rowand Reviewed-by: David Gow --- Documentation/dev-tools/ktap.rst | 18 ++++++++---------- 1 file changed, 8 insertions(+), 10 deletions(-) diff --git a/Documentation/dev-tools/ktap.rst b/Documentation/dev-tools/ktap.rst index 37b5dc61bfb8..b9a57ceddd4f 100644 --- a/Documentation/dev-tools/ktap.rst +++ b/Documentation/dev-tools/ktap.rst @@ -115,34 +115,32 @@ The diagnostic data field is optional, and results which have neither a directive nor any diagnostic data do not need to include the "#" field separator. -Example result lines include: - -.. code-block:: none +Example result lines include:: ok 1 test_case_name The test "test_case_name" passed. -.. code-block:: none +:: not ok 1 test_case_name The test "test_case_name" failed. -.. code-block:: none +:: ok 1 test # SKIP necessary dependency unavailable The test "test" was SKIPPED with the diagnostic message "necessary dependency unavailable". -.. code-block:: none +:: not ok 1 test # TIMEOUT 30 seconds The test "test" timed out, with diagnostic data "30 seconds". -.. code-block:: none +:: ok 5 check return code # rcode=0 @@ -202,7 +200,7 @@ allowed to be either indented or not indented. An example of a test with two nested subtests: -.. code-block:: none +:: KTAP version 1 1..1 @@ -215,7 +213,7 @@ An example of a test with two nested subtests: An example format with multiple levels of nested testing: -.. code-block:: none +:: KTAP version 1 1..2 @@ -250,7 +248,7 @@ nested version line, uses a line of the form Example KTAP output -------------------- -.. code-block:: none +:: KTAP version 1 1..1