[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: [Qemu-devel] [PATCH v4 4/4] devicetree: update documentation for fw_
From: |
Gabriel L. Somlo |
Subject: |
Re: [Qemu-devel] [PATCH v4 4/4] devicetree: update documentation for fw_cfg ARM bindings |
Date: |
Tue, 17 Nov 2015 21:17:27 -0500 |
User-agent: |
Mutt/1.5.24 (2015-08-30) |
On Tue, Nov 17, 2015 at 04:14:42PM -0600, Rob Herring wrote:
> On Mon, Nov 16, 2015 at 2:38 AM, Paolo Bonzini <address@hidden> 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
- [Qemu-devel] [PATCH v4 0/4] SysFS driver for QEMU fw_cfg device, Gabriel L. Somlo, 2015/11/13
- [Qemu-devel] [PATCH v4 4/4] devicetree: update documentation for fw_cfg ARM bindings, Gabriel L. Somlo, 2015/11/13
- Re: [Qemu-devel] [PATCH v4 4/4] devicetree: update documentation for fw_cfg ARM bindings, Rob Herring, 2015/11/16
- Re: [Qemu-devel] [PATCH v4 4/4] devicetree: update documentation for fw_cfg ARM bindings, Paolo Bonzini, 2015/11/16
- Re: [Qemu-devel] [PATCH v4 4/4] devicetree: update documentation for fw_cfg ARM bindings, Gabriel L. Somlo, 2015/11/16
- Re: [Qemu-devel] [PATCH v4 4/4] devicetree: update documentation for fw_cfg ARM bindings, Rob Herring, 2015/11/17
- Re: [Qemu-devel] [PATCH v4 4/4] devicetree: update documentation for fw_cfg ARM bindings,
Gabriel L. Somlo <=
- Re: [Qemu-devel] [PATCH v4 4/4] devicetree: update documentation for fw_cfg ARM bindings, François Revol, 2015/11/18
- Re: [Qemu-devel] [PATCH v4 4/4] devicetree: update documentation for fw_cfg ARM bindings, Gabriel L. Somlo, 2015/11/18
[Qemu-devel] [PATCH v4 2/4] kobject: export kset_find_obj() for module use, Gabriel L. Somlo, 2015/11/13
[Qemu-devel] [PATCH v4 3/4] firmware: create directory hierarchy for sysfs fw_cfg entries, Gabriel L. Somlo, 2015/11/13
[Qemu-devel] [PATCH v4 1/4] firmware: introduce sysfs driver for QEMU's fw_cfg device, Gabriel L. Somlo, 2015/11/13