summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorThomas Groman <tgroman@nuegia.net>2020-01-31 22:07:00 -0800
committerThomas Groman <tgroman@nuegia.net>2020-01-31 22:07:00 -0800
commit3611f93e32dc57ad71e679c6d7848fd0b20d8049 (patch)
tree4360773d4759103efbebe7ce03c57230ec0d872d
parent17e4a0cbe8f741ae31ad075de661eb0405093fba (diff)
downloadwebbrowser-3611f93e32dc57ad71e679c6d7848fd0b20d8049.tar
webbrowser-3611f93e32dc57ad71e679c6d7848fd0b20d8049.tar.gz
webbrowser-3611f93e32dc57ad71e679c6d7848fd0b20d8049.tar.lz
webbrowser-3611f93e32dc57ad71e679c6d7848fd0b20d8049.tar.xz
webbrowser-3611f93e32dc57ad71e679c6d7848fd0b20d8049.zip
added build documentation
-rw-r--r--doc/BUILD68
1 files changed, 68 insertions, 0 deletions
diff --git a/doc/BUILD b/doc/BUILD
new file mode 100644
index 0000000..9190997
--- /dev/null
+++ b/doc/BUILD
@@ -0,0 +1,68 @@
+1. Install build dependencies
+
+Python 2.7.X
+Autoconf 2.13
+Yasm 1.2.0 or newer
+Perl
+Gnu C Compiler version 4.9.3 or newer (9.X.X reccomended)
+
+2. Install runtime dependencies
+
+* Note that to make your life easier, check DEPEND.yourdistrobution for
+commands you can copypaste into your terminal instead of looking of
+looking up package names by hand
+
+libXt
+zip
+freetype
+fontconfig
+glibc
+libffi
+dbus
+dbus-glib
+gtk+2
+alsa-lib
+jack2
+libvpx (1.7.X reccomended. 1.8.X is untested)
+ffmpeg
+
+3. clone and checkout code repositories
+
+clone the Universal XUL Platform codebase somewhere
+
+$ git clone https://github.com/MoonchildProductions/UXP.git
+
+checkout the supported Web Browser supported PM_RELEASE snapshot.
+You can check what is the latest supported release by looking at
+webbrowser/config/version.txt . In this example we will use 2.8.1
+
+$ cd UXP
+$ git checkout PM28.8.2_Release
+
+clone the web browser application repo into the 'applications' folder
+
+$ cd applications
+$ git clone https://git.nuegia.net/webbrowser.git
+
+copy the example Mach build system config into the root of UXP
+
+$ cp webbrowser/doc/mozconfig.example ../.mozconfig
+
+Adjust .mozconfig to you needs if neccecary
+then go to the root of UXP
+
+$ cd ..
+
+4. compile, test, and package Web Browser
+
+./mach build
+
+if this completes successfully you can test your build before packaging it
+
+./mach run
+
+if all is well package it
+
+./mach package
+
+and then install the resulting distrobution tarball on your system.