From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from eggs.gnu.org ([2001:4830:134:3::10]:55930) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ZyoWu-0008Nf-JY for qemu-devel@nongnu.org; Tue, 17 Nov 2015 17:15:13 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1ZyoWp-00054E-Jh for qemu-devel@nongnu.org; Tue, 17 Nov 2015 17:15:12 -0500 Received: from mail.kernel.org ([198.145.29.136]:41602) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ZyoWp-00053D-Ei for qemu-devel@nongnu.org; Tue, 17 Nov 2015 17:15:07 -0500 Received: from mail.kernel.org (localhost [127.0.0.1]) by mail.kernel.org (Postfix) with ESMTP id 744C5205E6 for ; Tue, 17 Nov 2015 22:15:05 +0000 (UTC) Received: from mail-yk0-f169.google.com (mail-yk0-f169.google.com [209.85.160.169]) (using TLSv1.2 with cipher AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by mail.kernel.org (Postfix) with ESMTPSA id EAB1620547 for ; Tue, 17 Nov 2015 22:15:02 +0000 (UTC) Received: by ykba77 with SMTP id a77so32336603ykb.2 for ; Tue, 17 Nov 2015 14:15:02 -0800 (PST) MIME-Version: 1.0 In-Reply-To: <564995FA.40308@redhat.com> 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> From: Rob Herring Date: Tue, 17 Nov 2015 16:14:42 -0600 Message-ID: Content-Type: text/plain; charset=UTF-8 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: Paolo Bonzini 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, "Gabriel L. Somlo" , Kumar Gala , Leif Lindholm , "matt.fleming@intel.com" , Ard Biesheuvel , Greg Kroah-Hartman , "linux-kernel@vger.kernel.org" , Andy Lutomirski , Hanjun Guo , Sudeep Holla 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. Rob