aboutsummaryrefslogtreecommitdiffstats
path: root/README
diff options
context:
space:
mode:
authorKevin Darbyshire-Bryant <ldir@darbyshire-bryant.me.uk>2018-07-07 22:23:01 +0100
committerKevin Darbyshire-Bryant <ldir@darbyshire-bryant.me.uk>2018-07-08 09:41:53 +0100
commit5781fc6b3f4fade6229390c364c7d7cca514ec76 (patch)
treeff1c9ef3c181fa5f979c90424857fbee95dca0b3 /README
parentedf338f248a270f5fd85edc04775ec5ed6d46bca (diff)
downloadupstream-5781fc6b3f4fade6229390c364c7d7cca514ec76.tar.gz
upstream-5781fc6b3f4fade6229390c364c7d7cca514ec76.tar.bz2
upstream-5781fc6b3f4fade6229390c364c7d7cca514ec76.zip
build: Update README & github help
Update README to include Openwrt branding and improve wording. Point at the Openwrt wiki in .github templates. Signed-off-by: Kevin Darbyshire-Bryant <ldir@darbyshire-bryant.me.uk>
Diffstat (limited to 'README')
-rw-r--r--README37
1 files changed, 21 insertions, 16 deletions
diff --git a/README b/README
index 864ea2f1b9..c352331fba 100644
--- a/README
+++ b/README
@@ -1,26 +1,31 @@
-This is the buildsystem for the OpenWrt Linux distribution.
+ _______ ________ __
+ | |.-----.-----.-----.| | | |.----.| |_
+ | - || _ | -__| || | | || _|| _|
+ |_______|| __|_____|__|__||________||__| |____|
+ |__| W I R E L E S S F R E E D O M
+ -----------------------------------------------------
-Please use "make menuconfig" to choose your preferred
-configuration for the toolchain and firmware.
+This is the buildsystem for the OpenWrt Linux distribution.
-You need to have installed gcc, binutils, bzip2, flex, python, perl, make,
-find, grep, diff, unzip, gawk, getopt, subversion, libz-dev and libc headers.
+To build your own firmware you need a Linux, BSD or MacOSX system (case
+sensitive filesystem required) Cygwin is unsupported because of the lack
+of a case sensitive file system.
-Run "./scripts/feeds update -a" to get all the latest package definitions
-defined in feeds.conf / feeds.conf.default respectively
-and "./scripts/feeds install -a" to install symlinks of all of them into
-package/feeds/.
+You need gcc, binutils, bzip2, flex, python, perl, make, find, grep, diff,
+unzip, gawk, getopt, subversion, libz-dev and libc headers installed.
-Use "make menuconfig" to configure your image.
+1. Run "./scripts/feeds update -a" to obtain all the latest package definitions
+defined in feeds.conf / feeds.conf.default
-Simply running "make" will build your firmware.
-It will download all sources, build the cross-compile toolchain,
-the kernel and all choosen applications.
+2. Run "./scripts/feeds install -a" to install symlinks for all obtained
+packages into package/feeds/
-To build your own firmware you need to have access to a Linux, BSD or MacOSX system
-(case-sensitive filesystem required). Cygwin will not be supported because of
-the lack of case sensitiveness in the file system.
+3. Run "make menuconfig" to select your preferred configuration for the
+toolchain, target system & firmware packages.
+4. Run "make" to build your firmware. This will download all sources, build
+the cross-compile toolchain and then cross-compile the Linux kernel & all
+chosen applications for your target system.
Sunshine!
Your OpenWrt Community