[PATCH v2 5/8] doc: devicetree: Updates for devicetree-rebasing subtree

[Sumit Garg]

On Fri, 22 Dec 2023 at 19:26, Tom Rini <trini at konsulko.com> wrote:
>
> On Fri, Dec 22, 2023 at 07:18:05PM +0530, Sumit Garg wrote:
> > On Fri, 22 Dec 2023 at 18:05, Tom Rini <trini at konsulko.com> wrote:
> > >
> > > On Fri, Dec 22, 2023 at 11:42:05AM +0530, Sumit Garg wrote:
> > >
> > > > Encourage SoC/board maintainers to migrate to using devicetree-rebasing
> > > > subtree and maintain a regular sync with Linux kernel devicetree files
> > > > and bindings.
> > > >
> > > > Along with that add documentation regarding how to run DT bindings
> > > > schema checks.
> > > >
> > > > Signed-off-by: Sumit Garg <sumit.garg at linaro.org>
> > > > ---
> > > >  doc/develop/devicetree/control.rst | 108 +++++++++++++++++++++++------
> > > >  1 file changed, 86 insertions(+), 22 deletions(-)
> > > [snip]
> > > > @@ -81,18 +94,21 @@ Failing that, you could write one from scratch yourself!
> > > >  Configuration
> > > >  -------------
> > > >
> > > > -Use::
> > > > +Traditionally, U-Boot placed copies of devicetree source files from Linux
> > > > +kernel into `arch/<arch>/dts/<name>.dts` which can be selected via::
> > > >
> > > > -   #define CONFIG_DEFAULT_DEVICE_TREE        "<name>"
> > > > +    #define CONFIG_DEFAULT_DEVICE_TREE       "<name>"
> > >
> > > Oh, oof. This never got updated for Kconfig rather than config.h. Can
> > > you please include re-wording this to be setting <name> when prompted
> > > for DEFAULT_DEVICE_TREE by Kconfig? And the rest of the text you're
> > > updating as well to match, thanks.
> > >
> >
> > Sure but how about changing it to say via board defconfig as
> > CONFIG_DEFAULT_DEVICE_TREE="<name>", since AFAIK most people use
> > defconfig to configure U-Boot.
>
> Well, do kernel docs tell people to modify defconfigs, or to use the
> config menu/etc?
>

Okay I see your point, I will use wording to select
DEFAULT_DEVICE_TREE by Kconfig instead.

-Sumit

> --
> Tom