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 X-Spam-Level: X-Spam-Status: No, score=-2.1 required=3.0 tests=DKIM_SIGNED,DKIM_VALID, DKIM_VALID_AU,FREEMAIL_FORGED_FROMDOMAIN,FREEMAIL_FROM, HEADER_FROM_DIFFERENT_DOMAINS,MAILING_LIST_MULTI,SPF_HELO_NONE,SPF_PASS, USER_AGENT_SANE_1 autolearn=no autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id 75D4CC35672 for ; Sat, 22 Feb 2020 16:17:20 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by mail.kernel.org (Postfix) with ESMTP id 43BD0206E2 for ; Sat, 22 Feb 2020 16:17:20 +0000 (UTC) Authentication-Results: mail.kernel.org; dkim=pass (1024-bit key) header.d=web.de header.i=@web.de header.b="XYa/77Hi" Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1727855AbgBVQRR (ORCPT ); Sat, 22 Feb 2020 11:17:17 -0500 Received: from mout.web.de ([212.227.15.3]:41447 "EHLO mout.web.de" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1726310AbgBVQRR (ORCPT ); Sat, 22 Feb 2020 11:17:17 -0500 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=web.de; s=dbaedf251592; t=1582388161; bh=waBg/oae2VeYhS3Z+bysjt1jse8F1ICvEQFETOSnezo=; h=X-UI-Sender-Class:Subject:To:Cc:References:From:Date:In-Reply-To; b=XYa/77HiCoooSwZuXmvzUYuMmPECL5KYJUOYz4C4/r+o8R0Nw2SWK6I1q4K6dazNq SXZHt3poC7vFKlwbMPAqk1QdoAJV3SlpEmhNWEcnYI051mkEpjQwBotnQ/EdXUJhgO dRcrMjdDHZTSnW5Olfmghoe4JkPJCn765UaHKpUY= X-UI-Sender-Class: c548c8c5-30a9-4db5-a2e7-cb6cb037b8f9 Received: from [192.168.1.2] ([2.244.58.94]) by smtp.web.de (mrweb004 [213.165.67.108]) with ESMTPSA (Nemesis) id 0MJIMc-1j8IKw3UB0-002pnH; Sat, 22 Feb 2020 17:16:01 +0100 Subject: Re: [for-next][12/26] Documentation: bootconfig: Add a doc for extended boot config To: Masami Hiramatsu , Steven Rostedt , linux-doc@vger.kernel.org, linux-fsdevel@vger.kernel.org Cc: kernel-janitors@vger.kernel.org, linux-kernel@vger.kernel.org, Alexey Dobriyan , Andrew Morton , Arnaldo Carvalho de Melo , Frank Rowand , Greg Kroah-Hartman , Ingo Molnar , Jiri Olsa , Jonathan Corbet , Linus Torvalds , Namhyung Kim , Randy Dunlap , Rob Herring , Thomas Gleixner , Tim Bird , Tom Zanussi References: <23e371ca-5df8-3ae3-c685-b01c07b55540@web.de> <20200220221340.2b66fd2051a5da74775c474b@kernel.org> <5ed96b7b-7485-1ea0-16e2-d39c14ae266d@web.de> <20200221191637.e9eed4268ff607a98200628c@kernel.org> <5ade73b0-a3e8-e71a-3685-6485f37ac8b7@web.de> <20200222131833.56a5be2d36033dc5a77a9f0b@kernel.org> <370e675a-598e-71db-8213-f5494b852a71@web.de> <20200223005615.79f308e2ca0717132bb2887b@kernel.org> From: Markus Elfring Autocrypt: addr=Markus.Elfring@web.de; prefer-encrypt=mutual; keydata= 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 FEE= Message-ID: <8cc7e621-c5e3-28fa-c789-0bb7c55d77d6@web.de> Date: Sat, 22 Feb 2020 17:15:57 +0100 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:68.0) Gecko/20100101 Thunderbird/68.5.0 MIME-Version: 1.0 In-Reply-To: <20200223005615.79f308e2ca0717132bb2887b@kernel.org> Content-Type: text/plain; charset=utf-8 Content-Language: en-US Content-Transfer-Encoding: quoted-printable X-Provags-ID: V03:K1:0vafCaV2tekoFGnmOJR8MKTk3aw2mvgHnCEu9gGeyZwAccAK4YF ira7nH6Aug3pMHfsNAt4HGXo/Zyquf/QA0vhcwhqXC8YZGKKM3QwhFTEKaw2EnPAI2iIrNx UwcSMGrzyosV8lrA//qhK2MzyT+QMNBHJe+0/+URIBmxhtnfWGokZmUP2YrZfY2jTFuKywN enygEj1GWdEkjtF61UtnA== X-UI-Out-Filterresults: notjunk:1;V03:K0:DcReG9S/VdA=:YtaDmKaIzX/UhZHyrr7/bT v8m3rgb8nNeKvDMRJ7N27cVRz0ExsvwR1VyUYY8CLoj53qG2GplB7CO/PQ/JENGdVAY+cxm0r 1ipYO5enuaxwE4dkWDv7RBAoNbA2T8BTiKNZouqKixLvT4gJQTAJAiGwt95FSubgmzh7jXs+Z FKHpdhcGANchrjyOju63VbiM2hfRXCInR2f9OgiCcSynhFXaGnNXdqNEFNnBlpazqFEYib/sC Qxxd1LCyHylm06+IG4sJZslDU/rrjyKC3I1DvrT9bmkSC2GTaAu8UkrbSP5XYYwSo9AhAXEzM KwJzFtD5bfrhhyZpcSoIwCtQS18W0RqUvKp3/id9KHsL8Mwm9yHT8AK9wxgXQ7BJGc3ggDOHe D2yrvgFie6RP51/lDk2x/GsVLeC0cXrsB5ptMGHe1DrwvPwDOfKa+1JZoVxxiI7w7IivuV5Yy LpXXwpSOvJ9j84NUKjvT5Xc/igIIWPgRhSM1tAXVqoVkI76Ei0SsjEft5nBbl/qnxV3sl+VQY JgwqCO1IBB935dq36V27HF5xqaORLooxypnW3RIcE9rHQTJvVQuSU0Q6n23HVHSAujgN3sMTq xu828RQGxQ6vYmvvivnyq7/jEaBmnqcUOWgoCcHtsTRx1XPEH5OAz6jKNE58qXvJgytTRofX4 FSwzrOHY+ISDeTYGgXXovapF6gE6hZjrHTN6FdLcDAfVKeZETeQEV1JvQuRNjclGQwnX1a0QE Z826W75jpsZxGi/PiDNxDKILcNHfNND43DuoOBUamsBxrsBs7mlfZ85jekt74TA5FKaGgN6eK E6NajzGN/85vYo8IjunNYDxzKck9RkzqHnkvN9ZBL+Z0S/K/GDdm45X1o/3ZoCljmV0TIEOqy Vklio35HnIoQL06HNy7p7576zX41zVcLuMx7H3c03a7/Sw35YPVZuMEaLEF+eoWVP0y4ltTPb p377MSAZF7nNqdPuB+mbH6RqaUKNJdo+pucPBZUE6mYMaW/JISdzAo46u7DgHYdr/Pnv4Wb1L 4ErkAmt3blDEE6NCRDqyiMfN0j3Jib43dZBRU9e3y9ctXYM7YhQ8/KXlhKmEjyHw9GMk3ydrU nmUTED5T86ClJv4F1oDXt6F3mVRg3d20hgB8LjvTJde7eDDiDwdIBp7HgVM7o4WcWLO+KsDn8 bbUoIAz1NxRnP75i4HOoUyYM/oON+dJk7mgsXF/bPVGo1NHxn8/6Z7x3hLvjInJH+L+QfsCYb 99kV/7lK/pKymkRRc Sender: linux-fsdevel-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-fsdevel@vger.kernel.org >> Is there a need to provide two format descriptions as separate files >> (so that they can help more for different software users)? >> >> * RST >> * EBNF > > Hmm, since RST is enough flexible, we can write it as a section. I guess that there are further design options to consider. > Then user can copy & paste if they need it. I imagine that it can be more convenient to refer to an EBNF file directly if an other software developer would like to generate customised parsers based on available information. Regards, Markus