doc: Add section about booting Linux

diff --git a/README.pod b/README.pod
index 0144b88f196bac86f4e8dac994446bcac59e4e48..61dadb0e08259e37b7c103828133058da55c0c2b 100644 (file)
--- a/README.pod
+++ b/README.pod
@@ -804,6 +804,12 @@ word after C<load> is a file name (relative to the build directory
 (see B<--build-dir>) of the module to load and the remaining words are
 passed to it as the command line parameters.
 
+When booting Linux, the first C<load> line usually refers to the
+kernel image and its command line parameters (unless you use some
+special pre-loader). Other C<load> lines may refer to an initramfs
+image and/or a device tree blob. Their order is not important, as the
+device tree is recognized as the file name ending with C<.dtb>.
+
 When the C<load> line ends with "<<WORD" then the subsequent lines
 until the line containing solely WORD are copied literally to the file
 named on that line. This is similar to shell's heredoc feature.

diff --git a/novaboot b/novaboot
index f4fcdc95ade687cb267cf789e3d07ddb9a36d8a8..4d9b94b553391ab7d9bd34bdcb9acdde31cdff72 100755 (executable)
--- a/novaboot
+++ b/novaboot
@@ -2144,6 +2144,12 @@ word after C<load> is a file name (relative to the build directory
 (see B<--build-dir>) of the module to load and the remaining words are
 passed to it as the command line parameters.
 
+When booting Linux, the first C<load> line usually refers to the
+kernel image and its command line parameters (unless you use some
+special pre-loader). Other C<load> lines may refer to an initramfs
+image and/or a device tree blob. Their order is not important, as the
+device tree is recognized as the file name ending with C<.dtb>.
+
 When the C<load> line ends with "<<WORD" then the subsequent lines
 until the line containing solely WORD are copied literally to the file
 named on that line. This is similar to shell's heredoc feature.