On 2023-01-12 00:31:33, Dmitry Baryshkov wrote: > On 12/01/2023 00:29, Marijn Suijten wrote: > > On 2023-01-10 06:40:27, Dmitry Baryshkov wrote: > >> On 09/01/2023 09:49, Marijn Suijten wrote: > >>> On 2023-01-09 07:01:49, Dmitry Baryshkov wrote: > > <snip> > >>>> + description: | > >>> > >>> Should multiline descriptions be treated as a oneline string with `>`? > >> > >> Ack, I'm fine with either of them, let's use the > > >> > >>> > >>>> + Contains the list of output ports from DPU device. These ports > >>>> + connect to interfaces that are external to the DPU hardware, > >>>> + such as DSI, DP etc. MDP5 devices support up to 4 ports:: > >>> > >>> How do these double colons render? Is this intentional? > >> > >> double colons is an escape for a single colon if I remember correcly. > > > > I thought no escaping was necessary here, especially since this is > > already a value - it is a multiline string. > > I was mostly following examples, grep :: through the dt-bindings. Saw that, maybe these "freeform" description strings are intended to be RST to support more elaborate rendering if/when that happens? > >> BTW: how to render the DT schema? > > > > I'm not sure if there's currently any rendering tool to view these docs > > in a "friendly" manner, e.g. an html page, or whether they're only used > > as specifications for DT validation. > > Probably there will be one at some point. It might make good addition to > devicetree.org. Would be super cool to have some "interactive" / properly rendered/colored docs up there for DT :) - Marijn
