diff options
authorVincent Sanders <>2017-09-07 09:16:25 +0100
committerVincent Sanders <>2017-09-07 09:16:25 +0100
commitf37d15f16a67b2449fb7a22f394e72394c64740c (patch)
parentaa3221e433813fea0fd306861f389a74e651be99 (diff)
add basic readme for the all source package
1 files changed, 38 insertions, 0 deletions
diff --git a/README b/README
new file mode 100644
index 0000000..8cc079d
--- /dev/null
+++ b/README
@@ -0,0 +1,38 @@
+NetSurf source -- Web Browser and all associated support libraries
+ NetSurf is a compact graphical web browser which aims for HTML5, CSS
+ and JavaScript support.
+ This complete source package contains all the required NetSurf
+ support libraries to build the browser.
+ The NetSurf project provide binary builds for releases for several
+ platforms form the website and have packaged the browser in several
+ distributions. This option may be more suitable for some users than
+ compiling from source.
+ A simple "make" is sufficient to compile the browser with the
+ default gtk toolkit selection.
+ It depends upon the host system having a suitable toolchain for
+ compiling c programs installed along with GNU make, zlib, flex,
+ bison and lipjpeg
+ In addition to the core library dependencies it is strongly
+ recommended libcurl, openssl and libpng libraries are present or the
+ browser will not have HTTP fetches, HTTPS fetches and PNG graphics
+ support respectively.
+ There are multiple GUI toolkits available which all have additional
+ dependencies i.e. gtk browser frontend requires the gtk development
+ libraries.