Received-SPF: pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) client-ip=209.132.180.67;
Date:   Thu, 5 Mar 2020 16:39:26 -0700
From:   Jonathan Corbet <corbet@lwn.net>
To:     Alexey Dobriyan <adobriyan@gmail.com>
Cc:     torvalds@linux-foundation.org, linux-kernel@vger.kernel.org,
        linux-arch@vger.kernel, linux-doc@vger.kernel.org, x86@kernel.org
Subject: Re: [PATCH] doc: code generation style
Message-ID: <20200305163926.7fb01b21@lwn.net>
In-Reply-To: <20200305190253.GA28787@avx2>
References: <20200305190253.GA28787@avx2>
Organization: LWN.net
MIME-Version: 1.0
Content-Type: text/plain; charset=US-ASCII
Content-Transfer-Encoding: 8bit
Sender: linux-kernel-owner@vger.kernel.org
Precedence: bulk

On Thu, 5 Mar 2020 22:02:53 +0300
Alexey Dobriyan <adobriyan@gmail.com> wrote:

> I wonder if it would be useful to have something like this in tree.
> 
> It states trivial things for anyone who looked at disassembly few times
> but still...

If nothing else, it needs an introductory paragraph saying what it's about
and why somebody might want to read it.

In general, I'm really reluctant to add stuff to the coding-style
documents (and that's pretty much what this is) without a pretty strong
feeling that it describes generally accepted practices.  So I'd definitely
want a fair number of acks before taking something like this.

Thanks,

jon