[PATCH v2] doc: Update mentions of README.fdt-control

Quentin Schulz quentin.schulz at cherry.de
Tue Sep 23 14:14:28 CEST 2025


Hi E,

On 9/17/25 3:17 AM, E Shattow wrote:
> Update documents 'README.fdt-control' reference to replacement 'control.rst':
>    doc/arch/nios2.rst
>    dts/Makefile
> 
> Also convert some adjacent pathname mentions to rST links where applicable
> 
> Fixes: 3e9fddfc4f14 "doc: Move devicetree control doc to rST"
> Signed-off-by: E Shattow <e at freeshell.de>
> ---
>   doc/arch/nios2.rst                    | 2 +-
>   doc/develop/devicetree/control.rst    | 3 ++-
>   doc/develop/driver-model/design.rst   | 1 +
>   doc/develop/driver-model/ethernet.rst | 2 +-
>   doc/develop/spl.rst                   | 2 +-
>   doc/usage/fdt_overlays.rst            | 1 +
>   doc/usage/fit/overlay-fdt-boot.rst    | 2 +-
>   dts/Makefile                          | 2 +-
>   8 files changed, 9 insertions(+), 6 deletions(-)
> 
> diff --git a/doc/arch/nios2.rst b/doc/arch/nios2.rst
> index 34a75e7fb00..58f63c996b6 100644
> --- a/doc/arch/nios2.rst
> +++ b/doc/arch/nios2.rst
> @@ -13,7 +13,7 @@ Please refer to the link for Linux port and toolchains:
>   http://rocketboards.org/foswiki/view/Documentation/NiosIILinuxUserManual
>   
>   The Nios II port of u-boot is controlled by device tree. Please check
> -out doc/README.fdt-control.
> +out :ref:`devicetree_control`.

If you're not pointing at a specific section in the document, maybe use 
:doc:[1] instead of :ref:, in which case you wouldn't need to add labels 
at the top of each file?

What do you think?

[1] https://www.sphinx-doc.org/en/master/usage/referencing.html#role-doc

Cheers,
Quentin


More information about the U-Boot mailing list