Macintosh-SW/tenfourfox
1
0
Fork 0
mirror of https://github.com/classilla/tenfourfox.git synced 2024-06-18 12:29:44 +00:00
Code Issues Projects Releases Wiki Activity

mark obsolete

Cameron Kaiser 2016-08-03 18:40:22 -07:00
parent 8adb25d26d
commit 77e2e0d86c
1 changed files with 3 additions and 11 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

14
HowToBuild38.md

@ -1,4 +1,4 @@
This document only covers the `mozilla-esr38` branch, from which TenFourFox 38 is built. It does not cover any other version.
This document only covers the `mozilla-esr38` branch, from which TenFourFox 38 is built. It does not cover any other version. **This version is now obsolete and will not receive further updates.**
## Warning
@ -25,9 +25,9 @@ These build instructions are always subject to change. You should be familiar wi
* Somewhere in the 31-37 timeframe, stripping builds created with `gcc` 4.6 started to fail due to what appears to be a compiler bug. To fix this requires a modified `strip` binary (renamed `strip7` so it does not conflict with the regular `strip`) that ignores the variant `N_SECT`s this compiler can generate. You should not use this strip tool for other purposes, as it is intentionally loose with the specification, and you do not need to install it if you are only building a debug or non-stripped build for your own use. Decompress the binary and put it in `/opt/local/bin/strip7` (the configure script is hardcoded to this location). You can get it from [SourceForge](https://sourceforge.net/projects/tenfourfox/files/tools/).
* Finally, you must install the TenFourFox debugger, because the `gdb` available with any PowerPC Xcode does not properly grok debugging symbols generated by later `gcc` versions. At least patchlevel 2 is required for the current version of 10.4Fx. Decompress and copy the binary to `/usr/local/bin/gdb7` or wherever it is convenient. Although you can use it to replace your current `gdb`, it's probably safer that you do not. You can also get it from [SourceForge](https://sourceforge.net/projects/tenfourfox/files/tools/).
## Building the stable release from the Mozilla ESR
## Building TenFourFox 38 from Firefox 38ESR
Mozilla's most current stable ESR is the basis for our stable branch (as opposed to the unstable, described below). As of this writing, it is ESR 38.
TenFourFox 38 was based on the 38ESR release.
* In your nice fat source drive, `hg clone http://hg.mozilla.org/releases/mozilla-esr38` (or the desired revision).
* Did the Mozilla tree change after you cloned it? If your changesets are against tip, **STOP**. Do an `hg pull` and `hg up` right now to make sure your tree is current.
@ -61,10 +61,6 @@ This will create a new blank repo, add everything to it, and then commit. Note t
Once you've done that, resume from step 2 above, since this will now act as your "cloned repo." For old versions of Firefox, you should probably use the 10.4Fx patches that correspond to that rather than the most current changesets, obviously.
## Building the unstable release from `mozilla-release`
The unstable release is not supported with `gcc` 4.6. That said, you can still try to build it with the existing 4.6 compatibility shim if you're that blessed with spare time. The unstable version is built from the bleeding edge Mozilla release, which is always `mozilla-release`, whether it still works with TenFourFox or not. The steps are the same as above, so you should make sure you can build a functional stable release binary before you attempt to build an unstable one.
## Running and debugging
If the build worked, try out your binary in the TenFourFox debugger. We will assume you installed it to `/usr/local/bin/gdb7` or somewhere else otherwise suitable in your path:
@ -89,10 +85,6 @@ If you built on 10.5 with a compiler that was also built on 10.5, your built bro
If you prefer Fink to MacPorts, David Fang is maintaining a Fink package. You should consider this package experimental. Install Fink and the unstable tree, and do `fink install tenfourfox`. This will install all prerequisites and build the browser, and a `.deb` will be generated. You can start the executable from `/Applications/Fink/TenFourFox.app`. This may not yet be available for the most current version.
## Building from `mozilla-beta` or `mozilla-aurora`
Neither branch is supported with `gcc` 4.6. That said, you can still try to build with the existing 4.6 compatibility shim if you're that blessed with spare time. To build whatever the upcoming release(s) are, use these trees instead (substitute the desired tree for `mozilla-release`). In general, we don't support building from `mozilla-central`, and we usually do not offer Aurora changesets, so you're on your own. The beta branch may work, but will require manual merging of the changesets. Try to use as recent a revision as possible.
## Keeping up
Your repo is now a fully functional clone of the Firefox source repo with the patches for 10.4Fx. If you want to use this as your basis to do additional pulls against Mozilla's repo, you can (after committing your local changes, of course), but you should `hg rebase` after each pull so that the local TenFourFox changesets float to the top.