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-next>] [day] [month] [year] [list]

Message-ID: <87y2gopjcx.fsf@meer.lwn.net>
Date:   Tue, 19 Jan 2021 17:01:02 -0700
From:   Jonathan Corbet <corbet@....net>
To:     Milan Lakhani <milan.lakhani@...ethink.co.uk>,
        lukas.bulwahn@...il.com, sudip.mukherjee@...ethink.co.uk,
        linux-safety@...ts.elisa.tech, linux-kernel@...r.kernel.org,
        linux-doc@...r.kernel.org, harryxiyou@...il.com,
        alex.shi@...ux.alibaba.com
Cc:     Milan Lakhani <milan.lakhani@...ethink.co.uk>,
        Rob Herring <robh@...nel.org>
Subject: Re: [PATCH] docs: Change reference that was to removed file

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?

Thanks,

jon