From 5781fc6b3f4fade6229390c364c7d7cca514ec76 Mon Sep 17 00:00:00 2001 From: Kevin Darbyshire-Bryant Date: Sat, 7 Jul 2018 22:23:01 +0100 Subject: 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 --- README | 37 +++++++++++++++++++++---------------- 1 file changed, 21 insertions(+), 16 deletions(-) (limited to 'README') 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 -- cgit v1.2.3