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=-0.8 required=3.0 tests=HEADER_FROM_DIFFERENT_DOMAINS, MAILING_LIST_MULTI,SPF_HELO_NONE,SPF_PASS 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 62312C3F2D1 for ; Thu, 5 Mar 2020 23:39:30 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by mail.kernel.org (Postfix) with ESMTP id 409A720801 for ; Thu, 5 Mar 2020 23:39:30 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1726378AbgCEXj3 (ORCPT ); Thu, 5 Mar 2020 18:39:29 -0500 Received: from ms.lwn.net ([45.79.88.28]:37516 "EHLO ms.lwn.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1726049AbgCEXj2 (ORCPT ); Thu, 5 Mar 2020 18:39:28 -0500 Received: from lwn.net (localhost [127.0.0.1]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ms.lwn.net (Postfix) with ESMTPSA id E54242E4; Thu, 5 Mar 2020 23:39:27 +0000 (UTC) Date: Thu, 5 Mar 2020 16:39:26 -0700 From: Jonathan Corbet To: Alexey Dobriyan 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 List-ID: X-Mailing-List: linux-kernel@vger.kernel.org On Thu, 5 Mar 2020 22:02:53 +0300 Alexey Dobriyan 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