From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from eggs.gnu.org ([2001:4830:134:3::10]:51935) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ZysK7-0007Nh-H5 for qemu-devel@nongnu.org; Tue, 17 Nov 2015 21:18:16 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1ZysK3-0001cg-Fd for qemu-devel@nongnu.org; Tue, 17 Nov 2015 21:18:15 -0500 Received: from smtp.andrew.cmu.edu ([128.2.105.202]:44391) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ZysK3-0001cb-Af for qemu-devel@nongnu.org; Tue, 17 Nov 2015 21:18:11 -0500 Date: Tue, 17 Nov 2015 21:17:27 -0500 From: "Gabriel L. Somlo" Message-ID: <20151118021727.GA14351@GLSMBP.INI.CMU.EDU> References: <1447470235-13643-1-git-send-email-somlo@cmu.edu> <1447470235-13643-5-git-send-email-somlo@cmu.edu> <20151115020754.GA21323@rob-hp-laptop> <564995FA.40308@redhat.com> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: Subject: Re: [Qemu-devel] [PATCH v4 4/4] devicetree: update documentation for fw_cfg ARM bindings List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , To: Rob Herring Cc: Mark Rutland , Peter Maydell , mst@redhat.com, stefanha@gmail.com, QEMU Developers , Eric Anholt , kraxel@redhat.com, "linux-api@vger.kernel.org" , Andy Gross , Pawel Moll , kernelnewbies@kernelnewbies.org, =?utf-8?B?UmFmYcWCIE1pxYJlY2tp?= , Russell King , Laszlo Ersek , "devicetree@vger.kernel.org" , Arnd Bergmann , Ian Campbell , jordan.l.justen@intel.com, Kumar Gala , Leif Lindholm , "matt.fleming@intel.com" , Ard Biesheuvel , Greg Kroah-Hartman , "linux-kernel@vger.kernel.org" , Andy Lutomirski , Hanjun Guo , Sudeep Holla , Paolo Bonzini On Tue, Nov 17, 2015 at 04:14:42PM -0600, Rob Herring wrote: > On Mon, Nov 16, 2015 at 2:38 AM, Paolo Bonzini wrote: > > > > > > On 15/11/2015 03:07, Rob Herring wrote: > >> We generally don't want DT docs to depend on other kernel documentation. > > > > DT docs do not contain a copy of the data sheets, either. There is no > > reason to say how to use the device (and even then, only doing so > > partially) in the DT docs. > > The difference is datasheets apply to all OS's, kernel documentation > does not. In theory at least this could be used for other OS's, right? > > Perhaps QEMU is the right place to thoroughly describe this and DT and > sysfs docs can refer to it. So, leave only ARM/DT specifc details in Documentation/devicetree/bindings/arm/fw-cfg.txt, and rework the fw_cfg sysfs patch (1/4) to only document sysfs specific details in Documentation/ABI/testing/sysfs-firmware-qemu_fw_cfg ? The fw_cfg "datasheet" does exist in QEMU already, so there is something to point at from either/both of the above. Thanks, --Gabriel