diff options
Diffstat (limited to 'docs/quick-start.md')
-rw-r--r-- | docs/quick-start.md | 62 |
1 files changed, 42 insertions, 20 deletions
diff --git a/docs/quick-start.md b/docs/quick-start.md index 8bc90de81..449b956a3 100644 --- a/docs/quick-start.md +++ b/docs/quick-start.md @@ -1,15 +1,29 @@ Quick Build Steps for NetSurf ============================= -Last Updated: 24 February 2015 +Last Updated: 21st January 2020 This document provides steps for building NetSurf. +These instructions use a shell script to perform several operations. + This script has only been tested with the bash and zsh bourne style + shell interpreters. The latest version of this script should be + retrieved from the official NetSurf source repository. + +This shell script is used by the NetSurf Developers but you should + satisfy yourself that the script is not malicious. It should be noted + that building the browser will also be executing shell code and + requires a similar level of trust. + + +Native build +============ Grab a temporary env.sh ----------------------- - $ wget http://git.netsurf-browser.org/netsurf.git/plain/docs/env.sh + $ wget https://git.netsurf-browser.org/netsurf.git/plain/docs/env.sh + $ unset HOST $ source env.sh @@ -28,6 +42,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 +61,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,39 +73,41 @@ 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 + $ ./nsgtk3 To build the framebuffer front end, you could do: $ make TARGET=framebuffer $ ./nsfb +More detailed documentation on using the [framebuffer](docs/using-framebuffer.md) + frontend are available. 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 +115,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](https://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. |