linux-doc.vger.kernel.org archive mirror
 help / color / mirror / Atom feed
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
Date: Thu, 5 Mar 2020 16:39:26 -0700	[thread overview]
Message-ID: <20200305163926.7fb01b21@lwn.net> (raw)
In-Reply-To: <20200305190253.GA28787@avx2>

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

  parent reply	other threads:[~2020-03-05 23:39 UTC|newest]

Thread overview: 4+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2020-03-05 19:02 [PATCH] doc: code generation style Alexey Dobriyan
2020-03-05 19:21 ` Matthew Wilcox
2020-03-05 23:39 ` Jonathan Corbet [this message]
2020-03-06 10:40 ` Jani Nikula

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=20200305163926.7fb01b21@lwn.net \
    --to=corbet@lwn.net \
    --cc=adobriyan@gmail.com \
    --cc=linux-arch@vger.kernel \
    --cc=linux-doc@vger.kernel.org \
    --cc=linux-kernel@vger.kernel.org \
    --cc=torvalds@linux-foundation.org \
    --cc=x86@kernel.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).