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 <robh@kernel.org>
Date: Tue, 17 Nov 2015 16:14:42 -0600
Message-ID: <CAL_JsqKEi9BozyLQ9sKM3VL-hSSRntDyET859N1qTTMT4jkDOw@mail.gmail.com>
Subject: Re: [Qemu-devel] [PATCH v4 4/4] devicetree: update documentation for
 fw_cfg ARM bindings
To: Paolo Bonzini <pbonzini@redhat.com>
Cc: "Gabriel L. Somlo" <somlo@cmu.edu>,
        Greg Kroah-Hartman <gregkh@linuxfoundation.org>,
        Pawel Moll <pawel.moll@arm.com>, Mark Rutland <mark.rutland@arm.com>,
        Ian Campbell <ijc+devicetree@hellion.org.uk>,
        Kumar Gala <galak@codeaurora.org>, Arnd Bergmann <arnd@arndb.de>,
        Laszlo Ersek <lersek@redhat.com>, Ralf Baechle <ralf@linux-mips.org>,
        Russell King <rmk+kernel@arm.linux.org.uk>,
        Eric Anholt <eric@anholt.net>, Hanjun Guo <hanjun.guo@linaro.org>,
        =?UTF-8?B?UmFmYcWCIE1pxYJlY2tp?= <zajec5@gmail.com>,
        Sudeep Holla <sudeep.holla@arm.com>,
        Andy Gross <agross@codeaurora.org>,
        "linux-api@vger.kernel.org" <linux-api@vger.kernel.org>,
        "linux-kernel@vger.kernel.org" <linux-kernel@vger.kernel.org>,
        "devicetree@vger.kernel.org" <devicetree@vger.kernel.org>,
        Peter Maydell <peter.maydell@linaro.org>,
        "matt.fleming@intel.com" <matt.fleming@intel.com>, mst@redhat.com,
        jordan.l.justen@intel.com, kernelnewbies@kernelnewbies.org,
        QEMU Developers <qemu-devel@nongnu.org>,
        Leif Lindholm <leif.lindholm@linaro.org>,
        Andy Lutomirski <luto@amacapital.net>,
        Ard Biesheuvel <ard.biesheuvel@linaro.org>, kraxel@redhat.com,
        stefanha@gmail.com
Content-Type: text/plain; charset=UTF-8
Sender: linux-kernel-owner@vger.kernel.org
Content-Length: 861
Lines: 22

On Mon, Nov 16, 2015 at 2:38 AM, Paolo Bonzini <pbonzini@redhat.com> 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
--
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/