Re: [PATCH v3 4/4] doc: dts-format: Correct what happens without /dts-v1/

[David Gibson <david@gibson.dropbear.id.au>]

[-- Attachment #1: Type: text/plain, Size: 2095 bytes --]

On Thu, Oct 29, 2026 at 12:33:59PM +0100, Herve Codina wrote:
> Hi Simon,
> 
> On Thu, 29 Oct 2026 03:30:57 -0600
> Simon Glass <sjg@chromium.org> wrote:
> 
> > dts-format.txt says that dtc treats a file without /dts-v1/ as the
> > obsolete version 0 format. That has not been true since commit
> > 4e1a0a0129b3 ("Remove support for the legacy DTS source file format."),
> > and dtc now gives a syntax error instead.
> > 
> > Say that dtc does not accept such files.
> > 
> > Assisted-by: Claude:claude-opus-5-5
> > Signed-off-by: Simon Glass <sjg@chromium.org>
> > ---
> > 
> > Changes in v3:
> > - Add new patch to correct the description of /dts-v1/
> > 
> >  Documentation/dts-format.txt | 5 ++---
> >  1 file changed, 2 insertions(+), 3 deletions(-)
> > 
> > diff --git a/Documentation/dts-format.txt b/Documentation/dts-format.txt
> > index da0783b..87d3d8e 100644
> > --- a/Documentation/dts-format.txt
> > +++ b/Documentation/dts-format.txt
> > @@ -137,9 +137,8 @@ Version 1 DTS files have the overall layout:
> >  	};
> >  
> >  * The "/dts-v1/;" must be present to identify the file as a version 1
> > -  DTS (dts files without this tag will be treated by dtc as being in
> > -  the obsolete "version 0", which uses a different format for integers
> > -  amongst other small but incompatible changes).
> > +  DTS. dtc does not accept files without it, which would be in the
> > +  obsolete "version 0" format.
> 
>      obsolete and no more supported "version 0" format.
> 
> Just to be clear about the "version 0" format.
> 
> With that done:
> Reviewed-by: Herve Codina <herve.codina@bootlin.com>

I'm merging this with a slightly updated version of that change.

> 
> >  
> >  * Memory reservations define an entry for the device tree blob's
> >    memory reservation table.  They have the form:
> 
> Best regards,
> Hervé
> 
> 

-- 
David Gibson (he or they)	| I'll have my music baroque, and my code
david AT gibson.dropbear.id.au	| minimalist, thank you, not the other way
				| around.
http://www.ozlabs.org/~dgibson

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]