Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1754517AbbKRCSR (ORCPT ); Tue, 17 Nov 2015 21:18:17 -0500 Received: from SMTP.ANDREW.CMU.EDU ([128.2.105.202]:60771 "EHLO smtp.andrew.cmu.edu" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1751746AbbKRCSO (ORCPT ); Tue, 17 Nov 2015 21:18:14 -0500 Date: Tue, 17 Nov 2015 21:17:27 -0500 From: "Gabriel L. Somlo" To: Rob Herring Cc: Paolo Bonzini , Greg Kroah-Hartman , Pawel Moll , Mark Rutland , Ian Campbell , Kumar Gala , Arnd Bergmann , Laszlo Ersek , Ralf Baechle , Russell King , Eric Anholt , Hanjun Guo , =?utf-8?B?UmFmYcWCIE1pxYJlY2tp?= , Sudeep Holla , Andy Gross , "linux-api@vger.kernel.org" , "linux-kernel@vger.kernel.org" , "devicetree@vger.kernel.org" , Peter Maydell , "matt.fleming@intel.com" , mst@redhat.com, jordan.l.justen@intel.com, kernelnewbies@kernelnewbies.org, QEMU Developers , Leif Lindholm , Andy Lutomirski , Ard Biesheuvel , kraxel@redhat.com, stefanha@gmail.com Subject: Re: [Qemu-devel] [PATCH v4 4/4] devicetree: update documentation for fw_cfg ARM bindings 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: X-Clacks-Overhead: GNU Terry Pratchett User-Agent: Mutt/1.5.24 (2015-08-30) X-PMX-Version: 6.0.3.2322014, Antispam-Engine: 2.7.2.2107409, Antispam-Data: 2015.11.18.20917 X-SMTP-Spam-Clean: 28% ( SXL_IP_DYNAMIC 3, MULTIPLE_RCPTS 0.1, HTML_00_01 0.05, HTML_00_10 0.05, BODYTEXTP_SIZE_3000_LESS 0, BODY_SIZE_1000_1099 0, BODY_SIZE_2000_LESS 0, BODY_SIZE_5000_LESS 0, BODY_SIZE_7000_LESS 0, DATE_TZ_NA 0, FROM_EDU_TLD 0, NO_URI_HTTPS 0, RDNS_GENERIC_POOLED 0, RDNS_POOLED 0, RDNS_SUSP 0, RDNS_SUSP_GENERIC 0, RDNS_SUSP_SPECIFIC 0, REFERENCES 0, __ANY_URI 0, __BOUNCE_CHALLENGE_SUBJ 0, __BOUNCE_NDR_SUBJ_EXEMPT 0, __CD 0, __CT 0, __CT_TEXT_PLAIN 0, __FORWARDED_MSG 0, __HAS_FROM 0, __HAS_MSGID 0, __IN_REP_TO 0, __MIME_TEXT_ONLY 0, __MIME_VERSION 0, __MULTIPLE_RCPTS_CC_X2 0, __PHISH_SPEAR_STRUCTURE_1 0, __RDNS_POOLED_10 0, __REFERENCES 0, __SANE_MSGID 0, __SUBJ_ALPHA_END 0, __SUBJ_ALPHA_NEGATE 0, __TO_MALFORMED_2 0, __URI_NO_PATH 0, __URI_NO_WWW 0, __URI_NS , __USER_AGENT 0) X-SMTP-Spam-Score: 28% Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Length: 1314 Lines: 33 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 -- To unsubscribe from this list: send the line "unsubscribe linux-kernel" in the body of a message to majordomo@vger.kernel.org More majordomo info at http://vger.kernel.org/majordomo-info.html Please read the FAQ at http://www.tux.org/lkml/