[PATCH v2] Update links to doc/develop/falcon.rst

[PATCH v2] Update links to doc/develop/falcon.rst

[J. Neuschäfer via B4 Relay]

From: "J. Neuschäfer" <j.ne@posteo.net>

README.falcon was converted to ReST/HTML in 2023.

Signed-off-by: J. Neuschäfer <j.ne@posteo.net>
---
Changes in v2:
- Use a proper link within ReST (thanks to Heinrich Schuchardt's review)
- Link to v1: https://lore.kernel.org/r/20251231-falcon-v1-1-19c85b9660e6@posteo.net
---
 cmd/Kconfig                 | 4 ++--
 common/spl/Kconfig          | 2 +-
 doc/board/ti/am335x_evm.rst | 2 +-
 doc/develop/falcon.rst      | 1 +
 4 files changed, 5 insertions(+), 4 deletions(-)

diff --git a/cmd/Kconfig b/cmd/Kconfig
index b71ac554c0b..fca2a0b0e39 100644
--- a/cmd/Kconfig
+++ b/cmd/Kconfig
@@ -620,7 +620,7 @@ config CMD_SPL
 	help
 	  Falcon mode allows booting directly from SPL into an Operating
 	  System such as Linux, thus skipping U-Boot proper. See
-	  doc/README.falcon for full information about how to use this
+	  doc/develop/falcon.rst for full information about how to use this
 	  command.
 
 config CMD_SPL_NAND_OFS
@@ -629,7 +629,7 @@ config CMD_SPL_NAND_OFS
 	default 0x0
 	help
 	  This provides the offset of the command line arguments for Linux
-	  when booting from NAND in Falcon mode.  See doc/README.falcon
+	  when booting from NAND in Falcon mode.  See doc/develop/falcon.rst
 	  for full information about how to use this option (and also see
 	  board/gateworks/gw_ventana/README for an example).
 
diff --git a/common/spl/Kconfig b/common/spl/Kconfig
index 4b10e9c3880..f0612acf0c2 100644
--- a/common/spl/Kconfig
+++ b/common/spl/Kconfig
@@ -1209,7 +1209,7 @@ config SPL_OS_BOOT
 	depends on ARM || MICROBLAZE || PPC
 	help
 	  Enable booting directly to an OS from SPL.
-	  for more info read doc/README.falcon
+	  for more info read doc/develop/falcon.rst
 
 config SPL_OS_BOOT_SECURE
 	bool "Allow Falcon Mode on secure devices"
diff --git a/doc/board/ti/am335x_evm.rst b/doc/board/ti/am335x_evm.rst
index 40e144948a3..b14ba41917e 100644
--- a/doc/board/ti/am335x_evm.rst
+++ b/doc/board/ti/am335x_evm.rst
@@ -274,7 +274,7 @@ into memory, then written to NAND.
 Falcon Mode
 -----------
 
-The default build includes "Falcon Mode" (see doc/README.falcon) via NAND,
+The default build includes :ref:`falcon-mode` via NAND,
 eMMC (or raw SD cards) and FAT SD cards.  Our default behavior currently is
 to read a 'c' on the console while in SPL at any point prior to loading the
 OS payload (so as soon as possible) to opt to booting full U-Boot.  Also
diff --git a/doc/develop/falcon.rst b/doc/develop/falcon.rst
index 528a9c389bf..3fc23f65c45 100644
--- a/doc/develop/falcon.rst
+++ b/doc/develop/falcon.rst
@@ -1,4 +1,5 @@
 .. SPDX-License-Identifier: GPL-2.0-or-later
+.. _falcon-mode:
 
 Falcon Mode
 ===========

---
base-commit: 4933a0e67578789a57f540a378ce0698435b7b17
change-id: 20251231-falcon-7a97211ecbbe

Best regards,
-- 
J. Neuschäfer <j.ne@posteo.net>

Re: [PATCH v2] Update links to doc/develop/falcon.rst

[Heinrich Schuchardt]

On 1/1/26 15:17, J. Neuschäfer via B4 Relay wrote:
> From: "J. Neuschäfer" <j.ne@posteo.net>
> 
> README.falcon was converted to ReST/HTML in 2023.
> 
> Signed-off-by: J. Neuschäfer <j.ne@posteo.net>

Reviewed-by: Heinrich Schuchardt <xypron.glpk@gmx.de>

> ---
> Changes in v2:
> - Use a proper link within ReST (thanks to Heinrich Schuchardt's review)
> - Link to v1: https://lore.kernel.org/r/20251231-falcon-v1-1-19c85b9660e6@posteo.net
> ---
>   cmd/Kconfig                 | 4 ++--
>   common/spl/Kconfig          | 2 +-
>   doc/board/ti/am335x_evm.rst | 2 +-
>   doc/develop/falcon.rst      | 1 +
>   4 files changed, 5 insertions(+), 4 deletions(-)
> 
> diff --git a/cmd/Kconfig b/cmd/Kconfig
> index b71ac554c0b..fca2a0b0e39 100644
> --- a/cmd/Kconfig
> +++ b/cmd/Kconfig
> @@ -620,7 +620,7 @@ config CMD_SPL
>   	help
>   	  Falcon mode allows booting directly from SPL into an Operating
>   	  System such as Linux, thus skipping U-Boot proper. See
> -	  doc/README.falcon for full information about how to use this
> +	  doc/develop/falcon.rst for full information about how to use this
>   	  command.
>   
>   config CMD_SPL_NAND_OFS
> @@ -629,7 +629,7 @@ config CMD_SPL_NAND_OFS
>   	default 0x0
>   	help
>   	  This provides the offset of the command line arguments for Linux
> -	  when booting from NAND in Falcon mode.  See doc/README.falcon
> +	  when booting from NAND in Falcon mode.  See doc/develop/falcon.rst
>   	  for full information about how to use this option (and also see
>   	  board/gateworks/gw_ventana/README for an example).
>   
> diff --git a/common/spl/Kconfig b/common/spl/Kconfig
> index 4b10e9c3880..f0612acf0c2 100644
> --- a/common/spl/Kconfig
> +++ b/common/spl/Kconfig
> @@ -1209,7 +1209,7 @@ config SPL_OS_BOOT
>   	depends on ARM || MICROBLAZE || PPC
>   	help
>   	  Enable booting directly to an OS from SPL.
> -	  for more info read doc/README.falcon
> +	  for more info read doc/develop/falcon.rst
>   
>   config SPL_OS_BOOT_SECURE
>   	bool "Allow Falcon Mode on secure devices"
> diff --git a/doc/board/ti/am335x_evm.rst b/doc/board/ti/am335x_evm.rst
> index 40e144948a3..b14ba41917e 100644
> --- a/doc/board/ti/am335x_evm.rst
> +++ b/doc/board/ti/am335x_evm.rst
> @@ -274,7 +274,7 @@ into memory, then written to NAND.
>   Falcon Mode
>   -----------
>   
> -The default build includes "Falcon Mode" (see doc/README.falcon) via NAND,
> +The default build includes :ref:`falcon-mode` via NAND,
>   eMMC (or raw SD cards) and FAT SD cards.  Our default behavior currently is
>   to read a 'c' on the console while in SPL at any point prior to loading the
>   OS payload (so as soon as possible) to opt to booting full U-Boot.  Also
> diff --git a/doc/develop/falcon.rst b/doc/develop/falcon.rst
> index 528a9c389bf..3fc23f65c45 100644
> --- a/doc/develop/falcon.rst
> +++ b/doc/develop/falcon.rst
> @@ -1,4 +1,5 @@
>   .. SPDX-License-Identifier: GPL-2.0-or-later
> +.. _falcon-mode:
>   
>   Falcon Mode
>   ===========
> 
> ---
> base-commit: 4933a0e67578789a57f540a378ce0698435b7b17
> change-id: 20251231-falcon-7a97211ecbbe
> 
> Best regards,

Re: [PATCH v2] Update links to doc/develop/falcon.rst

[Mattijs Korpershoek]

Hi J.,

Thank you for the patch.

On Thu, Jan 01, 2026 at 15:17, J. Neuschäfer via B4 Relay <devnull+j.ne.posteo.net@kernel.org> wrote:

> From: "J. Neuschäfer" <j.ne@posteo.net>
>
> README.falcon was converted to ReST/HTML in 2023.
>
> Signed-off-by: J. Neuschäfer <j.ne@posteo.net>

Reviewed-by: Mattijs Korpershoek <mkorpershoek@kernel.org>

> ---