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.
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.
- Marijn
--
With best wishes
Dmitry
