[PATCH v2 4/4] Documentation: migration-2025.08.0: add information about attempts_locked

[Ahmad Fatoum]

On 6/16/25 17:06, Lars Schmidt wrote:
> Document the newly added feature.

The migration guide is just pointing out things to be aware of when
updating and is not the documentation per se.

No need to resend just for that, but if you are going to resend anyway,
you may want to adjust the commit message here.

> 
> Signed-off-by: Lars Schmidt <l.schmidt at pengutronix.de>

Reviewed-by: Ahmad Fatoum <a.fatoum at pengutronix.de>

Cheers,
Ahmad

> ---
>  Documentation/migration-guides/migration-2025.08.0.rst | 5 +++++
>  Documentation/user/bootchooser.rst                     | 3 +++
>  2 files changed, 8 insertions(+)
> 
> diff --git a/Documentation/migration-guides/migration-2025.08.0.rst b/Documentation/migration-guides/migration-2025.08.0.rst
> index d13d5c770d5e7688e0299184b0b8b938db160fca..da60132e7d8c784b08a43c8032ee7e4dc7cb7991 100644
> --- a/Documentation/migration-guides/migration-2025.08.0.rst
> +++ b/Documentation/migration-guides/migration-2025.08.0.rst
> @@ -1,3 +1,8 @@
>  Release v2025.08.0
>  ==================
>  
> +Bootchooser
> +-----------
> +
> +Bootchooser now interprets a top-level ``attempts_locked`` variable.
> +For more information, see :ref:`attempts lock feature <bootchooser,attempts_lock>`
> diff --git a/Documentation/user/bootchooser.rst b/Documentation/user/bootchooser.rst
> index ab0b6c3fc895226f5aa4590944a2cd675a56d985..d123e8d34e63fcfb6a725cbe1aeca40a7dbbeb87 100644
> --- a/Documentation/user/bootchooser.rst
> +++ b/Documentation/user/bootchooser.rst
> @@ -77,6 +77,9 @@ no remaining attempts left.
>  To prevent ending up in an unbootable system after a number of failed boot
>  attempts, there is also a built-in mechanism to reset the counters to their defaults,
>  controlled by the ``global.bootchooser.reset_attempts`` variable.
> +
> +.. _bootchooser,attempts_lock:
> +
>  Alternatively, counting down the remaining attempts can be disabled by
>  locking bootchooser boot attempts.
>  This is done by defining a (32-bit) ``attempts_locked`` variable in the
> 

-- 
Pengutronix e.K.                  |                             |
Steuerwalder Str. 21              | http://www.pengutronix.de/  |
31137 Hildesheim, Germany         | Phone: +49-5121-206917-0    |
Amtsgericht Hildesheim, HRA 2686  | Fax:   +49-5121-206917-5555 |