Re: [RFC PATCH 0/5] DT binding documents using text markup

2015-09-01 Thread Rob Herring
On Tue, Sep 1, 2015 at 1:03 PM, Tim Bird wrote: > On Tue, Sep 1, 2015 at 10:35 AM, Frank Rowand wrote: >> On 9/1/2015 10:14 AM, Tim Bird wrote: >>> On Fri, Aug 28, 2015 at 10:13 AM, Matt Porter wrote: >> >> < snip > >> But to answer your question, if we get a format I'll do conver

Re: [RFC PATCH 0/5] DT binding documents using text markup

2015-09-01 Thread Tim Bird
On Tue, Sep 1, 2015 at 10:35 AM, Frank Rowand wrote: > On 9/1/2015 10:14 AM, Tim Bird wrote: >> On Fri, Aug 28, 2015 at 10:13 AM, Matt Porter wrote: > > < snip > > >>> >>> But to answer your question, if we get a format I'll do >>> conversions and hope I'm not alone. >> >> I'm sure others will he

Re: [RFC PATCH 5/5] Documentation: dt-bindings: phy: add YAML TI PHY binding

2015-09-01 Thread Tim Bird
On Thu, Aug 27, 2015 at 10:23 PM, Matt Porter wrote: > Convert the ti-phy.txt binding to standard YAML DT binding > format. This binding references the YAML generic PHY binding. > > Signed-off-by: Matt Porter > --- > Documentation/devicetree/bindings/phy/ti-phy.yaml | 166 >

Re: [RFC PATCH 0/5] DT binding documents using text markup

2015-09-01 Thread Matt Porter
On Sun, Aug 30, 2015 at 03:04:20PM -0700, Frank Rowand wrote: > On 8/27/2015 10:23 PM, Matt Porter wrote: > > During the Device Tree microconference at Linux Plumbers 2015, we had > > a short discussion about how to improve DT Binding Documentation. A > > number of issues were raised (again, as the

Re: [RFC PATCH 2/5] Documentation: dt-bindings: add example DT binding document

2015-09-01 Thread Tim Bird
On Fri, Aug 28, 2015 at 7:53 AM, Rob Herring wrote: > On Fri, Aug 28, 2015 at 12:23 AM, Matt Porter wrote: ... >> +example: >> + - dts: | >> + sk11@0 { >> + compatible = "skel,sk11"; >> + reg = <0>; >> + spi-max-frequency = <100>; >> +

Re: [RFC PATCH 0/5] DT binding documents using text markup

2015-09-01 Thread Frank Rowand
On 9/1/2015 10:14 AM, Tim Bird wrote: > On Fri, Aug 28, 2015 at 10:13 AM, Matt Porter wrote: < snip > >> >> But to answer your question, if we get a format I'll do >> conversions and hope I'm not alone. > > I'm sure others will help out. I will, and I'm pretty sure we can get > some conversion

Re: [RFC PATCH 2/5] Documentation: dt-bindings: add example DT binding document

2015-09-01 Thread Matt Porter
On Fri, Aug 28, 2015 at 01:55:11PM -0500, Rob Herring wrote: > On Fri, Aug 28, 2015 at 12:49 PM, Matt Porter wrote: > > On Fri, Aug 28, 2015 at 09:53:06AM -0500, Rob Herring wrote: > >> On Fri, Aug 28, 2015 at 12:23 AM, Matt Porter wrote: > >> > Add a skeleton DT binding document that serves as t

Re: [RFC PATCH 0/5] DT binding documents using text markup

2015-09-01 Thread Tim Bird
On Fri, Aug 28, 2015 at 10:13 AM, Matt Porter wrote: > Now, I would caution about trying to do too much on Day 1 or we > could end up back at the "never doing anything" stage. I strongly agree with that (despite my having just sent a bunch of comments on the binding format document). > It would

Re: [RFC PATCH 1/5] Documentation: dt-bindings: add documentation on new DT binding format

2015-09-01 Thread Tim Bird
On Thu, Aug 27, 2015 at 10:23 PM, Matt Porter wrote: > Documentation explaining the syntax and format of the YAML-based DT binding > documentation. > > Signed-off-by: Matt Porter > --- > .../devicetree/bindings/dt-binding-format.txt | 106 > + > 1 file changed, 106 inse

Re: [RFC PATCH 0/5] DT binding documents using text markup

2015-09-01 Thread Tim Bird
On Thu, Aug 27, 2015 at 10:23 PM, Matt Porter wrote: > During the Device Tree microconference at Linux Plumbers 2015, we had > a short discussion about how to improve DT Binding Documentation. A > number of issues were raised (again, as these things have been > discussed in the past) including: >