diff options
author | Vincent Sanders <vince@kyllikki.org> | 2018-05-10 13:34:33 +0100 |
---|---|---|
committer | Vincent Sanders <vince@kyllikki.org> | 2018-05-10 13:34:33 +0100 |
commit | 1b892391d7859398c212b9fda5b532308fa6e8fd (patch) | |
tree | 3a59e010ecea6e6913cb38a849aa54d41fc0c068 /docs/quick-start.md | |
parent | 2290c208ba69bb9f98d33c470712f9df5cc6c040 (diff) | |
download | netsurf-1b892391d7859398c212b9fda5b532308fa6e8fd.tar.gz netsurf-1b892391d7859398c212b9fda5b532308fa6e8fd.tar.bz2 |
Improve quick start documentation to match current reality
Diffstat (limited to 'docs/quick-start.md')
-rw-r--r-- | docs/quick-start.md | 45 |
1 files changed, 27 insertions, 18 deletions
diff --git a/docs/quick-start.md b/docs/quick-start.md index 8bc90de81..0fb006fd8 100644 --- a/docs/quick-start.md +++ b/docs/quick-start.md @@ -1,15 +1,18 @@ Quick Build Steps for NetSurf ============================= -Last Updated: 24 February 2015 +Last Updated: 15th December 2017 This document provides steps for building NetSurf. +Native build +============ Grab a temporary env.sh ----------------------- $ wget http://git.netsurf-browser.org/netsurf.git/plain/docs/env.sh + $ unset HOST $ source env.sh @@ -28,6 +31,11 @@ If your package manager is not supported, you will have to install third Get the NetSurf project source code from Git -------------------------------------------- +All the sources for the browser and support libraries is available + from the public git server. + +Local copies may be easily obtained with the ns-clone command. + $ ns-clone @@ -42,7 +50,7 @@ Updates NetSurf project library sources to latest, builds and installs them. Switch to new NetSurf workspace ------------------------------- -Remove the bootstrack script and use the newly installed one +Remove the bootstrap script and use the newly installed one $ rm env.sh $ cd ~/dev-netsurf/workspace @@ -54,8 +62,8 @@ Build and run NetSurf $ cd netsurf -To build the native front end (the GTK front end on Linux, BSDs, etc) you -could do: +To build the native front end (the GTK front end on Linux, BSDs, etc) + you could do: $ make $ ./nsgtk @@ -70,23 +78,23 @@ Cross Compiling =============== If you are cross compiling, you can follow the above steps, but when -sourcing env.sh, you should set HOST environment variable to the -appropriate triplet for your cross compiler. For example, to cross -compile for RISC OS: + sourcing env.sh, you should set HOST environment variable to the + appropriate triplet for your cross compiler. For example, to cross + compile for RISC OS: $ HOST=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. + `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: +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: + are developing for. For example, to produce a package for RISC OS: $ make TARGET=riscos package @@ -94,18 +102,19 @@ 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. + 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/) +Pre-built versions of the toolchains for 64bit x86 Debian systems are + available via our [automated build and test + infrastructure](http://ci.netsurf-browser.org/builds/toolchains/) Not working? ============ -If the above steps are inapplicable, or don't work, you can build manually. -Follow the instructions in the BUILDING-* documents in the docs/ directory -the NetSurf browser source tree. +If the above steps are inapplicable, or don't work, you can build + manually. Follow the instructions in the BUILDING-* documents in the + docs/ directory the NetSurf browser source tree. |