linux-kernel - Re: [PATCH] docs: Change reference that was to removed file

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite: Windows password security audit tool. GUI, reports in PDF.

[<prev] [next>] [<thread-prev] [thread-next>] [day] [month] [year] [list]

Message-ID: <CAL_Jsq+YW2K8YoLes8EAUy1WrFRzpYvtzvErOYbhw3zvZBoddQ@mail.gmail.com>
Date:   Tue, 19 Jan 2021 19:07:06 -0600
From:   Rob Herring <robh@...nel.org>
To:     Jonathan Corbet <corbet@....net>
Cc:     Milan Lakhani <milan.lakhani@...ethink.co.uk>,
        Lukas Bulwahn <lukas.bulwahn@...il.com>,
        sudip.mukherjee@...ethink.co.uk, linux-safety@...ts.elisa.tech,
        "linux-kernel@...r.kernel.org" <linux-kernel@...r.kernel.org>,
        Linux Doc Mailing List <linux-doc@...r.kernel.org>,
        Harry Wei <harryxiyou@...il.com>,
        Alex Shi <alex.shi@...ux.alibaba.com>
Subject: Re: [PATCH] docs: Change reference that was to removed file

On Tue, Jan 19, 2021 at 6:01 PM Jonathan Corbet <corbet@....net> wrote:
>
> Milan Lakhani <milan.lakhani@...ethink.co.uk> writes:
>
> [CC += Rob]
>
> > There were two references to
> > Documentation/devicetree/booting-without-of.rst for dtb format
> > information. This file has been removed, so I have changed the links to
> > Documentation/devicetree/usage-model.rst for this information, which
> > itself points to https://elinux.org/Device_Tree_Usage for an overview of
> > the device tree data format.
> >
> > Signed-off-by: Milan Lakhani <milan.lakhani@...ethink.co.uk>
> > ---
> >  Documentation/arm/booting.rst                | 2 +-
> >  Documentation/translations/zh_CN/arm/Booting | 2 +-
> >  2 files changed, 2 insertions(+), 2 deletions(-)
> >
> > diff --git a/Documentation/arm/booting.rst b/Documentation/arm/booting.rst
> > index a226345..5392d01 100644
> > --- a/Documentation/arm/booting.rst
> > +++ b/Documentation/arm/booting.rst
> > @@ -128,7 +128,7 @@ it.  The recommended placement is in the first 16KiB of RAM.
> >
> >  The boot loader must load a device tree image (dtb) into system ram
> >  at a 64bit aligned address and initialize it with the boot data.  The
> > -dtb format is documented in Documentation/devicetree/booting-without-of.rst.
> > +dtb format is documented in Documentation/devicetree/usage-model.rst.
>
> Except that ... usage-model.rst doesn't actually document the DTB
> format.  Perhaps we should instead substitute a link that does what's
> promised here?

Yes, it's in the DT spec. I'd point to
'https://www.devicetree.org/specifications/' so it's always going to
show the latest. And that's the link we have elsewhere in the kernel.

usage-model.rst is also something needing updating...

Rob