[PATCH] powerpc: document new interrupt-array property

[Segher Boessenkool]

>> Examples exists where one property tells you how to interpret
>> or decode another (e.g. #address-cells), but your proposal we
>> have two distinct properties each with values that together
>> provide the complete 'value' (interrupt parent + interrupt
>> specifier).  Is there any precedent for this approach?
>
> Somewhat... interrupt-map and interrupt-map-mask... that sort of thing.

Those are not _arrays_ parsed in concert; finding examples
of that is pretty hard (unless you look at PAPR or Apple
trees ;-) ), there are a few though.  Examples where a scalar
property is used to interpret an array property are plenty,
look no further than "interrupt-parent".

>> I think I'd rather see all the information encoded in
>> one value.
>
> On the other hand, I do quite like keeping with the old principle that
> having interrupts == having an "interrupts" node.

Yes, it's a very important principle in OF that any certain
piece of information is encoded in one place, and one possible
place only.

This does mean that you should be very careful when defining
new bindings, think things through a lot to future-proof it,
do a whole lot of peer review, etc.; but in the end you'll end
up with much better bindings.


Segher