2022-02-03 04:58:11 -05:00
## LibreWolf build instructions
2022-02-03 04:17:35 -05:00
2022-02-03 04:57:05 -05:00
First, let's ** [download the latest tarball ](https://gitlab.com/librewolf-community/browser/source/-/jobs/artifacts/main/raw/librewolf-__VERSION__-__RELEASE__.source.tar.gz?job=Build )**. This tarball is the latest produced by the [CI ](https://gitlab.com/librewolf-community/browser/source/-/jobs ).
```
tar xf < tarball >
cd < folder >
make bootstrap build package run
```
2022-02-03 04:58:11 -05:00
#### How to make a patch:
2022-02-03 04:57:05 -05:00
The easiest way to make patches is to go to the LibreWolf source folder:
```
cd librewolf-$(cat version)
git init
git add < path_to_file_you_changed >
git commit -am initial-commit
git diff > ../mypatch.patch
```
We have Gitter / Matrix rooms, and on the website we have links to the various issue trackers.
#### Building LibreWolf with git:
2022-02-03 04:17:35 -05:00
1. Clone the git repository via https:
```
git clone --recursive https://gitlab.com/librewolf-community/browser/source.git
```
or Git:
```
git clone --recursive git@gitlab.com:librewolf-community/browser/source.git
```
cd into it, build the LibreWolf tarball, bootstrap the buld environment, and finally, perform the build:
```
cd source
make all
make bootstrap
make build
```
2022-02-03 04:26:16 -05:00
After that, you can either build a tarball from it, or run it:
```
make package
make run
```
2022-02-03 05:20:10 -05:00
#### How to create a patch for problems in mozilla's [bugzilla](https://bugzilla.mozilla.org/).
Well, first of all:
* [Create an account ](https://bugzilla.mozilla.org/createaccount.cgi ).
* Handy link: [Bugs Filed Today ](https://bugzilla.mozilla.org/buglist.cgi?cmdtype=dorem&remaction=run&namedcmd=Bugs%20Filed%20Today&sharer_id=1&list_id=15939480 ).
* The essential: [Firefox Source Tree Documentation ](https://firefox-source-docs.mozilla.org/ ).
Now that you have a patch, that's not enough to upload to Mozilla. See, Mozilla only accepts patches against Nightly. So here is how to get that:
```
hg clone https://hg.mozilla.org/mozilla-unified
cd mozilla-unified
hg update
MOZBUILD_STATE_PATH=$HOME/.mozbuild ./mach --no-interactive bootstrap --application-choice=browser
./mach build
./mach run
```
Now you can apply your patch to Nightly:
```
patch -p1 -i ../mypatch.patch
```
Now you let Mercurial create the patch:
```
hg diff > ../my-nightly-patch.patch
```
And it can be uploaded to BugZilla.