Groups | Search | Server Info | Keyboard shortcuts | Login | Register [http] [https] [nntp] [nntps]


Groups > linux.kernel > #1271815

Re: [Qemu-devel] [PATCH v4 4/4] devicetree: update documentation for fw_cfg ARM bindings

From "Gabriel L. Somlo" <somlo@cmu.edu>
Newsgroups linux.kernel
Subject Re: [Qemu-devel] [PATCH v4 4/4] devicetree: update documentation for fw_cfg ARM bindings
Date 2015-11-18 03:20 +0100
Message-ID <qw0vL-4VG-9@gated-at.bofh.it> (permalink)
References <quzxD-6X7-1@gated-at.bofh.it> <quzxE-6X7-27@gated-at.bofh.it> <quV58-3JS-31@gated-at.bofh.it> <qvnuq-4WA-13@gated-at.bofh.it> <qvWLv-2zc-3@gated-at.bofh.it>
Organization linux.* mail to news gateway

Show all headers | View raw


On Tue, Nov 17, 2015 at 04:14:42PM -0600, Rob Herring wrote:
> 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.

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/

Back to linux.kernel | Previous | NextPrevious in thread | Next in thread | Find similar | Unroll thread


Thread

Re: [Qemu-devel] [PATCH v4 4/4] devicetree: update documentation for  fw_cfg ARM bindings Rob Herring <robh@kernel.org> - 2015-11-17 23:20 +0100
  Re: [Qemu-devel] [PATCH v4 4/4] devicetree: update documentation for  fw_cfg ARM bindings "Gabriel L. Somlo" <somlo@cmu.edu> - 2015-11-18 03:20 +0100
  Re: Re: [Qemu-devel] [PATCH v4 4/4] devicetree: update documentation  for fw_cfg ARM bindings François Revol <revol@free.fr> - 2015-11-18 19:00 +0100
    Re: Re: [Qemu-devel] [PATCH v4 4/4] devicetree: update documentation  for fw_cfg ARM bindings "Gabriel L. Somlo" <somlo@cmu.edu> - 2015-11-18 22:00 +0100

csiph-web