From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1751962AbdAaSz2 (ORCPT ); Tue, 31 Jan 2017 13:55:28 -0500 Received: from ale.deltatee.com ([207.54.116.67]:58015 "EHLO ale.deltatee.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1751414AbdAaSzW (ORCPT ); Tue, 31 Jan 2017 13:55:22 -0500 To: Jonathan Corbet References: <1485882204-26947-1-git-send-email-logang@deltatee.com> <1485882204-26947-2-git-send-email-logang@deltatee.com> <20170131172630.GB12595@kroah.com> <57658098-b24a-cb25-b2e3-ccf8fcbf8fe5@deltatee.com> <20170131104916.0f187309@lwn.net> Cc: Greg Kroah-Hartman , Keith Busch , Myron Stowe , Bjorn Helgaas , Geert Uytterhoeven , "David S. Miller" , Andrew Morton , Emil Velikov , Mauro Carvalho Chehab , Guenter Roeck , Jarkko Sakkinen , Linus Walleij , Ryusuke Konishi , Stefan Berger , Wei Zhang , Kurt Schwemmer , Stephen Bates , linux-pci@vger.kernel.org, linux-doc@vger.kernel.org, linux-nvme@lists.infradead.org, linux-kernel@vger.kernel.org From: Logan Gunthorpe Message-ID: Date: Tue, 31 Jan 2017 11:32:24 -0700 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:45.0) Gecko/20100101 Icedove/45.6.0 MIME-Version: 1.0 In-Reply-To: <20170131104916.0f187309@lwn.net> Content-Type: text/plain; charset=windows-1252 Content-Transfer-Encoding: 7bit X-SA-Exim-Connect-IP: 172.16.1.111 X-SA-Exim-Rcpt-To: linux-kernel@vger.kernel.org, linux-nvme@lists.infradead.org, linux-doc@vger.kernel.org, linux-pci@vger.kernel.org, stephen.bates@microsemi.com, kurt.schwemmer@microsemi.com, wzhang@fb.com, stefanb@linux.vnet.ibm.com, konishi.ryusuke@lab.ntt.co.jp, linus.walleij@linaro.org, jarkko.sakkinen@linux.intel.com, linux@roeck-us.net, mchehab@kernel.org, emil.l.velikov@gmail.com, akpm@linux-foundation.org, davem@davemloft.net, geert+renesas@glider.be, bhelgaas@google.com, myron.stowe@gmail.com, keith.busch@intel.com, gregkh@linuxfoundation.org, corbet@lwn.net X-SA-Exim-Mail-From: logang@deltatee.com Subject: Re: [PATCH 1/1] MicroSemi Switchtec management interface driver X-SA-Exim-Version: 4.2.1 (built Mon, 26 Dec 2011 16:24:06 +0000) X-SA-Exim-Scanned: Yes (on ale.deltatee.com) Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org On 31/01/17 10:49 AM, Jonathan Corbet wrote: > The good news is that your switchtec.txt file is already 99% in the RST > format, so there is little or nothing to do there. > > The bad news is that we don't quite have a place for it yet. This is > really user-space developer documentation, and we don't have a sub-book > for that. I expect that to change pretty soon, and I might even toss > together a bare beginning for 4.11, but that hasn't happened yet. > > If you would like to learn the ropes and make one, that would be more than > great :) Alternatively, I'd suggest just leaving the document as-is, and > I'll put it toward the top of the list of things to move into place once I > get that book started. Thanks Jon. I took a look at the documentation and it doesn't look too difficult. But I don't really feel qualified to make some of the decisions necessary to create the new book. (ie names, locations, etc.) And I don't really want that churn in this patchset. So we'll leave it where it is for now. I have cleaned up some of the RST format for v2 though. Logan