bootloader: Document PARTITION_WALK

Author: timg236

documentation/asciidoc/computers/raspberry-pi/eeprom-bootloader.adoc

@@ -518,6 +518,14 @@ PARTITION=2
 
 Default: 0
 
+[[PARTITION_WALK]]
+==== `PARTITION_WALK`
+This property is designed to improve the reliability of `A/B` boot schemes using `autoboot.txt` by searching for boot-able partitions if the specified partition does not appear to be bootable. If `PARTITION_WALK=1` and the selected partition is not bootable and does not have a valid `autoboot.txt` then the bootloader will check each partition in turn (up to 8 and wrapping to 0) to see if it is bootable (contains `start.elf` or `config.txt` and a suitable device-tree on Pi5 or newer).
+
+During the "partition walk" `autoboot.txt` files are not processed to avoid cycling dependencies. It is assumed that the requested boot partition has failed and the system is attempting recovery. 
+
+Default: `0`
+
 [[PSU_MAX_CURRENT]]
 ==== `PSU_MAX_CURRENT`