summaryrefslogtreecommitdiff
path: root/Docs
diff options
context:
space:
mode:
authorMichael Drake <tlsa@netsurf-browser.org>2015-02-24 21:37:19 +0000
committerMichael Drake <tlsa@netsurf-browser.org>2015-02-24 21:37:19 +0000
commit6a51b53758cd954f1aac55fb4f2f401cdfcbc5aa (patch)
treed74ed60723f1e0988aeec569d3bb233dc47cf1ff /Docs
parentc66c9fccf3b7d326cb867de07a4fee67042e44e1 (diff)
downloadnetsurf-6a51b53758cd954f1aac55fb4f2f401cdfcbc5aa.tar.gz
netsurf-6a51b53758cd954f1aac55fb4f2f401cdfcbc5aa.tar.bz2
Add some general cross-compilation instructions.
Diffstat (limited to 'Docs')
-rw-r--r--Docs/QUICK-START36
1 files changed, 36 insertions, 0 deletions
diff --git a/Docs/QUICK-START b/Docs/QUICK-START
index 237027b71..67920a33c 100644
--- a/Docs/QUICK-START
+++ b/Docs/QUICK-START
@@ -63,6 +63,42 @@
$ ./nsfb
+ Cross Compiling
+=================
+
+ If you are cross compiling, you can follow the above steps, but when sourcing
+ env.sh, you should set TARGET_ABI to the appropriate triplet for your cross
+ compiler. For example, to cross compile for RISC OS:
+
+ $ TARGET_ABI=arm-unknown-riscos source env.sh
+
+ After that, the commands such as `ns-package-install` and `ns-pull-install`
+ will do what is appropriate for the platform you are building for.
+
+ To do the final build of NetSurf, pass the appropriate TARGET to make. For
+ example, to cross compile for RISC OS:
+
+ $ make TARGET=riscos
+
+ Finally, you can package up your build to transfer to the system you are
+ developing for. For example, to produce a package for RISC OS:
+
+ $ make TARGET=riscos package
+
+ Getting a cross compiler set up
+---------------------------------
+
+ We maintain cross compilation environments and an SDK for a number of
+ platforms. These may be found in our toolchains repository.
+
+ $ git clone git://git.netsurf-browser.org/toolchains
+
+ Pre-built versions of the toolchains for Debian systems are often available
+ via our automated build and test infrastructure:
+
+ http://ci.netsurf-browser.org/builds/toolchains/
+
+
Not working?
==============