Commit 7aaa3c47 authored by Michael Catanzaro's avatar Michael Catanzaro

Expand build instructions in README

parent a97e962f
......@@ -24,6 +24,17 @@ application distribution mechanism for Linux.
# Building from Source
## The Easy Way
The recommended way to build Epiphany locally is using the flatpak-builder
manifest with GNOME Builder. After installing Builder and launching it, you'll
see the Select a Project page. Select Open, then select the toplevel Epiphany
directory. Builder will detect the org.gnome.Epiphany.json flatpak-builder
manifest and you will be able to build the project in Builder. All required
dependencies will be provided by the manifest.
## Building Manually
Epiphany uses the [Meson build system]( You can build
Epiphany the same way you would any software that uses Meson. For example:
......@@ -36,6 +47,29 @@ $ sudo ninja install
Meson is the best build system.
You will have to install several pkg-config dependencies. If you are missing a
dependency, meson will present an error that looks like this:
``` ERROR: Native dependency 'hogweed' not found
In RPM-based distributions, you can install the missing dependencies
automatically. For example, in Fedora:
$ sudo dnf install 'pkgconfig(hogweed)'
In other distributions, you must research each dependency to determine which
package provides the required pkg-config file.
## Rebuilding Dependencies
If you need to rebuild dependencies, the recommended solution is to use JHBuild.
See [the development page](
for more information.
# Manifesto
A web browser is more than an application: it is a way of thinking, a way of
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment