path: root/README
diff options
authorGravatar Arnout Vandecappelle <arnout@mind.be>2015-03-21 20:49:48 +0100
committerGravatar Thomas Petazzoni <thomas.petazzoni@free-electrons.com>2015-04-04 15:19:25 +0200
commite8a3da43e0807fd21ffedaa2bdad481f6b2d175e (patch)
tree79969e5449eccb4622a3c29aed36e2e56c46edfb /README
parentb1e0b6d736481efedd4036be414105eb4b5b581b (diff)
README: reduce it to a single page and refer to other documentation
As discussed on the BR developer meeting at FOSDEM, the README should be very short and instead refer to other documentation: the manual, the website, the mailing list, the IRC channel. Signed-off-by: Arnout Vandecappelle (Essensium/Mind) <arnout@mind.be> Signed-off-by: Thomas Petazzoni <thomas.petazzoni@free-electrons.com>
Diffstat (limited to 'README')
1 files changed, 10 insertions, 49 deletions
diff --git a/README b/README
index 944347dd61..a7dae24729 100644
--- a/README
+++ b/README
@@ -1,59 +1,20 @@
+Buildroot is a simple, efficient and easy-to-use tool to generate embedded
+Linux systems through cross-compilation.
+The documentation can be found in docs/manual. You can generate a text
+document with 'make manual-text' and read output/docs/manual/manual.text.
+Online documentation can be found at http://buildroot.org/docs.html
To build and use the buildroot stuff, do the following:
1) run 'make menuconfig'
-2) select the packages you wish to compile
+2) select the target architecture and the packages you wish to compile
3) run 'make'
4) wait while it compiles
-5) Use your shiny new root filesystem. Depending on which sort of
- root filesystem you selected, you may want to loop mount it,
- chroot into it, nfs mount it on your target device, burn it
- to flash, or whatever is appropriate for your target system.
+5) find the kernel, bootloader, root filesystem, etc. in output/images
You do not need to be root to build or run buildroot. Have fun!
-Offline build:
-In order to do an offline-build (not connected to the net), fetch all
-selected source by issuing a
-$ make source
-before you disconnect.
-If your build-host is never connected, then you have to copy buildroot
-and your toplevel .config to a machine that has an internet-connection
-and issue "make source" there, then copy the content of your dl/ dir to
-the build-host.
-Building out-of-tree:
-Buildroot supports building out of tree with a syntax similar
-to the Linux kernel. To use it, add O=<directory> to the
-make command line, E.G.:
-$ make O=/tmp/build
-And all the output files (including .config) will be located under /tmp/build.
-More finegrained configuration:
-You can specify a config-file for uClibc:
-$ make UCLIBC_CONFIG_FILE=/my/uClibc.config
-And you can specify a config-file for busybox:
-$ make BUSYBOX_CONFIG_FILE=/my/busybox.config
-To use a non-standard host-compiler (if you do not have 'gcc'),
-make sure that the compiler is in your PATH and that the library paths are
-setup properly, if your compiler is built dynamically:
-$ make HOSTCC=gcc-4.3.orig HOSTCXX=gcc-4.3-mine
-Depending on your configuration, there are some targets you can use to
-use menuconfig of certain packages. This includes:
-$ make HOSTCC=gcc-4.3 linux-menuconfig
-$ make HOSTCC=gcc-4.3 uclibc-menuconfig
-$ make HOSTCC=gcc-4.3 busybox-menuconfig
Please feed suggestions, bug reports, insults, and bribes back to the
buildroot mailing list: buildroot@buildroot.org
+You can also find us on #buildroot on Freenode IRC.