From 70f63995f26726ac7a6fa2c4e444b43ff269e49a Mon Sep 17 00:00:00 2001
From: John Vogel <jvogel4@stny.rr.com>
Date: Sat, 14 May 2016 00:17:30 -0400
Subject: [PATCH] README: start adding instructions

---
 README | 31 +++++++++++++++++++++++++++++++
 1 file changed, 31 insertions(+)

diff --git a/README b/README
index 68ded37..7aa87a7 100644
--- a/README
+++ b/README
@@ -1,10 +1,41 @@
 Crux-arm RaspberryPi2 Linux Kernel
 
+NOTE: This README is wip. Some instructions are either vague or missing.
+
 upstream sources:
   https://www.kernel.org/pub/linux/kernel/v4.x
   git://git.kernel.org/pub/scm/linux/kernel/git/statble/linux-stable.git
   https://github.com/raspberrypi/linux
 
+Type make or make all to build kernel image, the device tree files/overlays,
+modules and related files. You may also find some of the other targets useful;
+either for rebuilding only a certain target or possibly downloading files for
+later offline build. These currently include:
+
+all:        build all targets
+clean:      clean out built files/directories
+distclean:  clean, plus remove even downloaded files also
+files:      download all remote files
+config:     unpatch the kernel and copy the default config into the kernel tree
+image:      build zImage and rpi2 prep'd kernel image files
+dtb:        build device tree database/overlay files, tarball
+modules:    build kernel modules, tarball
+menuconfig: run menuconfig for kernel, starting with default kernel config
+
+For booting the kernel, you will also need to download these addition files:
+bootcode.bin: https://github.com/raspberrypi/firmware/raw/master/boot/bootcode.bin
+start.elf: https://github.com/raspberrypi/firmware/raw/master/boot/start.elf
+
+Sd card layout:
+
+first partition, boot (fat32):
+kernel-$version.img, System.map-$version, bootcode.bin, start.elf, config.txt, cmdline.txt
+Untar the dtb tarball (dtb-$version.tar.*) to the boot partition.
+
+second partition, root (ext{2,3,4}, xfs, btrfs, etc):
+Untar the modules tarball (modules-$version.tar.*) to the root partition.
+Untar all the package files created by crossrootfs and raspberrypi2-arm to
+the root partition.
 
 Generating the kernel patch:
 
-- 
2.26.2