aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorGoogle Code Exporter <GoogleCodeExporter@users.noreply.github.com>2015-03-18 18:59:01 -0400
committerGoogle Code Exporter <GoogleCodeExporter@users.noreply.github.com>2015-03-18 18:59:01 -0400
commitd21231d0c0393fa05b4f8d367044c95681e139c5 (patch)
tree07fae0d6a1b8f5129f3f026721fd15fdf01ec43b
downloadjuniper-browser-wiki.tar.gz
juniper-browser-wiki.tar.bz2
juniper-browser-wiki.zip
Migrating wiki contents from Google Codewiki
-rw-r--r--Debugging.md22
-rw-r--r--InstallationGuide.md66
-rw-r--r--ProjectHome.md16
-rw-r--r--WebKitBugs.md5
4 files changed, 109 insertions, 0 deletions
diff --git a/Debugging.md b/Debugging.md
new file mode 100644
index 0000000..52f7ba1
--- /dev/null
+++ b/Debugging.md
@@ -0,0 +1,22 @@
+WebKit/GTK is still somewhat experimental and incomplete, and crashes happen from time to time. If you have the time, we greatly appreciate information on crashes. If you notice any crash while using Juniper, even if you suspect it is related to WebKit, please report it to our issue tracker. This allows us to make sure no Juniper-specific crashes get into the WebKit bug tracker, and also means we might fix the problem in WebKit sooner.
+
+To compile a debug build of WebKit, please run the following inside the repository root:
+
+```
+WebKitTools/Scripts/set-webkit-configuration --debug
+WebKitTools/Scripts/build-webkit --gtk
+```
+
+Then, copy the generated libraries over the non-debug ones, as root:
+
+```
+cp WebKitBuild/Debug/lib/* /usr/lib/
+```
+
+There is a commented-out CFLAGS line in Juniper's `build.sh` that enables `-ggdb` for debugging support. Comment out the existing CFLAGS line and uncomment this one, then run:
+
+```
+./build.sh
+```
+
+Run Juniper under GDB and supply us with as much information as possible about the crash. \ No newline at end of file
diff --git a/InstallationGuide.md b/InstallationGuide.md
new file mode 100644
index 0000000..4942e7b
--- /dev/null
+++ b/InstallationGuide.md
@@ -0,0 +1,66 @@
+# Dependencies #
+
+The main dependency is WebKit/GTK. Installation instructions for this are provided below.
+
+We also depend on the following packages, all of which should be available in your distribution repositories. On most Gnome systems, they will already be installed, though you might need to install the -dev variants on binary distributions (like Ubuntu).
+
+ * libglade-2.0
+ * gtk+-2.0
+ * gtksourceview-1.0
+ * libxml2
+
+# WebKit #
+
+You'll need to install the WebKit/GTK library first. This is pretty straightforward.
+
+Download the latest six-hourly snapshot of the WebKit SVN repository (this is much faster than checking it out via SVN as the repository is huge) and extract it:
+
+```
+wget http://live.nightly.webkit.org/files/WebKit-SVN-source.tar.bz2
+tar xjf WebKit-SVN-source.tar.bz2
+```
+
+Enter the created directory and build the WebKit source (this will take a little while depending on your system specs):
+
+```
+cd WebKit
+WebKitTools/Scripts/build-webkit --gtk
+```
+
+Install the WebKit libraries and header files:
+
+```
+cd WebKitBuild/Release
+sudo make install
+cd -
+```
+
+If you later want to update the repository before building again, run:
+
+```
+WebKit/WebKitTools/Scripts/update-webkit
+```
+
+# Juniper #
+
+Once you have WebKit libraries and headers installed, building Juniper is simple. Just check out the source and then run our build script from within the checked out source directory:
+
+```
+svn co http://juniper-browser.googlecode.com/svn/trunk/ juniper
+cd juniper
+./build.sh
+```
+
+To build with debugging messages enabled on stdout, use:
+
+```
+./build.sh -DDEBUG
+```
+
+After building, install Juniper with:
+
+```
+sudo ./install.sh
+```
+
+You can then run 'juniper' to launch the browser. \ No newline at end of file
diff --git a/ProjectHome.md b/ProjectHome.md
new file mode 100644
index 0000000..1c83f86
--- /dev/null
+++ b/ProjectHome.md
@@ -0,0 +1,16 @@
+Juniper is a lightweight, WebKit-based browser for GTK+. It is intended to eventually run on any platform GTK+ runs on, but currently has only been tested on Linux.
+
+Juniper's main goals are:
+ * Code correctness and simplicity
+ * Minimal browser core with all extra features implemented as plugins which can be individually disabled
+ * High performance and low memory footprint
+ * Excellent web developer support (likely implemented via plugins, but shipped with the browser)
+
+Since Juniper uses WebKit for document parsing, script execution and rendering, it inherits many great features of WebKit, including:
+ * Best-of-breed rendering standards compliance
+ * Excellent CSS support, including many CSS3 features
+ * Modern, fast JavaScript engine
+ * HTML5 client-side database storage
+ * Client-side XSLT and XPath support
+
+An InstallationGuide is available. No releases have been made of Juniper yet, so installation involves checking out the Subversion repository. Releases will be made once a stable version of WebKit/GTK is available. \ No newline at end of file
diff --git a/WebKitBugs.md b/WebKitBugs.md
new file mode 100644
index 0000000..52cd908
--- /dev/null
+++ b/WebKitBugs.md
@@ -0,0 +1,5 @@
+As part of developing Juniper, we submit both bugs and patches to WebKit. You can obtain a list of the current [GTK bugs in WebKit's tracker](http://bugs.webkit.org/buglist.cgi?bug_status=UNCONFIRMED&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&field0-0-0=product&type0-0-0=substring&value0-0-0=gtk&field0-0-1=component&type0-0-1=substring&value0-0-1=gtk&field0-0-2=short_desc&type0-0-2=substring&value0-0-2=gtk&field0-0-3=status_whiteboard&type0-0-3=substring&value0-0-3=gtk).
+
+Currently, we have supplied patches for the following bugs, which have not yet been committed to the WebKit Subversion repository. You may want to download and apply these patches manually.
+
+ * [#15108](http://bugs.webkit.org/show_bug.cgi?id=15108) Wheel scrolling scrolls by too far in the GTK port \ No newline at end of file