Hi, On Tue, Aug 30, 2022 at 2:33 AM Krzysztof Kozlowski <krzysztof.kozlowski@xxxxxxxxxx> wrote: > > > +}; > > + > > +/* > > + * ADDITIONS TO FIXED REGULATORS DEFINED IN PARENT DEVICE TREE FILES > > What does it mean and why it's SCREAMING? > > + * > > + * Sort order matches the order in the parent files (parents before children). > > Why? Sorting should be rather alphabetical. We've had this discussion on the lists in the past. See, for instance: https://lore.kernel.org/r/CAD=FV=U2C1W+JHWyGRfyRB=WiPKLYvtjO90UDoJ9p+Xwe09+ow@xxxxxxxxxxxxxx/ The tl;dr summary is: * Going with exclusively alphabetical sort ordering tends to make things more confusing when there's a mix of things that are overridden vs. things that are fully defined from scratch. * If we accept that some ordering isn't alphabetical then it makes sense to have some sort of section headers to define when sort ordering changes. Otherwise people are constantly confused and putting things in the wrong place. Certainly there are lots of styles of section headers, some of which use all caps. * What's in this patch with regards to section headers and sort orders matches other herobrine-related files. If you want to propose a new way to organize files then perhaps you can submit a patch to do so and we can evaluate whether it's cleaner or not. If you want to propose a different organization, perhaps propose it on sc7180-trogdor files so we can see how it looks on a fully fleshed out family. That will help us evaluate whether it's easier or harder to understand. -Doug