Messages in this thread | | | From | Linus Walleij <> | Date | Mon, 25 Feb 2019 19:24:36 +0100 | Subject | Re: [PATCH v2 02/10] iio: document bindings for mounting matrices |
| |
Hi Jon,
On Mon, Feb 25, 2019 at 5:32 PM Jonathan Corbet <corbet@lwn.net> wrote:
> > .../devicetree/bindings/iio/mount-matrix.txt | 204 ++++++++++++++++++
So this is a device tree binding.
> So forgive me, but I have to ask: what are the chances of getting this > file in RST format? It's 99% of the way there now, finishing the job > would allow it to be integrated into our docs tree. > > It should probably have an SPDX line too.
The recent direction of the Device Tree bindings are not in the RST direction but in the direction of using another formal structure: YAML schemas.
See e.g. Documentation/devicetree/bindings/example-schema.yaml
The YAML schema makes it possible to verify device trees and examples inside the bindings to the specification using a context-free grammar.
If we can join the RST and YAML ambitions is a good question. RST has nice typesetting properties, YAML has nice grammatic properties.
Yours, Linus Walleij
| |