Single-document documentation format

[Heinrich Schuchardt]

On 2/18/22 18:05, Tom Rini wrote:
> On Fri, Feb 18, 2022 at 01:30:17PM +0700, Tom Hale wrote:
>
>> I'm having a lot of trouble finding the definition of certain commands, eg
>> "fatload":

The source code has:

U_BOOT_CMD(
fatload,7,      0,      do_fat_fsload,
"load binary file from a dos filesystem",
"<interface> [<dev[:part]> [<addr> [<filename> [bytes [pos]]]]]\n"
"    - Load binary file 'filename' from 'dev' on 'interface'\n"
"      to address 'addr' from dos filesystem.\n"
"      'pos' gives the file position to start loading from.\n"
"      If 'pos' is omitted, 0 is used. 'pos' requires 'bytes'.\n"
"      'bytes' gives the size to load. If 'bytes' is 0 or omitted,\n"
"      the load stops on end of file.\n"
"      If either 'pos' or 'bytes' are not aligned to\n"
"      ARCH_DMA_MINALIGN then a misaligned buffer warning will\n"
"      be printed and performance will suffer for the load."

fatload is just wrapper for the load command restricted to FAT file
systems. Use load instead. It is described here:

https://u-boot.readthedocs.io/en/latest/usage/load.html

Best regards

Heinrich

>>
>> https://www.denx.de/wiki/view/DULG/WebSearch?search=fatload&web=on&scope=text
>>
>> Is there an updated single page that I can search if I can't work out how to
>> make search work for me?
>
> Please start from https://u-boot.readthedocs.io/en/latest/ (and the wiki
> needs to be cleaned up, sigh) thanks!
>