From mboxrd@z Thu Jan 1 00:00:00 1970 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 83014C0502A for ; Tue, 30 Aug 2022 12:56:24 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S229985AbiH3M4X (ORCPT ); Tue, 30 Aug 2022 08:56:23 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:49508 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S230048AbiH3M4E (ORCPT ); Tue, 30 Aug 2022 08:56:04 -0400 Received: from casper.infradead.org (casper.infradead.org [IPv6:2001:8b0:10b:1236::1]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id D5D9FAEDAE; Tue, 30 Aug 2022 05:55:32 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=infradead.org; s=casper.20170209; h=In-Reply-To:Content-Type:MIME-Version: References:Message-ID:Subject:Cc:To:From:Date:Sender:Reply-To: Content-Transfer-Encoding:Content-ID:Content-Description; bh=kzUIqwLwyoAHe13fdSfoFA6rcHGHeXti2XRC8Z2C/Qw=; b=E3HCE5rED8f/4ky5V4p+vTFtiC 681+hpGie25wwfbhi/FmGLlR6tzZZknPrqv6JW4zsAq1XdnQeGGGf5Avd2QRtAgMrcnE3U4DSC4If TVVHZJSP6HkVJJP1vP2YL/ZlBoTySkPfbwKRlOJp/vd4kyw8KgAZLnuBCZnyCZlKGoXpmkbNzJrLN XA+zXlDQht7BBu31aHWgxNUT7RqF8FZxBelCu3MTpvvi4BllU5gY/BsCwfP2E/d5rw0bPNxTklAaM ICE40rUDMvz/TkH4pwo8DIuz7gSiw8luunvNe6UEHC3OpbIA5lqYyESQBhrSvOsKctUc7e88SUzvD p59gK1eg==; Received: from willy by casper.infradead.org with local (Exim 4.94.2 #2 (Red Hat Linux)) id 1oT0lZ-00433h-Rw; Tue, 30 Aug 2022 12:54:53 +0000 Date: Tue, 30 Aug 2022 13:54:53 +0100 From: Matthew Wilcox To: frowand.list@gmail.com Cc: David Gow , Shuah Khan , Kees Cook , Tim.Bird@sony.com, Brendan Higgins , 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: Re: [PATCH v3 1/2] ktap_v2: change version to 2-rc in KTAP specification Message-ID: References: <20220829233150.3564612-1-frowand.list@gmail.com> <20220829233150.3564612-2-frowand.list@gmail.com> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20220829233150.3564612-2-frowand.list@gmail.com> Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org On Mon, Aug 29, 2022 at 06:31:49PM -0500, frowand.list@gmail.com wrote: > 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 > =================================================== Hey Frank, you can actually use overlength lines to prevent this kind of problem from occurring. eg, this is perfectly acceptable: =================================================================== Hi =================================================================== I wonder if we should prefer this style to avoid the rash of complaints when a headline is changed.