Macintosh-SW
/
tenfourfox
mirror of https://github.com/classilla/tenfourfox.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity

Migrating wiki contents from Google Code

This commit is contained in:
Google Code Exporter 2015-08-09 17:46:48 -04:00
commit 30378b4973
99 changed files with 6262 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

229
AAATheFAQ.md Normal file
View File

@ -0,0 +1,229 @@
**Please don't modify this document unless you are authorized to do so. Comments not related or relevant to the most current release of TenFourFox may be deleted for space.**
# TenFourFox Frequently Asked Questions #
This page is for frequently asked questions about TenFourFox (or, as we abbreviate it, 10.4Fx). Some of these are also answered on the main site and other places in Google Code, but are also provided here for convenience.
Questions answered in the FAQ are generally pertinent only to the **most current version of 10.4Fx** although notes about earlier versions are also included for reference.
## What is TenFourFox? ##
TenFourFox (_hereafter 10.4Fx_) is a port of Firefox to the Power Macintosh, running either Mac OS X 10.4 or 10.5.
## Why make 10.4Fx? ##
Mozilla stopped supporting Power Macintosh and Mac OS X v10.4 with Firefox 4/Mozilla 2.0, both of which remain important and in our humble opinion viable platforms, particularly for people who need to run older software or use Classic. We fall into this category. This is our attempt to rectify the disparity.
## Why isn't it called Firefox? ##
10.4Fx is not called Firefox because technically it isn't, and therefore legally it can't be. Mozilla's trademark conditions require that builds named Firefox be based on unmodified source, and 10.4Fx is modified.
## What modifications were made to 10.4Fx? ##
See TechnicalDifferences for the current set. In broad strokes, however, 10.4Fx contains modified widget code to work with OS X Tiger, contains modified font code to remove Mozilla's dependency on CoreText, disables graphics acceleration and WebGL (which are not compatible with Tiger), and includes AltiVec- and PowerPC-specific code such as its own JavaScript JIT accelerator and WebM decoder. There are other smaller changes due to the older build system available to 10.4.
## Does Mozilla support TenFourFox? ##
**No. TenFourFox is not an official Mozilla build or product.** That said, our project lead is a member of the Mozilla security group, and all our contributors routinely upstream patches we believe of benefit to other PowerPC builds of Firefox, which Mozilla accepts. However, we maintain separate support networks, build systems, and distribution infrastructure which Mozilla has no role in operating; no one working on this port is a Mozilla employee; and the project receives no material support from Mozilla. In short, we are no different to Mozilla than any other 3rd-party "Tier 3" port.
## What is the difference between the _stable_ and _unstable_ branches? ##
(This question does not apply to version 9.0 and earlier.)
The _stable_ branch of TenFourFox is based on the Firefox extended support release, otherwise known as the Firefox **ESR**. The ESR receives bugfixes and security updates from Mozilla, but no new Firefox-general features. The _unstable_ branch of TenFourFox is based upon the current version of Firefox.
The _stable_ branch, despite its name, does receive selected new TenFourFox features and does have "betas" for testing them, but does not receive other feature updates from Mozilla. Although it is not as technologically advanced as the _unstable_ branch, it is based on tested and stable code and receives security updates, and therefore **the stable branch is the recommended version for most users.**
Because the _unstable_ branch is not a release-quality version, it frequently has known bugs, and therefore is only recommended for developers and advanced users. Nevertheless, we encourage technically proficient users to help us develop and keep the PowerPC Firefox port viable. If you are interested in helping to test the _unstable_ branch, please visit the [TenFourFox Development](http://tenfourfox.blogspot.com/) blog.
## Are there other PowerPC OS X builds of Firefox? ##
We are no longer aware of other current builders. For a period of time AuroraFox issued a 10.5-only build, but is no longer supported as of Firefox 20. There are also some older Firefox rebuilds for Power Macs made directly from Mozilla's source code, but none of them are still maintained.
However, there is a Tenfourbird based on 10.4Fx code for Thunderbird users, compatible with 10.4 and 10.5, and a version of SeaMonkey for 10.5 only.
We do not officially endorse any alternative build (other than our own, of course), although some of these builders also contribute to this project.
## Why are there four different versions? Which one do I pick? ##
10.4Fx comes in processor-tuned variants to give you the best speed on your particular Macintosh. The G4 and G5 versions include AltiVec code, for example, and the G5 JavaScript accelerator is tuned differently for better performance on the PowerPC 970. If you are using a G3 or a G5, you should use the G3 or G5 version, respectively. If you are using a G4, see WhichVersion for whether you should use the 7400 or 7450 build.
## Can 10.4Fx run on Panther? (Jaguar, etc.?) ##
No. OS X 10.3 does not contain the secret CoreText that is necessary for portions of the underlying font code, and because current versions of Firefox depend strongly on Cocoa, the core operating system libraries in general are not advanced enough to support the browser base. There is no easy way to fix this. For Panther, your best bet is probably Camino 1.6.1; you might also consider SeaMonkey 1.1, which will work for Jaguar too. You could also run [Classilla](http://www.classilla.org/) in Classic, which is also your best option for 10.0-10.1 if anyone is still running that, and of course OS 8.6 and OS 9.
## I started up TenFourFox and it doesn't work/won't start. Don't you even test your software? ##
No, we don't use the browser we write, at all. :P Joking aside, serious crippling issues like this are usually due to something local; failure to even start up would be rapidly apparent to our testing audience. To diagnose the problem will need a little detective work.
The first thing to try when the browser won't work or won't even start is to try to start in safe mode -- hold down the Option key as you start 10.4Fx. This will disable any problematic extensions and themes and certain other browser features. If this fixes the problem, you should attempt to find which extension or feature is the problem. Some older extensions may cause serious issues with the browser.
If this doesn't fix it, you should try [starting with a blank profile](http://tenfourfox.tenderapp.com/kb/general/how-to-reset-your-profile) instead of your earlier Firefox profile. Profiles created by versions of Firefox prior to 3.6 may corrupt or be unreadable to 10.4Fx. **If you upgraded from a very old version of Firefox (such as 2.x, 3.0 or 3.5) directly to TenFourFox, your profile probably won't work. You should try to upgrade to versions inbetween if you want to keep your profile so that information is properly upgraded at each step.** See _Will 10.4Fx use all my Firefox settings?_ below for more information. You may be able to keep the profiles separate if you are unable to do this, though it is not recommended.
If you want to open a support ticket, please include any output from `Console.app` that appears when you start the application (don't cut and paste everything, just what is new).
[Mozilla's Firefox OS X support pages](http://support.mozilla.com/en-US/kb/Firefox%20will%20not%20start) also have other suggestions for fixing startup problems.
Also, see if the suggestions in the next question help you: ...
## 10.4Fx says that it is "not supported on this architecture." ##
There are several causes for this message:
* You accidentally downloaded Firefox, not TenFourFox. Firefox is an Intel-only application and will not run on a Power Mac.
* You accidentally downloaded the wrong architecture version. A Power Mac G3 will not run anything but the G3 version; the G4 or G5 versions will either give you this message or not run at all.
* The tool you used to unzip 10.4Fx corrupted it. **Do not use third-party unzipping tools (such as Zipeg and others) to open the .zip file; it may corrupt the application.** Use the native OS X archive utility that comes with Tiger and Leopard (it is in `/System/Library/CoreServices/BOMArchiveHelper.app`, or you can try right-clicking on the .zip file and selecting it from the `Open With...` list).
## 10.4Fx is very slow when it starts up. ##
Since Firefox 5, Mozilla has required that most of the components of the browser be combined into a large "superlibrary" called _XUL_; it is no longer possible to run with the pieces separated anymore. XUL contains the bulk of the browser's code, roughly 70MB in size in current versions, and when the browser starts up this entire library needs to be scanned and components loaded from it. Part of this process happens on startup, but some happens on demand, so the first few pages you load might be slower than they should be. On a fast G5, this might be only a matter of a few seconds, but obviously it takes longer on computers with slower CPUs or slower hard disks.
There is a silver lining, though: once XUL is mostly/fully loaded, much of it remains in memory, and the browser becomes considerably faster. Plus, because the components are kept all in one place, certain types of glue code can be dispensed with, allowing the browser to have even less overhead once it's fully loaded. As long as you keep the browser open and don't quit it (you can sleep your Mac with 10.4Fx running), you won't have to pay this startup penalty again unless you have to restart the browser.
## Can 10.4Fx run on an Intel Mac with 10.4 or 10.5? ##
Yes, but: **Intel Macintoshes are not supported. Please do not ask for support on Tenderapp.** Because Intel is a better-known architecture to attackers than PowerPC, both Intel 10.4 and 10.5 are much more likely to be successfully attacked than PowerPC, even though both technically have the same or similar security holes. You are strongly advised to update to at least Snow Leopard (10.6) and run the regular Firefox, which will give you security updates and still lets you run most OS X PowerPC applications. Apple still sells Snow Leopard, which even the earliest Intel Macs can run and is a necessary prerequisite for 10.7 through 10.9: http://store.apple.com/us/product/MC573/mac-os-x-106-snow-leopard
That having been said, if you are absolutely unable or unwilling to upgrade your Intel Mac, it is possible to run TenFourFox on it under Rosetta with 10.4-10.6. However, because TenFourFox uses advanced custom code specific to the PowerPC architecture, Rosetta may have compatibility problems running the browser. Follow the steps below:
* First, make sure you are using the _G3_ version; the others, particularly the G5 version, will not work with Rosetta under _any_ circumstances.
* Second, if the browser crashes when you try to start it, try to restart it in **safe mode** (hold down the Option key as you start the browser). If this allows the browser to start, you will need to disable the JavaScript compiler permanently. Go to `about:config` by typing it in your address bar. Find all the preferences starting with `javascript.options.baselinejit` and `javascript.options.ion` and make sure they are set to `false` by double-clicking the value. If they are already false, leave them alone. **Do not change any other options.** Restart 10.4Fx and see if this fixes the problem. You can also try this if you experience inexplicable crashes with 10.4Fx on your Intel Mac, even if it appears to start normally.
In general, using Rosetta to run TenFourFox will be noticeably _slower_ on an Intel Mac, even if you are successful in starting it up. The reason is that Rosetta must convert all the PowerPC code in it into Intel machine language on the fly and there is no AltiVec or other acceleration support. As a result, it will appear to be much slower than Firefox 3.6, 10 or 16, all of which have native Intel code. However, it is more up-to-date with security patches and fixes, so you may prefer it if your Intel Mac is sufficiently fast enough.
At one time a TenFourFox 17.0.2 was available for Intel, donated by a contributor, but is no longer being maintained. You should not use this version any more due to known security vulnerabilities. If you can help with building and maintaining a newer release, please post to the development blog.
Finally, let us say it again: **Intel Macintoshes are not supported under any circumstances, period.** Power Macs remain the primary focus of support and development; any indulgence of Intel Macs is on a best-effort basis only. Seriously, please do us all a favour and install Snow Leopard and run the real Firefox.
## Will 10.4Fx use all my Firefox settings? ##
Yes, because as far as your Mac is concerned TenFourFox _is_ Firefox, so it will use your previous profile seamlessly including all of your old bookmarks, all compatible add-ons and all settings. **However, you may wish to install versions in between and upgrade through them** so that your profile is correctly updated, such as from 2 to 3 to 3.6.
Similarly, **if you are updating from a Firefox version prior to 10.0 (such as 3.6), download and install TenFourFox 10.0.11, run it once, then download and install 17.0.11, run that once, then download and install 24.7.0, run that once, then download and install the current version of TenFourFox.** If you are unable to do so, consider removing the `Library/Application Support/Firefox` folder in your home directory to make sure settings are clean and correct, but this will destroy your bookmarks, saved settings, cookies and add-ons. **If your Mac has never run Firefox (even if it ran Camino), you don't need to do this.**
Again, in some cases, you may have corrupted or buggy settings from older versions that will actually cause problems with 10.4Fx. In that case, [you may need to reset your profile](http://tenfourfox.tenderapp.com/kb/general/how-to-reset-your-profile); there is usually no way to fix this otherwise.
As a corollary in general, old versions of Firefox that are no longer supported will typically not be able to use profiles from later versions of Firefox, and may even corrupt them. That brings us to the next question:
## I want to keep my Firefox and 10.4Fx settings separate. ##
If you must use the old Firefox, or use different add-ons or keep different settings, you will need separate profiles. Mozilla explains how to start the Firefox Profile Manager at http://support.mozilla.com/en-US/kb/Managing-profiles. These steps will also work for TenFourFox; just substitute the correct application. **Be careful:** profile management, if done incorrectly, can cause you to lose your current settings and bookmarks. Follow the directions exactly. This is not recommended if you can avoid it.
## I tried to run the Profile Manager like you said, and it gives me a weird error message (on 10.4). ##
Run `firefox -P` instead of `firefox-bin -P`.
In future, once you've created a new profile -- let's say you called it `newprofile` -- you can just type `firefox -p newprofile` to use that profile and avoid using the GUI Profile Manager altogether if you like.
## Can I run 10.4Fx together with Camino, SeaMonkey, Safari or other browsers? ##
Yes. In fact, you can even run them at the same time. Even Gecko-based browsers like Camino and SeaMonkey coexist peacefully with TenFourFox. (We recommend OmniWeb over Safari if you want your WebKit fix, btw.)
Again, the exception is Firefox itself. Firefox 3.6 cannot be run simultaneously with TenFourFox, because as we mentioned above, to the Mac TenFourFox _is_ Firefox. Also, do again remember that older versions of Firefox may cease to work after upgrading to TenFourFox due to incompatible profiles. You may wish to use specific profiles for these older Firefox or even old TenFourFox versions if you must run them (but it is strongly advised you do not, as these versions of Firefox likely have security issues). **We do not support alternating between Firefox 3.6 and TenFourFox, as Firefox 3.6 may not be able to handle the changes in TenFourFox profiles.**
## Does 10.4Fx support Firefox add-ons? ##
Yes, if they are compatible with the same version of Firefox and do not require an Intel Macintosh. For example, **addons such as Adblock Plus, NoScript, Flashblock and OverbiteFF are all compatible.** You can get them by going to Tools, Add-ons.
Remember: **add-ons and plugins are not the same. Add-ons _are_ supported in 10.4Fx.** See PluginsNoLongerSupported for an explanation.
Tiger users should note that even if an extension works with PowerPC, some may require Leopard.
## 1Password does not work with 10.4Fx. ##
Users have asked Agile to support TenFourFox in 1Password and Agile has refused to support _any_ non-Intel build of Firefox after 3.6, including TenFourFox. If you are unhappy about this policy, please tell them so (especially if you are a paid user). In the meantime, if you absolutely require 1Password support, you are stuck with Firefox 3.6. There is no way, unfortunately, to force 1Password to work with TenFourFox from our end.
User Art McGee has suggested that you may be able to use [1Password Anywhere](http://help.agile.ws/1Password3/1passwordanywhere.html) to get around this problem, although this will probably only work for Leopard users. We haven't tested this. Please report your results.
## Gopher sites no longer work in 10.4Fx. ##
You can enable the Gopher protocol with the [OverbiteFF addon](https://addons.mozilla.org/en-US/firefox/addon/overbiteff/).
## Does 10.4Fx support plugins or Flash? ##
**No. Plugins no longer operate in TenFourFox.** 10.4Fx uses older compositing code to remain compatible with OS X Tiger, and the modified graphics stack in Firefox 4 is tuned for CoreAnimation, which Tiger does not support. More to the point, few if any PowerPC-compatible plugins remain updated, and Adobe no longer supports Flash on Power Macintosh.
When you visit a site with plugin content, an informational box may appear on the page where the plugin would normally appear. Sites may also tell you that you have no plugins installed. This is intentional, so that the site can try to present alternate content that does not require a plugin.
Between 6.0 and 17.0.11 an undocumented, unsupported plugin enable setting existed. This option is now completely gone because Mozilla completely removed the older compatibility code. If you turned it on in a previous version of TenFourFox, it will not work in version 19.0 and higher.
See PluginsNoLongerSupported for more information on this policy and ways you can access content without plugins.
## How can I play H.264 video? ##
If a site offers HTML5 H.264 video as an option, you can play many such videos outside of the browser using the optional QuickTimeEnabler. (Please read that wiki page carefully as some sites cannot be supported yet. You may be able to use one of the Firefox video downloader add-ons for those sites; again, see PluginsNoLongerSupported.)
If you are looking for something to play YouTube video specifically, look at the MacTubesEnabler.
## WebM video playback is too slow on my Mac. ##
10.4Fx supports WebM video, which is generally slower than H.264 video because no Power Mac has hardware acceleration for WebM. 10.4Fx does have AltiVec acceleration for WebM, however, which improves performance on G4 and G5 systems. For this reason, most G5 Power Macs can play standard definition WebM without issue but practically no G3 Macs can, due to the CPU power needed to decode, scale and composite the video in the browser.
As for G4 systems in the middle, many will play video with acceptable stuttering, but Macs slower than 1.25GHz are likely to perform badly. If you are in the upper G4 range, video plays back better if you **play the video after it is done downloading** and **reduce the number of tabs open.** Also, because decoded frames can be cached depending on available memory, playing the video a second time often performs considerably better than the first time. Finally, make sure the playback controls are not showing (move your mouse into and back out of the player window if they do not go away on their own), as compositing the controls against the video image uses additional CPU power.
Although 10.4Fx still supports Theora (VP3) video, much less content is available in this format than in WebM, and for this reason its playback is not as well optimized.
Please note that no Power Mac, not even the quad G5, plays high definition WebM fluidly in the browser, nor full-screen WebM. There just isn't enough CPU bandwidth. Similarly, even though recent versions of 10.4Fx support VP9 video, even partial playback is unwatchable on all but the Quad because of the data rate required.
Improving video performance is an active area of development in TenFourFox.
## Does 10.4Fx support Java? ##
**No. Java is specifically disabled by default, and is no longer supported.** Java on 10.4 requires the Java Embedding Plugin, and as mentioned, plugins are no longer supported either. More to the point, neither 10.4 nor 10.5 receive security updates to the JVM any more, and trojans such as Flashback have been able to escalate their privileges even on Power Macs using flaws in these older Java environments. For these reasons Java is no longer supported by TenFourFox, and we strongly recommend you only run signed Java applets from trusted sources on Power Macintoshes.
## 10.4Fx does not display some fonts (Tamil, Arabic, ...) correctly. ##
10.4Fx does not support CoreText, which is needed to use the typographic information in the AAT-encoded fonts that come with OS X. Without this information, certain ligatures and glyph reordering rules cannot be utilized, and the font will appear but not quite correctly. The font renderer in 10.4Fx does support Arabic and other international scripts, but requires OpenType fonts for the special language-specific features. See [issue 5](https://code.google.com/p/tenfourfox/issues/detail?id=5) and TechnicalDifferences.
## On some sites, I keep getting "Unresponsive script" errors. ##
As sites become larger and use more complex JavaScript, even with the special acceleration in 10.4Fx, execution will be slow particularly on G3 and early G4 systems. When script runtime exceeds a certain threshold, this error appears. The error is otherwise harmless and you can continue to wait if you know the operation will complete.
If you get this window frequently, there are a few ways you can improve the browser's script performance. Try some or all:
* Remove unnecessary browser add-ons. These sometimes will interfere with some sites.
* Use the [NoScript](https://addons.mozilla.org/en-US/firefox/addon/noscript) add-on and allow JavaScript only to run on certain necessary sites.
* Disable the unresponsive script warning entirely. Instructions are on [this support ticket](http://tenfourfox.tenderapp.com/discussions/problems/174-unresponsive-script-warning).
## Will 10.4Fx receive updates? ##
Yes. We will update the browser with regular security updates, which your browser will automatically prompt you to download when they become available.
New feature versions of 10.4Fx will also be released until it is no longer possible to compile Mozilla's source code (see SupportLevels). However, even when it is no longer possible, security updates will still occur.
## The browser keeps saying I'm out of date! ##
You will get automatic prompts to update if the browser detects your version is not in sync with the version available. Sometimes this may occur even if you appear to be using the same version (we do not bump the version number between official releases to avoid getting out of sync with Mozilla, but the browser has a different build ID). If you are ever in doubt about the version you have, visit the [TenFourFox Start Page](http://www.tenfourfox.com/start), which will tell you if you are up-to-date.
## Does 10.4Fx support WebM video? ##
Yes. However, video playback generally requires a G5 for best results. See above for suggestions on improving native video playback on G4 systems.
## Does 10.4Fx support WebGL? ##
No. WebGL requires OpenGL 2, which is not supported on Tiger, and Mozilla does not support WebGL on 10.5 either.
## Does 10.4Fx support IonMonkey or BaselineCompiler JavaScript JIT acceleration? ##
TenFourFox uses PPCBC, a specialized PowerPC-specific version of Mozilla BaselineCompiler. BaselineCompiler is a low-latency compiler emphasizing quick code generation.
IonMonkey support is being worked on for a future version of TenFourFox, and will complement PPCBC.
## Does 10.4Fx support language packs? ##
Yes (see the [main page](http://www.tenfourfox.com/) for a list of languages). More are coming soon!
Looking for your own language? 10.4Fx has slightly different strings than Firefox, so regular language packs need modification. Some enterprising users are already working on it. See [issue 42](https://code.google.com/p/tenfourfox/issues/detail?id=42).
## Why do you make me test my bug reports against the current Firefox? I can't run it on my Mac! ##
After Firefox 3.6, Mozilla introduced many large layout and interface changes (most of them in Firefox 4, but many incrementally after that); moreover, the current rapid release strategy Mozilla is using is certain to introduce more bugs and more compatibility changes more and more quickly. Fixing Mozilla bugs is out of our purview and most of this app is still Mozilla's code. To keep us focused on our mission of keeping Firefox compatible with the Power Mac, we need you to make sure your bug does not also occur in regular Firefox. If it does, it's not our bug.
We realize that the whole point of TenFourFox is to run Firefox on systems that Mozilla no longer supports, so comparisons to any Tier 1 platform are accepted, including Windows, Linux and Mac OS X 10.6+. However, unless your bug report is clearly specific to 10.4Fx (and the template will guide you), **if your bug report does not compare behaviour with stock Firefox, it will be marked invalid.** We don't mean to be jerks, but we need to keep our heads above water and not spin our wheels -- or there won't be a TenFourFox in the future.
## This document didn't answer my question. ##
Please open a support ticket on our [TenFourFox Tenderapp](http://tenfourfox.tenderapp.com/) and one of our friendly support volunteers will try to help you.
If you wish to talk directly to the developers, feel free to drop by and comment on our [TenFourFox Development](http://tenfourfox.blogspot.com/) blog.

65
Hashes.md Normal file
View File

@ -0,0 +1,65 @@
**This hashes file will be moving to [Github](https://github.com/classilla/tenfourfox). No further updates will occur on this copy.**
### **If there is not a padlock icon in the address bar or the address is not `https://code.google.com`, then this document could have been tampered with in-transit. Please verify that your browser securely accessed this document before using the hashes below.** ###
If you are downloading TenFourFox on a hostile or insecure network where data could be tampered with, or just want to make sure it downloaded correctly before filing a trouble ticket, you can certify your download with the hashes below.
To check the hash for your file, download it from SourceForge, _but do not decompress it_. Start `Terminal`. At the prompt, type (but **_do not press RETURN yet_**):
```
openssl dgst -ripemd160
```
Drag the `.zip` file you downloaded into the `Terminal` window. Its path will be added to the command. Now press RETURN in the `Terminal` window. You should see a result like this:
```
RIPEMD160(TenFourFox7450-31.2.0.app.zip)= e6637dff473f68d2b4a4b6b920c70183d8658dea
```
Verify it in the table below (make sure you are looking at the right version and filename). If this matches, you can be very confident that your browser was downloaded correctly and was not tampered with during transit. You can continue with decompressing and installing it at this point.
Only the last two versions are displayed. You should always use the most current version if you are in a security-sensitive situation.
## Stable releases ##
**TenFourFox 38.2.0**
```
RIPEMD160(TenFourFoxG3-38.2.0.app.zip)= d2871dd97494c66a719091aca1994a21b3d5dbd8
RIPEMD160(TenFourFox7400-38.2.0.app.zip)= 6d47917ea26d21ea58ecc8d39622ba25aed6a1ef
RIPEMD160(TenFourFox7450-38.2.0.app.zip)= 506bbad403666fc8760f501e93993267ed6d93a5
RIPEMD160(TenFourFoxG5-38.2.0.app.zip)= 3e52f6007a014d5ab2b4adf063982f62469c8e0e
RIPEMD160(TenFourFox38E-changesets-20150805.zip)= 7569e39fb233a569257bcb177dc6f4893f14a0a9
```
**TenFourFox 31.8.0**
```
RIPEMD160(TenFourFoxG3-31.8.0.app.zip)= 123600c99b11172161a4bd0e422de61f951fdf05
RIPEMD160(TenFourFox7400-31.8.0.app.zip)= 7d70ff0848bcff3e1b2db0f88560c615d1dd5817
RIPEMD160(TenFourFox7450-31.8.0.app.zip)= 7d627d3aacb9dd16d03e2d2ce7021d203648fe54
RIPEMD160(TenFourFoxG5-31.8.0.app.zip)= 9f1d9110066b626360c7c7ae0e937e206bd48554
RIPEMD160(TenFourFox31E-changesets-20150507.zip)= aca414cdbc98b36cc79b8b5baa97c5ba19f83f79
```
## Unstable releases ##
**TenFourFox 38.1.1b2**
```
RIPEMD160(TenFourFoxG3-38.1.1b2.app.zip)= 5d20facb6708ddab95bc9a299dc65e351e0c7d49
RIPEMD160(TenFourFox7400-38.1.1b2.app.zip)= dee11ae0872ebc4e84ee4de0d735e41ea9061d15
RIPEMD160(TenFourFox7450-38.1.1b2.app.zip)= ac5bf13c2c114d4213b0107794b88d4cc51d07ae
RIPEMD160(TenFourFoxG5-38.1.1b2.app.zip)= 36c9b567d55e314e912ccc970fc66f98842a5e8f
RIPEMD160(TenFourFox38E-changesets-20150730.zip)= 4e4b0e46f4a9287fc41bd5b8509f361f69508897
```
**TenFourFox 38.0.1b1**
```
RIPEMD160(TenFourFoxG3-38.0.1b1.app.zip)= 144b5971cd29b02303a127ac2b766a620c23f0ed
RIPEMD160(TenFourFox7400-38.0.1b1.app.zip)= e33dc90abd80b402666aaf72904de1bde0e0da87
RIPEMD160(TenFourFox7450-38.0.1b1.app.zip)= 99f57326692a1f005ea3db8a2e5bfabbba2af47d
RIPEMD160(TenFourFoxG5-38.0.1b1.app.zip)= 19fa1236709134d558b4b6b9973ec2edb8cbdce3
RIPEMD160(TenFourFox38E-changesets-20150627.zip)= 923b65ca261f4638102b202521dd2789024203fb
```

56
HowToBuild.md Normal file
View File

@ -0,0 +1,56 @@
**This document only covers the `mozilla-2.0` branch, from which 10.4Fx 4.0.x is built. Therefore, it is mostly obsolete. For 5.0 and higher, see HowToBuildNow.**
## Warning ##
These build instructions are always subject to change. You should be familiar with [how Mozilla offers its source code and how to build Mozilla applications](https://developer.mozilla.org/en/Developer_Guide) before you attempt these steps.
## Prequisites ##
10.4Fx is currently built from Mozilla's Mercurial repository with our own changesets applied on top. This is not a task for the faint of heart, but here's how we do it.
1. At minimum you will need a G4 or G5 (G5 recommended), 10.4.11, 1GB of RAM and 10GB disk space. The build should work on a G3 or 10.5.8, but is not tested in either configuration. You also need Xcode 2.5 or higher. Just for your interest, TenFourFox is built on a quad G5 with 8GB of RAM, because compilers like RAM. In this configuration, with Energy Saver set to Highest Performance, it takes approximately 90 minutes to kick out a single architecture build.
1. Install [MacPorts](http://www.macports.org/install.php), using the Tiger dmg. We need to install not only Mercurial, but Mozilla's preferred `autoconf` and a newer GNU `make` to get around various bugs in Tiger's included version. Get a cup of coffee, because MacPorts likes to install everything else as a prereq for everything else.
1. `sudo port -v selfupdate`
1. `sudo port install mercurial libidl autoconf213 gmake python py25-zlib py25-hashlib freetype`
## Building from the stable `mozilla-2.0` ##
Once that's done, your system is ready to build some code. Currently, 10.4Fx 4.0 is considered "stable" (ha ha ha), and is built from the "stable" (har har har) `mozilla-2.0` branch. Right now these steps are entirely manual. At some point we will (at least partially) automate this.
1. In your nice fat source drive, `hg clone http://hg.mozilla.org/releases/mozilla-2.0` (or the desired revision).
1. Grab the most current changesets from the Downloads tab and unzip them somewhere.
1. Serially, in numerical order, `hg import` each changeset. This is the most difficult step because some source files may require manually merging individually and then resolving them with `hg resolve -m` afterwards.
1. Select your desired configuration (any of the `*.mozcfg` files) and copy it to `~/.mozconfig`. These configurations should be self-explanatory. For the gory details, see [Configuring Build Options](https://developer.mozilla.org/en/configuring_build_options) at MDN, but in general, you should avoid changing the standard build configurations unless you know exactly what you are doing.
* **G4 and G5 owners:** if you want to test the AltiVec (VMX) code paths apart from the standard `mozcfg` files, you should include `--enable-tenfourfox-vmx` in your custom `.mozconfig` or it will be compiled without AltiVec/VMX acceleration.
* **G5 owners _ONLY_:** if you want to test the G5-specific code paths apart from the standard `G5.mozcfg`, you should include `--enable-tenfourfox-g5` in your custom `.mozconfig` or the regular code paths will be used instead of the G5-specific ones. This does _not_ enable VMX; if you want that, specify it too.
1. (Optional but recommended) Edit `netwerk/protocols/http/OptimizedFor.h` and set the string to something human-readable about the configuration you're building for. This string should be relatively short, and will appear after the `TenFourFox/` in the user agent string.
1. (Optional) If you want to change the reported version numbers (say, to get rid of that `pre` tag), alter `browser/config/version.txt` for the reported browser version, and `config/milestone.txt` for the reported Gecko version. _You should revert these changes before pulling source again or you will have to merge them!_
1. If you are cleaning out an old build, fresh the tree first with:
* `gmake -f client.mk clean`
* `rm -f obj-*/config.* configure`
1. `autoconf213`
1. `gmake -f client.mk build`
## Running and debugging ##
If the build worked, try out your binary in `gdb`:
* `cd obj-ff-dbg/dist/TenFourFox.app/Contents/MacOS` (or, if in Debug mode, `TenFourFoxDebug.app`)
* `gdb firefox-bin`
* At the `(gdb)` prompt, `run`
## Alternative: Build with Fink _(experimental)_ ##
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`.
## Building old betas with older changesets ##
This is not recommended for a variety of reasons, but you can use old beta changesets as long as you match them to the appropriate revision (to avoid confusion over which changeset is in use, we tag these by date).
## 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.
Inevitably there will be merge conflicts, which you will need to manually resolve, mark with `hg resolve -m` and then continue the rebase with `hg rebase --continue`. **NEVER `hg merge`!**
Once the rebase is complete, you will be able to continue building and working with the repo in a sane state. Like any sane SCM, merge changes you made will be reflected in your changesets.

80
HowToBuildNow.md Normal file
View File

@ -0,0 +1,80 @@
**This document only covers the `mozilla-esr10` and `mozilla-esr17` branches, from which 10.4Fx 10.0.x and 17.0.x were built. Therefore, it is mostly obsolete. For 24.0 and higher, see HowToBuildRightNow.**
## Warning ##
These build instructions are always subject to change. You should be familiar with [how Mozilla offers its source code and how to build Mozilla applications](https://developer.mozilla.org/en/Developer_Guide) before you attempt these steps.
These instructions do not apply to the legacy `mozilla-2.0` branch, from which TenFourFox 4.0.x is built. For that, see HowToBuild.
## Prerequisites for both unstable and stable branch builders ##
10.4Fx is currently built from Mozilla's Mercurial repository with our own changesets applied on top. This is not a task for the faint of heart, but here's how we do it. The stable branch requires the steps below; the unstable branch requires these steps and a few more.
1. At minimum you will need a G4 or G5 (G5 recommended), 10.4.11, Xcode 2.5, 1GB of RAM and 10GB disk space. The build should work on a G3, but has not been tested on it. Just for your interest, TenFourFox is built on a quad G5 with 8GB of RAM, because compilers like RAM. In this configuration, with Energy Saver set to Highest Performance, it takes approximately 90 minutes to kick out a single architecture build.
* The only currently supported compiler for ESR10 and ESR17 is `gcc` 4.0.1, which comes with Xcode 2.5, although Leopard's Xcode 3 compiler is known to work. Although some later `gcc` versions can be used on Tiger, and will build these versions of TenFourFox, you should read the notes in [issue 52](https://code.google.com/p/tenfourfox/issues/detail?id=52) first. The stable branch release binaries are built with `gcc` 4.0.1 and we will assume you are using it here.
* Building on 10.5.8 (and/or with Xcode 3) should still be possible, but has not been well tested since version 17. Please file issues _with patches_ if this isn't working.
* It _should_ be possible to cross-build 10.4Fx on 10.6 using Xcode 3.x. We've never tried this; please try it and let us know. It is definitely _not_ possible to build it on 10.7 and later (thanks a lot, Apple).
1. Install [MacPorts](http://www.macports.org/install.php), using the Tiger `dmg` for 10.4 or the Leopard `dmg` for 10.5 (Fink users, see below). Note that MacPorts has stopped offering the Tiger package openly, but you can still get it from https://distfiles.macports.org/MacPorts/ (2.0.4 is the last official version, which you can then immediately `selfupdate`).
1. We need to install not only Mercurial, but Mozilla's preferred `autoconf` and a newer GNU `make` to get around various bugs in Tiger's included version. Get a cup of coffee, because MacPorts likes to install everything else as a prereq for everything else.
1. `sudo port -v selfupdate`
1. `sudo port install mercurial libidl autoconf213 gmake python25 py25-zlib freetype`
1. For Tiger builders _building the stable branch only_, install the [Xcode 3 linker](http://tenfourfox.googlecode.com/files/ldx3.zip), ported to 10.4 by Tobias Netzel. You **do not need** this to build the _unstable_ branch (see HowToBuildRightNow). This can be done in one of two ways:
1. _Riskier:_ Download it and replace your old linker at `/usr/bin/ld` with this one (renaming it). Save your old linker first. All of your software will now be linked with it, which does generate binaries and `dylib`s that are still compatible with 10.4.
1. _Safer:_ Download it and save it as `/usr/bin/ldx3`. Rename `/usr/bin/ld` to `/usr/bin/ld32` and move on to grabbing source (we'll give you the next step there).
## Building the stable release from the Mozilla ESR ##
Mozilla's most current stable ESR is the basis for our **stable** branch These instructions assume it is ESR 17, although by the time you read this 17 will be exiting support. These instructions will also work if you use ESR 10, assuming you are using ESR 10 changesets. **Neither TenFourFox 10 nor 17 are supported anymore. Do not submit bug reports for these versions.**
1. In your nice fat source drive, `hg clone http://hg.mozilla.org/releases/mozilla-esr17` (or the desired revision).
1. Grab the most current **_stable_** (not _unstable_) changesets from the Downloads tab and unzip them somewhere.
1. Serially, in numerical order, `hg import` each changeset. This is the most difficult step because some source files may require manually merging individually and then resolving them with `hg resolve -m` afterwards.
1. **If you chose the _Safer_ approach above:** now, copy `SHIM.ld` (this is added by the changesets to the repo's root directory) to `/usr/bin/ld` and make it executable with `chmod +x /usr/bin/ld`. Make sure you moved your old `ld` to `ld32` first! Your linker is now dynamically switchable. If the `LD64` environment variable is set to `1`, the Xcode 3 linker will be used; otherwise, the Tiger 32-bit linker will be used like usual. The Mozilla build system knows how to toggle this variable. It will have no effect if you went for _Riskier_. **You do not need this step if you are only building the unstable release.**
1. Select your desired configuration (any of the `*.mozcfg` files) and copy it to `.mozconfig` in the root of the repo. _Prior to Mozilla 9, this could be in `~/.mozconfig` too; as of Fx9 and later, Mozilla **requires** that this file only exist in the repo root._ These configurations should be self-explanatory. For the gory details, see [Configuring Build Options](https://developer.mozilla.org/en/configuring_build_options) at MDN, but in general, you should avoid changing the standard build configurations unless you know exactly what you are doing. **Use the `mozconfig`s that came with this most current revision if at all possible, because the options are periodically upgraded and changed as the build system gets modified. In particular do not use the old `mozconfig`s from 10.4Fx 4.0.x with 5 and up; they will fail inexplicably.**
* **G4 and G5 owners:** if you want to test the AltiVec (VMX) code paths apart from the standard `mozcfg` files, you should include `--enable-tenfourfox-vmx` in your custom `.mozconfig` or it will be compiled without AltiVec/VMX acceleration. Also, if you are not using Xcode 2.5's `gcc-4.0`, you may need to add `-faltivec` to the compiler command lines in your chosen `mozconfig`.
* **G5 owners _ONLY_:** if you want to test the G5-specific code paths apart from the standard `G5.mozcfg`, you should include `--enable-tenfourfox-g5` in your custom `.mozconfig` or the regular code paths will be used instead of the G5-specific ones. This does _not_ enable VMX; if you want that, specify it too. You may also need to add `-D_PPC970_` to your compiler strings so that non-Mozilla libraries and JavaScript properly select the correct architecture optimizations. You don't need this, but the browser will not run as well if you don't.
* **Intel owners _ONLY_:** There is currently no supported debug configuration. The provided `intel.mozcfg` is an opt build only.
1. (Optional but recommended) Edit `netwerk/protocols/http/OptimizedFor.h` and set the string to something human-readable about the configuration you're building for. This string should be relatively short, and will appear after the `TenFourFox/` in the user agent string.
1. (Optional) If you want to change the reported version numbers (say, to get rid of that `pre` tag), alter `browser/config/version.txt` for the reported browser version, and `config/milestone.txt` for the reported Gecko version. If you change `config/milestone.txt`, you should also make sure `js/src/config/milestone.txt` matches it, if it exists. _You should revert these changes before pulling source again or you will have to merge them!_
1. If you are cleaning out an old build, fresh the tree first with:
* `gmake -f client.mk clean`
* `find obj-ff-dbg/ -name 'config.*' -print | xargs rm`
* `rm configure`
1. `autoconf213`
1. `gmake -f client.mk build`
## Building from a tarball ##
Depending on the space you have, or your general antipathy towards Mercurial, or your need for an old version of Firefox, you may prefer to build from one of the source archives. The easiest way to do this is to download the archive and expand it, then turn it into a repo with the following (done at the root of the unpacked archive):
* `hg init`
* `hg add`
* `hg commit`
This will create a new blank repo, add everything to it, and then commit. Note that the commit does not restore history; there _is_ no history. Instead, it is as if you started from whole cloth. On the other hand, the resulting repo is considerably smaller and probably easier and faster to work with (but you should _not_ do this if you plan to do development, since you will probably want that history if you screw up).
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.
## Running and debugging ##
If the build worked, try out your binary in `gdb`:
* `cd obj-ff-dbg/dist/TenFourFox.app/Contents/MacOS` (or, if in Debug mode, `TenFourFoxDebug.app`)
* `gdb firefox` (older releases used `firefox-bin`)
* At the `(gdb)` prompt, `run`
If the build didn't work and you got lots of linker errors, make sure that you properly installed the Xcode 3 linker; the Xcode 2.5 linker will not work.
If the build appeared to work, but the browser crashes in an unusual `objc` symbol when you try to run it, you may have encountered [issue 169](https://code.google.com/p/tenfourfox/issues/detail?id=169) which is due to incorrect linker code generation. This is mostly a problem for 18.0 and later; although the underlying cause is also present in versions 15.x through 17.x, they are not materially affected by it.
## Alternative: Build with Fink _(experimental)_ ##
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.
## 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.
Inevitably there will be merge conflicts, which you will need to manually resolve, mark with `hg resolve -m` and then continue the rebase with `hg rebase --continue`. **NEVER `hg merge`!**
Once the rebase is complete, you will be able to continue building and working with the repo in a sane state. Like any sane SCM, merge changes you made will be reflected in your changesets.

100
HowToBuildRightNow.md Normal file
View File

@ -0,0 +1,100 @@
**This document only covers the `mozilla-esr24` and `mozilla-esr31` branches, from which 10.4Fx 24.0.x and 31.0.x were built. Therefore, it is mostly obsolete. For 24.0 and higher, see HowToBuildRightNow38.**
## Warning ##
These build instructions are always subject to change. You should be familiar with [how Mozilla offers its source code and how to build Mozilla applications](https://developer.mozilla.org/en/Developer_Guide) before you attempt these steps.
Although these instructions for `mozilla-esr31` (from which TenFourFox 31 was built) will also still work for the legacy `mozilla-esr24` branch (from which TenFourFox 24 was built), they do _not_ apply to the legacy `mozilla-esr17` or `mozilla-esr10` branches, from which TenFourFox 17 and 10 were built. For those, see HowToBuildNow.
These instructions have been rewritten to explain how to make an unstable and stable branch build from the release and ESR trees, respectively. Starting with 10.4Fx 24, the steps are mostly the same.
## Prerequisites for both unstable and stable branch builders ##
10.4Fx is currently built from Mozilla's Mercurial repository with our own changesets applied on top. This is not a task for the faint of heart, but here's how we do it.
1. At minimum you will need a G4 or G5 (G5 recommended), 10.4.11, Xcode 2.5, 1GB of RAM and 10GB disk space. The build should work on a G3, but has not been tested on it. Just for your interest, TenFourFox is built on a quad G5 with 8GB of RAM, because compilers like RAM. In this configuration, with Energy Saver set to Highest Performance, it takes approximately 200 minutes to kick out a single architecture build, and approximately 215 minutes for a debugging build. Plan accordingly.
* The only currently supported compiler is now `gcc` 4.6.x (specifically 4.6.3 or 4.6.4), from MacPorts (see below). However, although `gcc` 4.0.1 and `gcc` 4.2 are no longer supported, you must still install Xcode for certain other prerequisites. Later versions of `gcc` have been used in limited situations, and may work, but are not yet supported. (4.8 is available from MacPorts also, and does work on PowerPC.)
* Building on 10.5.8 and/or with Xcode 3 should work, but **linking against the 10.5 SDK is not supported.** Note that the browser can still be built on 10.5.8, and will still _run_ on 10.5.8, but the only allowed target will be a _10.4_-compatible browser.
* If your compiler is compiled for 10.5, the browser will use the 10.4 SDK, but link against your 10.5-only `libgcc` and `stdc++`. If you intend to use your build on a 10.4 system, you will need to replace them with 10.4-compatible libraries. The easiest source is a TenFourFox binary package; see below under **Distributing the executable**. It is also possible, though involved, to make a cross-building `gcc`; see [issue 52](https://code.google.com/p/tenfourfox/issues/detail?id=52).
* `clang` is not supported. However, it may be possible to do a cross-build on 10.6.8 using a cross-compiling version of `gcc`. Good luck, let us know if it works. It is _not_ possible to build 10.4Fx on 10.7 or any later version of OS X.
1. Install [MacPorts](http://www.macports.org/install.php), using the Tiger `dmg` for 10.4 or the Leopard `dmg` for 10.5 (Fink users, see below). Note that MacPorts does not always have the most current release up to date for 10.4 or 10.5, but you can still get whatever the most recently updated historical version was from https://distfiles.macports.org/MacPorts/ -- you need only grab the most recent 10.4 or 10.5 version available, because we will immediately force it to self-update in the next step (read on).
1. We need to install not only Mercurial, a new Python and a new `gcc`, but we'll also need Mozilla's preferred `autoconf` and a newer GNU `make` to get around various bugs in Tiger's included version. Get a cup of coffee, because MacPorts likes to install everything else as a prereq for everything else.
1. `sudo port -v selfupdate`
1. `sudo port install mercurial libidl autoconf213 gmake python27 gcc46 freetype`
* MacPorts' `gcc46` package also includes updated bintools, including its own copy of the Xcode 3 linker, but with a bug fix to enable TenFourFox's `XUL` to link correctly. If your `gcc46` port was built on or prior to December 2012, you probably have [a version with the bug in it](https://trac.macports.org/ticket/37300). At minimum update `ld64`, or just update the whole compiler toolchain entirely. See [issue 52](https://code.google.com/p/tenfourfox/issues/detail?id=52).
* The old ported Xcode 3 `ld` used to build TenFourFox 17 and earlier is no longer needed.
1. 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. You can get that from the [Downloads tab](http://code.google.com/p/tenfourfox/downloads/list) here at Google Code for the time being. 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.
## Building the stable release from the Mozilla ESR ##
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 31; these instructions also work for ESR 24, although we no longer support it. These instructions were different for ESR 10 and 17, which we don't support anymore either; if you have a need to build these, see HowToBuildNow (do not submit bug reports for these versions).
1. In your nice fat source drive, `hg clone http://hg.mozilla.org/releases/mozilla-esr31` (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.
1. Grab the most current **_stable_** (not _unstable_) changesets from [the TenFourFox SourceForge download repository](https://sourceforge.net/projects/tenfourfox/files/) and unzip them somewhere.
1. Serially, in numerical order, `hg import` each changeset. This is the most difficult step because some source files may require manually merging individually and then resolving them with `hg resolve -m` afterwards.
1. Select your desired configuration (any of the `*.mozcfg` files) and copy it to `.mozconfig` in the root of the repo. _Prior to Mozilla 9, this could be in `~/.mozconfig` too; as of Fx9 and later, Mozilla **requires** that this file only exist in the repo root._ These configurations should be self-explanatory. For the gory details, see [Configuring Build Options](https://developer.mozilla.org/en/configuring_build_options) at MDN, but in general, you should avoid changing the standard build configurations unless you know exactly what you are doing. **Use the `mozconfig`s that came with this most current revision if at all possible, because the options are periodically upgraded and changed as the build system gets modified. In particular do not use the old `mozconfig`s from 10.4Fx 4.0.x with 5 and up; they will fail inexplicably.**
* **G4 and G5 owners:** if you want to test the AltiVec (VMX) code paths apart from the standard `mozcfg` files, you should include `--enable-tenfourfox-vmx` in your custom `.mozconfig` or it will be compiled without AltiVec/VMX acceleration.
* **G5 owners _ONLY_:** if you want to test the G5-specific code paths apart from the standard `G5.mozcfg`, you should include `--enable-tenfourfox-g5` in your custom `.mozconfig` or the regular code paths will be used instead of the G5-specific ones. This does _not_ enable VMX; if you want that, specify it too. You may also need to add `-D_PPC970_` to your compiler strings so that non-Mozilla libraries and JavaScript properly select the correct architecture optimizations. You don't need this, but the browser will not run as well if you don't.
* **Intel owners _ONLY_:** **Intel builds for TenFourFox 24 and 31 are not yet working.** Good luck; submit patches if you get it operational.
1. (Optional but recommended) Edit `netwerk/protocols/http/OptimizedFor.h` and set the string to something human-readable about the configuration you're building for. This string should be relatively short, and will appear after the `TenFourFox/` in the user agent string.
1. (Optional) If you want to change the reported version numbers (say, to get rid of that `pre` tag), alter `browser/config/version.txt` for the reported browser version, and `config/milestone.txt` for the reported Gecko version. If you change `config/milestone.txt`, you should also make sure `js/src/config/milestone.txt` matches it. _You should revert these changes before pulling source again or you will have to merge them!_
1. If you are cleaning out an old build, be sure to `rm -rf configure obj-ff-dbg/` first. Then,
1. `autoconf213`
1. `gmake -f client.mk build`
## Known build issues ##
* Until [issue 202](https://code.google.com/p/tenfourfox/issues/detail?id=202) is fixed, you will get spurious errors setting up the Python environment. You can ignore these for now.
## Building from a tarball ##
Depending on the space you have, or your general antipathy towards Mercurial, or your need for an old version of Firefox, you may prefer to build from one of the source archives. The easiest way to do this is to download the archive and expand it, then turn it into a repo with the following (done at the root of the unpacked archive):
* `hg init`
* `hg add`
* `hg commit`
This will create a new blank repo, add everything to it, and then commit. Note that the commit does not restore history; there _is_ no history. Instead, it is as if you started from whole cloth. On the other hand, the resulting repo is considerably smaller and probably easier and faster to work with (but you should _not_ do this if you plan to do development, since you will probably want that history if you screw up).
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 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`:
* `cd obj-ff-dbg/dist/TenFourFox.app/Contents/MacOS` (or, if in Debug mode, `TenFourFoxDebug.app`)
* `gdb7 firefox`
* At the `(gdb)` prompt, `run`
If the build appeared to work, but the browser crashes in an unusual `objc` symbol when you try to run it or quit, you may have encountered [issue 169](https://code.google.com/p/tenfourfox/issues/detail?id=169) which is due to incorrect linker code generation. Make sure you are using the fixed `ld` (see the prerequisites section).
If you receive strange `Die` errors in the debugger and backtraces don't work properly, you need to upgrade your debugger (or you're using the one that Apple provided, which won't work anymore).
### Distributing the executable ###
Because the new compiler links against its own `libgcc` and `libstdc++`, if you intend to make a build to generally distribute or use on another computer, you will need to include these libraries and update the linkage to point to the included copies. The tool `104fx_copy.sh` (in the root) will help you with this. Make it executable with `chmod +x` if necessary, then simply type `./104fx_copy.sh [destination name.app]` and the built binary will be copied to the destination name (which should be the new app bundle filename) and its linkages updated to be internal. This should be the **last** step you do before release since the binary it generates is completely standalone and disconnected from the build system.
If your `libgcc_s.1.dylib` (and others) are in `/opt/local/lib/libgcc` instead of `/opt/local/lib/gcc46`, and you are using changesets prior to 24.2.0, **this script will not generate a properly relinked executable.** Beginning with 24.2.0, the distributor script will check for linkage against both locations and adjust accordingly.
**If you built on 10.5 with a compiler that was also built on 10.5, your built browser will only work on 10.5** (despite using the 10.4 SDK) because the `gcc` 4.6.x `libgcc` and `libstdc++` are linked against the 10.5 SDK, not 10.4. The easiest way to solve this problem is to replace `libgcc_s.1.dylib` and `libstdc++.6.dylib` in your browser package with the ones from a real TenFourFox binary and then your build will "just work" on both operating systems. It _is_ possible, though involved, to build a cross-compiling 10.5 `gcc` that will create 10.4-compatible binaries; see [issue 52](https://code.google.com/p/tenfourfox/issues/detail?id=52).
## Alternative: Build with Fink _(experimental)_ ##
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` ##
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.
Inevitably there will be merge conflicts, which you will need to manually resolve, mark with `hg resolve -m` and then continue the rebase with `hg rebase --continue`. **NEVER `hg merge`!**
Once the rebase is complete, you will be able to continue building and working with the repo in a sane state. Like any sane SCM, merge changes you made will be reflected in your changesets.

96
HowToBuildRightNow38.md Normal file
View File

@ -0,0 +1,96 @@
**This document only covers the `mozilla-esr38` branch, from which TenFourFox 38 is built. It does not cover earlier versions (see HowToBuildNow) or subsequent ones, and it does not cover unstable releases based on Mozilla 39.0+.**
## Warning ##
These build instructions are always subject to change. You should be familiar with [how Mozilla offers its source code and how to build Mozilla applications](https://developer.mozilla.org/en/Developer_Guide) before you attempt these steps.
## Prerequisites ##
10.4Fx is currently built from Mozilla's Mercurial repository with our own changesets applied on top. This is not a task for the faint of heart, but here's how we do it.
1. At minimum you will need a G4 or G5 (G5 recommended), 10.4.11, Xcode 2.5, 1.5GB of RAM and 10GB disk space. The build should work on a G3, but has not been tested on it. Just for your interest, TenFourFox is built on a quad G5 with 16GB of RAM, because compilers like RAM. In this configuration, with Energy Saver set to Highest Performance, it takes approximately two hours to kick out a single architecture build, and a few minutes longer for a debugging build. Plan accordingly.
* Although Mozilla 38 requires `gcc` 4.7 or higher, TenFourFox is actually still built with `gcc` 4.6.x (specifically 4.6.3 or 4.6.4), from MacPorts (see below), using a compatibility shim. However, although `gcc` 4.0.1 and `gcc` 4.2 are no longer supported, you must still install Xcode for certain other prerequisites. Later versions of `gcc` have been used in limited situations, and may work, but are not yet supported -- if you use one of these, remove the compatibility shim from the changesets first before applying them; see below. (4.8 is available from MacPorts also, and does work on PowerPC.)
* Building on 10.5.8 and/or with Xcode 3 should work, but **linking against the 10.5 SDK is not supported.** Note that the browser can still be built on 10.5.8, and will still _run_ on 10.5.8, but the only allowed target will be a _10.4_-compatible browser.
* If your compiler is compiled for 10.5, the browser will use the 10.4 SDK, but link against your 10.5-only `libgcc` and `stdc++`. If you intend to use your build on a 10.4 system, you will need to replace them with 10.4-compatible libraries. The easiest source is a TenFourFox binary package; see below under **Distributing the executable**. It is also possible, though involved, to make a cross-building `gcc`; see [issue 52](https://code.google.com/p/tenfourfox/issues/detail?id=52).
* `clang` is not supported. However, it may be possible to do a cross-build on 10.6.8 using a cross-compiling version of `gcc`. Good luck, let us know if it works. It is _not_ possible to build 10.4Fx on 10.7 or any later version of OS X.
1. Install [MacPorts](http://www.macports.org/install.php), using the Tiger `dmg` for 10.4 or the Leopard `dmg` for 10.5 (Fink users, see below). Note that MacPorts does not always have the most current release up to date for 10.4 or 10.5, but you can still get whatever the most recently updated historical version was from https://distfiles.macports.org/MacPorts/ -- you need only grab the most recent 10.4 or 10.5 version available, because we will immediately force it to self-update in the next step (read on).
1. We need to install not only Mercurial, a new Python and a new `gcc`, but we'll also need Mozilla's preferred `autoconf` and a newer GNU `make` to get around various bugs in Tiger's included version. Get a cup of coffee, because MacPorts likes to install everything else as a prereq for everything else.
1. `sudo port -v selfupdate`
1. `sudo port install mercurial libidl autoconf213 gmake python27 gcc46 freetype`
* MacPorts' `gcc46` package also includes updated bintools, including its own copy of the Xcode 3 linker, but with a bug fix to enable TenFourFox's `XUL` to link correctly. If your `gcc46` port was built on or prior to December 2012, you probably have [a version with the bug in it](https://trac.macports.org/ticket/37300). At minimum update `ld64`, or just update the whole compiler toolchain entirely. See [issue 52](https://code.google.com/p/tenfourfox/issues/detail?id=52).
* The old ported Xcode 3 `ld` used to build TenFourFox 17 and earlier is no longer needed.
1. 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](http://sourceforge.net/projects/tenfourfox/files/tools/strip7-104fx.tar.gz/download).
1. 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 get it from [SourceForge](http://sourceforge.net/projects/tenfourfox/files/tools/gdb768-104fx-2.tar.gz/download).
## Building the stable release from the Mozilla ESR ##
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. These instructions were slightly different for ESR 24 and 31, which we don't support anymore; if you have a need to build these, see HowToBuildRightNow (do not submit bug reports for these versions).
1. 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.
1. Grab the most current **_stable_** (not _unstable_) changesets from [the TenFourFox SourceForge download repository](https://sourceforge.net/projects/tenfourfox/files/) and unzip them somewhere.
1. Serially, in numerical order, `hg import` each changeset. This is the most difficult step because some source files may require manually merging individually and then resolving them with `hg resolve -m` afterwards.
1. Select your desired configuration (any of the `*.mozcfg` files) and copy it to `.mozconfig` in the root of the repo. _Prior to Mozilla 9, this could be in `~/.mozconfig` too; as of Fx9 and later, Mozilla **requires** that this file only exist in the repo root._ These configurations should be self-explanatory. For the gory details, see [Configuring Build Options](https://developer.mozilla.org/en/configuring_build_options) at MDN, but in general, you should avoid changing the standard build configurations unless you know exactly what you are doing. **Use the `mozconfig`s that came with this most current revision if at all possible, because the options are periodically upgraded and changed as the build system gets modified. In particular do not use the old `mozconfig`s from 10.4Fx 4.0.x with 5 and up; they will fail inexplicably.**
* **G4 and G5 owners:** if you want to test the AltiVec (VMX) code paths apart from the standard `mozcfg` files, you should include `--enable-tenfourfox-vmx` in your custom `.mozconfig` or it will be compiled without AltiVec/VMX acceleration.
* **G5 owners _ONLY_:** if you want to test the G5-specific code paths apart from the standard `G5.mozcfg`, you should include `--enable-tenfourfox-g5` in your custom `.mozconfig` or the regular code paths will be used instead of the G5-specific ones. This does _not_ enable VMX; if you want that, specify it too. You may also need to add `-D_PPC970_` to your compiler strings so that non-Mozilla libraries and JavaScript properly select the correct architecture optimizations. You don't need this, but the browser will not run as well if you don't.
* **Intel owners _ONLY_:** **Intel builds for TenFourFox 38 do not work.** You can fix this! Good luck; submit patches if you get it operational.
1. (Optional but recommended) Edit `netwerk/protocols/http/OptimizedFor.h` and set the string to something human-readable about the configuration you're building for. This string should be relatively short, and will appear after the `TenFourFox/` in the user agent string.
1. (Optional) If you want to change the reported version numbers (say, to get rid of that `pre` tag), alter `browser/config/version.txt` for the reported browser version, and `config/milestone.txt` for the reported Gecko version. _You should revert these changes before pulling source again or you will have to merge them!_
1. If you are cleaning out an old build, be sure to `rm -rf configure obj-ff-dbg/` first. Then,
1. `autoconf213`
1. `gmake -f client.mk build`
## Known build issues ##
* Until [issue 202](https://code.google.com/p/tenfourfox/issues/detail?id=202) is fixed, you will get spurious errors setting up the Python environment. You can ignore these for now.
* You will receive warnings about `N_SECT` while linking XUL. These are harmless. If you actually get an error and it doesn't build, then somehow you are using the original `strip`. Check your binaries carefully.
## Building from a tarball ##
Depending on the space you have, or your general antipathy towards Mercurial, or your need for an old version of Firefox, you may prefer to build from one of the source archives. The easiest way to do this is to download the archive and expand it, then turn it into a repo with the following (done at the root of the unpacked archive):
* `hg init`
* `hg add`
* `hg commit`
This will create a new blank repo, add everything to it, and then commit. Note that the commit does not restore history; there _is_ no history. Instead, it is as if you started from whole cloth. On the other hand, the resulting repo is considerably smaller and probably easier and faster to work with (but you should _not_ do this if you plan to do development, since you will probably want that history if you screw up).
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`:
* `cd obj-ff-dbg/dist/TenFourFox.app/Contents/MacOS` (or, if in Debug mode, `TenFourFoxDebug.app`)
* `gdb7 firefox`
* At the `(gdb)` prompt, `run`
If the build appeared to work, but the browser crashes in an unusual `objc` symbol when you try to run it or quit, you may have encountered [issue 169](https://code.google.com/p/tenfourfox/issues/detail?id=169) which is due to incorrect linker code generation. Make sure you are using the fixed `ld` (see the prerequisites section).
If you receive strange `Die` errors in the debugger and backtraces don't work properly, you need to upgrade your debugger (or you're using the one that Apple provided, which won't work anymore).
### Distributing the executable ###
Because the new compiler links against its own `libgcc` and `libstdc++`, if you intend to make a build to generally distribute or use on another computer, you will need to include these libraries and update the linkage to point to the included copies. The tool `104fx_copy.sh` (in the root) will help you with this. Make it executable with `chmod +x` if necessary, then simply type `./104fx_copy.sh [destination name.app]` and the built binary will be copied to the destination name (which should be the new app bundle filename) and its linkages updated to be internal. This should be the **last** step you do before release since the binary it generates is completely standalone and disconnected from the build system.
**If you built on 10.5 with a compiler that was also built on 10.5, your built browser will only work on 10.5** (despite using the 10.4 SDK) because the `gcc` 4.6.x `libgcc` and `libstdc++` are linked against the 10.5 SDK, not 10.4. The easiest way to solve this problem is to replace `libgcc_s.1.dylib` and `libstdc++.6.dylib` in your browser package with the ones from a real TenFourFox binary and then your build will "just work" on both operating systems. It _is_ possible, though involved, to build a cross-compiling 10.5 `gcc` that will create 10.4-compatible binaries; see [issue 52](https://code.google.com/p/tenfourfox/issues/detail?id=52).
## Alternative: Build with Fink _(experimental)_ ##
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.
Inevitably there will be merge conflicts, which you will need to manually resolve, mark with `hg resolve -m` and then continue the rebase with `hg rebase --continue`. **NEVER `hg merge`!**
Once the rebase is complete, you will be able to continue building and working with the repo in a sane state. Like any sane SCM, merge changes you made will be reflected in your changesets.

39
IntelBuild.md Normal file
View File

@ -0,0 +1,39 @@
_This document is always under revision_
**Please: do not directly link to downloads. Link to this page instead so that users are properly steered to the current release, and so that they understand the support level of this software.**
## The Intel build is currently badly out of date ##
The Intel version is badly out of date. The previous maintainer is currently unable to issue new releases due to hardware failure. There is no guarantee there will be a future Intel release past 17.0.2, so the Intel build is officially _**deprecated**_.
## Power Macintosh users should _not_ use this version ##
If you are unable to determine what type of computer you have, please read the article on WhichVersion. **PowerPC users should use the regular TenFourFox available from our [main page](http://www.tenfourfox.com/).**
## Whaaat, an Intel Mac version?? ##
Although TenFourFox is intended for Power Macs, there are a number of Intel Macs that for a variety of reasons remain on 10.4 and 10.5. Although our recommendation is, as always, to upgrade them to 10.6 if at all possible and run the real Firefox (which all Intel Macs, even 32-bit ones, are capable of), this at least gives those users an alternative: a browser built using the 10.4 compatibility layer in 10.4Fx, but using Intel code for the JavaScript JIT and SSE acceleration for graphics.
## This version is _not supported_ ##
10.4Fx's primary focus of development remains Power Macs. As a consequence, the Intel version is maintained on a **best effort basis** and, unlike the PowerPC stable branch, **is not release quality**. That means builds and updates are not guaranteed to be timely, bugs may not be fixed on an expedited basis (even serious ones) or even at all, and no bug reports will be accepted for the Intel version on Tenderapp. Furthermore, it is unlikely the Intel version will ever become fully supported and you should not expect this lack of support to change.
**The Intel version may be withdrawn or decommissioned at any time, without warning.** You use it _at your own risk_.
Because **this version is not supported**, it is not offered on the main page and is only offered here.
## System requirements ##
Intel TenFourFox requires any Intel Mac and Mac OS X 10.4.11, 10.5.8 or 10.6.8, with at least 512MB of physical memory and 100MB of hard disk space. A Core 2 Duo or better is recommended. Although the browser will probably run on OS X 10.7+, because of its use of older unsupported APIs it is not supported on Lion or any subsequent version of Mac OS X.
## Known issues specific to the Intel release ##
You should also read the most current release notes (right now ReleaseNotes1702), as most issues specific to TenFourFox for Power Macs also apply to this version.
## Download and installation ##
Current release: http://tenfourfox.googlecode.com/files/TenFourFoxIntel-17.0.2.app.zip
Unzip the application (using the built-in ZIP, not a utility such as Zipeg) and copy it to your Applications folder. Double-click to start.
Again, do not report bugs or questions on the Intel release to Tenderapp.

181
Localization.md Normal file
View File

@ -0,0 +1,181 @@
**How to localize TenFourFox and make a Langpack Installer**
**Summary of changes for 38:**
- All localization files have been moved from Mac OS to Resources in the application package.
- space constraints/truncated strings in the Prefs window are gone because of UI change (prefs moved to tab)
- Check for Updates… has bee moved to the Help menu; localization string remains in baseMenuOverlay.dtd.
- Addon Manager: Plugin section with warning about Plugin support is obsolete
- plugins.dtd> <!ENTITY installPlugin is obsolete
## Localization Guide ##
# 1. Things to have first #
- Existing recent Locale Installer app as an example to work with
- GUItar application for compression/decompression (recommended)
- Apple TextEdit with preferences set to open/save in UTF-8 (or MacRoman if your language characters are supported)
- The TenFourFox version you want to localize
- Intel-Mac Firefox in your language corresponding to the TFF version. I.e. TFF 24.0 -> Firefox Intel 24.0. Please use the ESR version availabe here: http://www.mozilla.org/en-US/firefox/organizations/all.html
# 2. The installer application #
The installer application (incl. the installer script) has already been developed to a stable point.
Rename your installer application to e.g. "TFF-24-langpack-(your language).app" or the like so that people can see which exact version of TFF it is for, and which language the browser is changed to. Strings between sub-versions of the browser (24.0.0->24.0.1) are usually frozen, so the same installer app can be used. An installer for 17 cannot be used for 24 etc.
**The installer app's Package Contents folder contains:**
- the tarball file for the supported versions of TFF that can be localized with this installer. (see Tarball section).
- osx\_install.applescript (see applescript section)
- /Resources/TFFlang.icns: You can change that to your country's flag in Photoshop or just use the generic TFF icon or whatever.
- Info.plist: Change strings inside to the TFF version that is supported.
- TenFourFox de/fr (change name to your language). This is the executable that starts bash and the applescript.
# 3. The tarball file #
tarball.tar.bz2 has a compressed Contents folder. Don't confuse it with the installer application's Contents folder. Use OSX unzip (built-in) or GUItar.app to decompress. Note that it's double compressed in tar and bz2. This Contents folder contains the files that will replace the en-US locale originals in TenFourFox.app, or will be added to the originals:
Contents/Resources
/browser ->1)
/chrome ->2)
/chrome.manifest
/dictionaries ->3)
1)
chrome ->4)
chrome.manifest
defaults/preferences/firefox-l10n.js
2)
(your language)/locale/…
(your language).manifest
3)
(your language).aff
(your language).dic
4)
(your language)/locale/…
(your language).manifest
For creating the tar.bz2 archive: Compress your "Contents" folder in tar, then compress your Contents.tar archive in bz2. You can use GUItar.app to do this. Rename it to "tarball.tar.bz2".
# 4. The manifests #
There are two chrome manifests: in Resources/browser and in Resources.
In chrome.manifest one line must be changed:
manifest chrome/en-US.manifest -> (your language). For your language, use fr (French), ru (Russian) and so on. Use a double name (en-US, en-GB etc.) only when there are different country versions for the same language. Keep the language abbreviation consistent throughout the localization process, e.g. ru.manifest, "ru" folder in your folder tree etc.
There are two (your language) manifests: in Resources/browser/chrome an in Resources/chrome. Copy the two respective en-US.manifest files from TFF and rename (your language).manifest. Inside change all strings accordingly.
Always use the original (!) manifest files from the TFF version you want to translate. Never copy them from the Intel version or any other version of the installer app, otherwise you will run into trouble.
# 5. The dictionaries #
Most languages in recent Firefox versions don't package the traditional dictionary files anymore (but TFF does). You will have to extract those from old FF 3.6.x in your language or download them from https://addons.mozilla.org/En-us/firefox/language-tools/. Note that both the .dic file and the .aff files are necessary.
# 6. l10n.js #
browser/defaults/preferences/firefox-l10n.js must be changed to your language. This is necessary so that browser extensions will speak your language if the programmer included them, otherwise they will stay English.
pref("general.useragent.locale", "(your language)");
# 7. Localization Strings taken from Intel-Firefox #
The localization strings are located within two folder trees within the TFF application package: Contents/Resources/Chrome/(language) and Contents/Resources/browser/chrome/(language). Have a look at the en-US folders in TFF first. You will need some of the files and strings inside later. The installer script copies your language folder tree from the installer app to TFF, so that the browser will have the folders for en-US (inactive) and (your language) (active) in the end.
1) Download the corresponding Intel version of FF and get the two omni.ja files from its application contents folder (Firefox uses a compressed jar format, while TFF doesn't). Rename to "omni.zip". Omni has a special zip format that Mac OS X itself might be unable to decompress. You can use the application GUItar for that.
2) Recreate the en-US folder tree within TFF in your language. Copy/replace all of them to your contents folder except the custom strings (if you're unsure, download an existing TFF 24+ installer app and look inside).
To edit the files, you can use Apple's TextEdit. Set Open and Save to UFT-8 in the preferences.
Note: The folder trees is the hardest thing to make. Be prepared to spend some time. If your tree doesn't work at first, try copying only some new string files/folders at a time to see at which point it's messed up. Always check if the edited files in the FF Intel version of your language, the TFF version of your language and the TFF en-US version are consistent.
# 8. TFF custom strings #
Some strings differ from the Intel Firefox version because we have our own update system and we don't support plugins.
browser/chrome/(language)/locale/browser/baseMenuOverlay.dtd (add Check for updates… string in your language to the Intel file)
browser/chrome/(language)/locale/branding/brand.dtd, brand.properties: Tenfourfox instead of Firefox; look at the original TFF file as an example and edit the Intel files accordingly, minus trademarkInfo in brand.dtd (<!ENTITY trademarkInfo.part1 " ">)
Leave homePageSingleStartMain as is.
chrome/(language)/locale/(language)/mozapps/update/updates.dtd (manual update strings; edit the Intel file and translate&add these strings from the original TFF file)
(manualupdate2/3)
chrome/(language)/locale/(language)/mozapps/plugins/plugins.dtd
<!ENTITY missingPlugin "TenFourFox does not support plugins for this content.">
chrome/(language)/locale/(language)/global/videocontrols.dtd:
instead of <!ENTITY error.srcNotSupported "Video format or MIME type is not supported.">
use <!ENTITY error.srcNotSupported "To play, ensure QuickTime Enabler is installed, then right-click and select Open Media in QuickTime."> in your language.
browser/chrome(language)locale/browser/aboutDialog.dtd (TFF's own dialog, use that instead of the Intel FF's which is incompatible. Translate the strings (it's sufficient to translate the strings that are actually shown in TFF. We don't use the update mechanism in the dialog.) ((in Aurora/Alpha versions, the About dialog will show different strings, check that you translated all of them, or just leave them English since this version won't go public anyway.))
# 9. The applescript #
The script does the automatic replacing and re-writing in the TFF.app and FF user profile. This script was originally taken and modified from the Open(Libre)Office langpack installer.
Translate the UI strings to your language. Also change the stated TFF version(s) to the correct one(s) in:
- set intro to
- set TFFVersions to
The script does the following things:
- Quits TFF if it's running
- Looks for TFF.app(s) and lets the user choose one if applicable
- Checks if TFF version is correct (i.e. is one of the version(s) supported by this installer app)
- Adds localization files to TFF app plus both (your language).manifest plus dictionaries
- Replaces both chrome.manifest
- Looks for user profile(s) in ~/Application Support/Firefox and writes general.useragent.locale (your language) in prefs.js

51
MacTubesEnabler.md Normal file
View File

@ -0,0 +1,51 @@
## The MacTubes Enabler is no longer receiving updates because of the end of support for the older YouTube API used by MacTubes. When/if this changes, the Enabler will be updated. Until then, we suggest the QuickTimeEnabler, which does work with many YouTube videos as well. ##
_This wiki page is updated for releases of the MacTubes Enabler. Please check back on this page for the most up-to-date information._
# Using the TenFourFox MacTubes Enabler #
The TenFourFox MacTubes Enabler (hereafter the **MTE**) allows you to play selected YouTube videos in MacTubes, outside of the browser. This gives you a safer alternative to Flash for many videos and for those YouTube videos that do not perform well with the QuickTimeEnabler (hereafter the **QTE**).
The MTE does not replace the QTE. The QuickTimeEnabler is needed for HTML5 files and other kinds of media content that are outside of YouTube, and the QTE allows you to play certain YouTube videos in QuickTime Player instead of MacTubes if you prefer. **You can have both the QTE and MTE installed at the same time. You do not need the QTE to use the MTE.**
For security considerations with QuickTime 7, see [this blog post](http://tenfourfox.blogspot.com/2012/05/security-blanket-blues.html).
**The MTE is currently a beta release. It works for many YouTube videos, but you may experience minor bugs.**
## Installing the MTE ##
The MTE is an **optional add-on** for 10.4Fx. It is not part of the browser by default; you must download it separately. The most recent version is always available from this page. **The MTE requires at least TenFourFox 24.1.0 and MacTubes 3.1.6. The MTE is not supported on any previous release of 10.4Fx.**
First, install MacTubes from its home page: http://macapps.sakura.ne.jp/mactubes/index_en.html
Make sure MacTubes is able to find and play your typical YouTube videos. If it cannot, the MTE will not help you.
Once you've confirmed MacTubes can play your desired content, download the MTE using the links below. Once downloaded, drop it on the TenFourFox window, approve the installation and follow the prompts. You do not need to restart the browser; the add-on takes effect immediately.
### Additional codecs required ###
The video formats you can play are significantly increased by installing [Perian](http://www.perian.org/) for QuickTime and it is strongly recommended. Follow the installation directions.
For Tiger users, some H.264 videos may require additional H.264 profile codec support, which the [avc1Decoder package](http://www003.upp.so-net.ne.jp/mycometg3/) offers. Install the component in `/Library/QuickTime` and, optionally, install the preference pane.
Restart QuickTime Player after installing any new components. However, you should not need to restart your Macintosh.
## Using the MTE to play YouTube videos ##
**If you are on a page at `youtube.com`,** simply right-click anywhere on the page. A context menu will appear with an option to `Open YouTube Video in MacTubes`. Select that option. The video will automatically open in MacTubes (if MacTubes is not already running, it will automatically start).
**If you are trying to play an embedded YouTube video,** you may be able to right-click on the video itself to play it, but this may not work if the site has only embedded the Flash video stream. If the site has a link to the actual YouTube video page, this will be more reliable.
For optimal playback, especially of unusual codecs or high-definition content, we recommend setting MacTubes to the QuickTime Player option under Preferences, Player. You may need to enable FLV videos under Preferences, Format for some movies to play at all. (FLV support needs Perian for playback.)
If you are using a G5 or dual-processor G4 at or above 1.25GHz, you can probably play most 720p high definition videos. Only G5s at or above 2.5GHz can play 1080p video satisfactorily, and for best results you should set Performance to Fastest in System Preferences. Slower dual-processor G4, single-processor G4 and G3 systems should use standard 480p definition only.
If you are using HTML5 WebM video, you may need to stop the video from playing in the browser before opening it in the MTE. You can also try selecting `Open YouTube Video in MacTubes, Close Tab` which will open the video and automatically close the YouTube tab it came from so that no further downloading, decoding or playback occurs.
## Download the MTE ##
[The most current version is v.1, downloadable here.](http://tenfourfox.googlecode.com/files/mactubes-enabler-beta1.xpi)
## Changelog ##
v.1. Initial release.

45
PluginsNoLongerSupported.md Normal file
View File

@ -0,0 +1,45 @@
**To keep this page useful and non-cluttered, comments that are not related to plugin alternatives may be deleted for space. Please do not modify this document unless you are authorized to do so.**
# Why aren't plugins supported in TenFourFox? Why can't I use Flash? #
One of the controversial decisions made in TenFourFox (henceforth _10.4Fx_) 6.0 was to disable plugin support, which includes Flash, QuickTime, PDF plugins and other specific kinds of functionality. This page is to explain why and to give you safer options.
## Plugins (unsupported) versus add-ons (mostly supported) ##
A _plugin_ is a system module of native code, which the browser runs when trying to handle a specific type of content it doesn't handle usually, such as QuickTime movies, PDF documents or Flash video or Flash applets. Plugins are generally system-wide: the same plugin you used previously in 10.4Fx is the same plugin you use in Safari or Camino. Plugins do not alter the browser itself, although they can affect the browser, and they run within a specific window or tab instance only when called for. TenFourFox no longer supports plugins.
An _add-on_ is a browser module, usually written in JavaScript and XUL. It only works in Firefox and 10.4Fx, and can be used for a wide variety of browser features such as adding protocol support, blocking content (such as scripts and advertisements) or adding new functionality. Some features are only possible with add-ons, and add-ons can significantly modify the browser as a whole rather than being limited to a specific window or tab. Because of their privileged nature, Mozilla curates add-ons that appear on [their official site](http://addons.mozilla.org/) and many authors offer regular updates to fix bugs and security issues.
TenFourFox _does_ support _most_ add-ons. The add-ons it does not support are those that contain native Intel code, or, on Tiger Macs, add-ons that contain native code that requires Leopard. **You can continue to use add-ons compatible with the same version of Firefox in TenFourFox in most cases.**
## PowerPC plugins are unmaintained and insecure, and Mozilla is changing the plugin environment ##
No major plugin is being maintained for Power Macs any more: Flash stopped updates with Flash 10.1.102.64 in November 2010, and QuickTime 7 for the PowerPC was decommissioned with the release of QuickTime 7.7 and OS X Lion in August 2011. (Tiger users have not had an update since QT 7.6.4 in September 2009.)
Plugins have special access to the system. When they are instantiated by the browser, they run as if you were running any regular application, which is true even for out-of-process plugins (which were never available for 10.4Fx due to Tiger SDK limitations). Like any buggy or insecure application, they can be exploited or made to crash, and because the plugin runs within the browser, such methods can also be used to attack, spy upon or destabilize the browser as well. They have also been used to [attack the network the computer is running on](http://www.pcworld.com/article/141399/flash_attack_could_take_over_your_router.html), and a well-crafted attack vector such as that example can run anywhere Flash does, including Power Macs. Because plugins load automatically by default when the page calls for them, your system could be exploited before you even notice.
Many of these attacks can be mitigated, though not entirely prevented, by the use of add-ons that can block plugins from loading. However, there is still another problem apart from security: Mozilla is changing the environment and the technical requirements for how plugins interact with the system. These technical requirements are difficult to achieve with Mac OS X 10.4, and there are known graphical and compatibility bugs already. It is entirely possible that in the near future, extant PPC-compatible plugins will not function properly or at all.
The final nail in the coffin, however, is that even when working properly many sites now require Flash 11 or higher, which will never be available for Power Macs. Even if these two issues didn't apply, it still isn't possible to view some kinds of content, it never will be, and this problem will only get worse.
## Towards a plugin-free future ##
TenFourFox survives on the volunteer work of its maintainers. It is already a large workload to maintain the browser's compatibility with Mac OS X 10.4, 10.5 and PowerPC in general, and in the not-too-distant future Mozilla will not support 10.6 either which will add to the burden.
It doesn't make good use of our resources, then, to try to get legacy code that is not under our control to operate within the moving target that is Mozilla plugin support, especially now that Mozilla has dramatically increased the speed at which they release new versions. And even if we did get them to work, because we don't control the code behind them we continue to risk exposing ourselves and our users to insecure software that will become less and less compatible and more and more vulnerable with time.
With TenFourFox, we're concentrating on optimizing open alternatives that can run within the browser, such as faster JavaScript, faster browser-generated graphics and faster WebM HTML5 video. As Mozilla adds more interactive HTML5 features to Firefox, many of these features will appear in 10.4Fx, superseding the need for plugins.
## What can I use to replace Flash and QuickTime right now? ##
There will still be some content you can't view without a Flash plugin in the browser. Some of it can be worked around.
* TenFourFox can open some videos in QuickTime Player directly using the QuickTimeEnabler. This is compatible with many HTML5 video and audio files, and YouTube.
* For YouTube videos in particular, the free [MacTubes](http://macapps.sakura.ne.jp/mactubes/index_en.html) application allows you to view YouTube video in multiple resolutions and full-screen. It is also more efficient at playback on older Macs. Please support this excellent application.
* If you have a fast-enough G4 or G5, you can also view many YouTube videos using TenFourFox's built-in HTML5 WebM video support, which _is_ supported. To do so, visit http://www.youtube.com/html5 and "opt in" to the HTML5 trial. This will set a temporary cookie so that available embedded videos and videos on YouTube will be presented to you in native HTML5 video, if available. While you do not need a YouTube account to use HTML5 video, the cookie may periodically expire and require renewal, and not all videos are available in WebM.
* For other video files, you can use any of the available Firefox YouTube or Flash video download extensions, and view the media files off-line with [Perian](http://www.perian.org/) for QuickTime (or QuickTime itself for codecs QT supports).
* For other audio files, download the audio file and play it in QuickTime Player.
* For PDF documents, download and view them in Preview or Adobe Reader. Mozilla support for in-browser PDF is under development.
We welcome other plugin-free suggestions in the comments. Thanks for your understanding and helping us work towards preserving the long-term longevity of the Power Mac platform. The more functional code we have under the control of the community, the longer our Macs will be serviceable and useful. This means eliminating proprietary software in favour of open solutions is a must for future maintainability, and dropping plugin support, while painful now, will pay off handsomely later.

23
ProjectHome.md Normal file
View File

@ -0,0 +1,23 @@
## The TenFourFox project site will be moving to Github because Google are meaniepants and shutting down Google Code, because they're poopieheads. See you there in a few weeks. We'll post a link when it's ready. ##
A port of modern Firefox to the Power Mac, supporting Mac OS X 10.4 and 10.5, with special features and optimizations for PowerPC processors and AltiVec. _This project is not affiliated with nor supported by Mozilla in any way, and is not an official build._ **PowerPC forever!**
This project is specifically for Mac OS X 10.4+. If you're looking for a browser for Mac OS 8.6-10.3, look at our sister project, [Classilla](http://www.classilla.org/).
**Because of Google Code's new download restrictions, all releases from 24.1.0 inclusive on will be released through [our SourceForge repository](https://sourceforge.net/projects/tenfourfox/files/),** including binaries and changesets. Historical downloads will remain here while they last, as well as the worklist and wiki. _If you want to verify the authenticity of a build you downloaded from SourceForge, see [Hashes](Hashes.md)._
Want to build your own browser or help develop? See HowToBuildRightNow. For a schedule of expected future releases, see [Roadmap](Roadmap.md).
**Please do not report bugs unless you have tested them against the current version of Firefox. Bug reports that do not include comparison against standard Firefox will be marked invalid.** Firefox 3.6 does not count. Only bugs that are different in TenFourFox relative to Firefox will be accepted. For layout bugs, please use a system that is _not_ hardware accelerated. Because we realize that the point of TenFourFox is to facilitate access on Macs that can't run current versions of Firefox ordinarily, comparisons will be accepted to any [Tier 1 platform](https://developer.mozilla.org/en/Supported_build_configurations), including Windows and Linux. Please follow the template; it will help guide you. This is being enforced to keep the worklist sane. Thanks for helping your _unpaid volunteer_ maintainer(s) keep TenFourFox current.
**Plugins, including Flash, do not operate in TenFourFox.** Please do not file bugs on this; this policy will not change. See PluginsNoLongerSupported for explanations and workarounds. **You can now access many videos with the QuickTimeEnabler** (in beta).
**Get quick answers to common questions from the [TenFourFox Official FAQ](AAATheFAQ.md), or see the rest of the [TenFourFox Wiki](http://code.google.com/p/tenfourfox/w/list)**
**For end-user support, please post problems or questions to the [TenFourFox Tenderapp](http://tenfourfox.tenderapp.com/) page.**
**Visit our main page at [www.tenfourfox.com](http://www.tenfourfox.com/)**
**Read our blog at [tenfourfox.blogspot.com](http://tenfourfox.blogspot.com/)**
_TenFourKit is an unaffiliated project and is not maintained by TenFourFox. AuroraFox and Tenfourbird are based on TenFourFox code, but are not maintained by TenFourFox either. Please consult those projects specifically for support._

103
QuickTimeEnabler.md Normal file
View File

@ -0,0 +1,103 @@
_This wiki page is updated for releases of the QuickTime Enabler. Please check back on this page for the most up-to-date information._
**Please do not post URLs that don't work unless requested. In general, doing so doesn't help us, as the offending URL usually falls under one of the categories that the QTE cannot assist. These comments may be deleted for space.**
# Using the TenFourFox QuickTime Enabler #
The TenFourFox QuickTime Enabler (hereafter the **QTE**) allows you to play selected HTML5 video and audio files and YouTube videos in QuickTime, outside of the browser. You can even play H.264 content with the QTE. This gives you a safer alternative to Flash for many videos.
If you especially need YouTube support, you may also benefit from installing the MacTubesEnabler.
For security considerations with QuickTime 7, see [this blog post](http://tenfourfox.blogspot.com/2012/05/security-blanket-blues.html).
The QTE _does not_ play Flash applets, and is not a substitute for Flash. Sites that only allow video playback through Flash are not compatible with the QTE.
**The QTE is currently a beta release. It works for many media files, but you may experience minor bugs.**
## Installing the QTE ##
The QTE is an **optional add-on** for 10.4Fx. It is not part of the browser by default; you must download it separately. The most recent version is always available from this page. **The QTE requires at least TenFourFox 10.0.0 and QuickTime 7. You cannot use the QTE with any previous version of TenFourFox, and the QTE may not work properly with QuickTime X if you are using an Intel system.**
Once downloaded, drop it on the TenFourFox window, approve the installation and follow the prompts. You do not need to restart the browser; the add-on takes effect immediately.
### Additional codecs required ###
The video formats you can play are significantly increased by installing [Perian](http://www.perian.org/) for QuickTime and it is strongly recommended. Follow the installation directions.
For Tiger users, some H.264 videos may require additional H.264 profile codec support, which the [avc1Decoder package](http://www003.upp.so-net.ne.jp/mycometg3/) offers. Install the component in `/Library/QuickTime` and, optionally, install the preference pane.
Restart QuickTime Player after installing any new components. However, you should not need to restart your Macintosh.
## Using the QTE ##
When you open a video with the QTE, QuickTime Player will automatically start and the video will open _outside_ of the browser. You can have as many videos open as you like. For best results, make sure _Automatically play movies when opened_ is checked in Preferences in the QuickTime Player. Once the video has sufficiently buffered, it will automatically begin to play.
### To play YouTube videos ###
**If you are on a page at `youtube.com`,** simply right-click anywhere on the page. A context menu will appear with a list of resolutions. Click on the desired resolution; if it is available, it will be loaded, and if it is not the QTE will select a fallback resolution. Even if the video states it is "unavailable," you may still be able to access the video with the QTE.
The QTE will tell you the source URL, and then the video will load in QuickTime Player.
If you are using a G5 or dual-processor G4 at or above 1.25GHz, you can probably play most 720p high definition videos. Only G5s at or above 2.5GHz can play 1080p video satisfactorily, and for best results you should set Performance to Fastest in System Preferences. Slower dual-processor G4, single-processor G4 and G3 systems should use standard 480p definition only.
If you are using HTML5 WebM video, you may need to stop the video from playing in the browser or close the video tab entirely before opening it in the QTE.
**If you are trying to play an embedded YouTube video,** you may be able to SHIFT-right-click (hold down SHIFT and right-click) on the video to play it, but this will not work if the site has only embedded the Flash video stream. If the site has a link to the actual YouTube video page, this will be more reliable.
**For particularly problematic YouTube videos, the MacTubesEnabler may help.**
If you have QuickTime Pro, you can then save the video to disk to play later.
### To play generic HTML5 video and audio ###
Sites that use the `<video>` and `<audio>` tags can play directly in the QTE. Simply right-click on the video or audio and select `Open Media in QuickTime`. The QTE will tell you the source URL, and then the media will open in QuickTime Player.
On some sites, you may need to click the video to start it playing before the browser will let you select the Open Media option.
If you have QuickTime Pro, you can then save the media file to disk to play later.
### To play _links to_ video and audio ###
If you are on a page where you have a link to an audio or video file, you can right click on the link and select `Open Link in QuickTime`. The QTE will then get the target of the link and try to play it in QuickTime Player.
There is no way the QTE can know what's on the other end, however, so use it only on links you reasonably believe are playable media files. JavaScript links and buttons, for example, don't work with this.
If you have QuickTime Pro, you can then save the media file to disk to play later.
### To load images into QuickTime Player ###
The QTE can also load images into QuickTime Player. The image does not have to be animated. Simply right-click on the image and select `Open Media in QuickTime`. The QTE will tell you the source URL, and then the image will open in QuickTime Player.
If you have QuickTime Pro, you can then save the image to disk to view later.
## Sites that do not work with the QTE ##
Sites that only offer video through Flash _**will not work**_ (example: CNN, Fox News), unless they offer an HTML5 option.
Sites that require a username and password _**will not work**_ (example: Vimeo).
YouTube videos that require displaying advertisements _**will not work**_. These might work in the MacTubesEnabler, however, depending on the format.
For these sites, one of the Firefox video downloader add-ons may allow you to still retrieve and view these videos outside of the browser.
## Download the QTE ##
**For 24.x and 31.x:** [The most current version is v.120, downloadable here.](http://sourceforge.net/projects/tenfourfox/files/addons/qte/qte-v120.xpi/download)
### Older versions ###
You should only use these for old versions of TenFourFox.
**For 17.x:** [The most current version is v.116, downloadable here.](http://tenfourfox.googlecode.com/files/tenfourfox-quicktime-enabler-116.xpi)
**For 10.x:** [The most current version is v.115, downloadable here.](http://tenfourfox.googlecode.com/files/tenfourfox-quicktime-enabler-115.xpi)
## Changelog ##
v.120. 24 only. Fixes jetpack version. Minor bug fixes.
v.116. 17 only. Fixes jetpack version.
v.115. Fixes YouTube playback; adds play-from-link support. Last version to support TenFourFox 10.
v.114. Converted to beta.

63
ReleaseNotes100.md Normal file
View File

@ -0,0 +1,63 @@
_This document may be updated for late-breaking changes, so check back here if you are having difficulty._
## System requirements ##
TenFourFox (hereafter "10.4Fx") requires a G3 Power Macintosh, Mac OS X 10.4.11, 100MB of free disk space and 512MB of RAM. 1GB of RAM and a G4 or G5 processor is recommended. Video playback is likely to be poor on systems slower than 1.25GHz; a G5 is recommended. Mac OS X 10.5.8 is supported.
Intel Macintoshes are not supported, but the G3 build is known to run under Rosetta in 10.4.11, 10.5.8 and 10.6.8. Because Apple no longer supports Rosetta and 10.4Fx is not a Universal binary, it will not run under Lion 10.7 or any future version of Mac OS X.
## Getting TenFourFox ##
Make sure you select the appropriate build for your Mac from the [download page](http://www.tenfourfox.com/). The G3 version will run on any supported Macintosh, but it will not take advantage of the additional features of G4 or G5 processors. The G4 and G5 versions will not run correctly on a G3, and the G5 version will perform worse on non-G5 Macintoshes.
If you are using a G4, you should try to choose the correct version for your processor generation (7400 or 7450 "G4e") as performance may be impaired if you run the wrong one. If you don't know which G4 processor you have, the instructions in WhichVersion will tell you how to find out.
## TenFourFox 10.0.x is equivalent to Firefox ESR 10.0.x ##
TenFourFox uses modified Firefox source code, rewritten to remain compatible with Mac OS X v10.4 and the Power Macintosh. It also contains specific optimizations and special features for PowerPC processors. For this reason, it is not exactly the same as Firefox. However, it is intended to be as compatible with it as possible, including most add-ons and [most standard features](TechnicalDifferences.md). You can treat 10.4Fx as equivalent with Firefox ESR 10.0 in most circumstances, with specific exceptions noted below.
Note that add-ons which require an Intel Macintosh will not work with TenFourFox, even if they are otherwise compatible with Firefox 10, and add-ons that require 10.5 Leopard may not be compatible with TenFourFox running on Mac OS X 10.4 Tiger, even if they are compatible with PowerPC.
## This branch of TenFourFox is the _stable_ version ##
Starting with Firefox 10, Mozilla is now offering an extended support release version of Firefox ("Firefox **ESR**") intended for environments where users are unable to use rapid-release versions of Firefox due to policy or technical constraints.
10.4Fx 10.x is based on this extended support release and is intended for users who wish to remain with a stable browser core. The stable branch will continue to receive bugfixes and security updates, but will not receive new Firefox features (although it may receive certain 10.4Fx-specific features judged important for our legacy users).
**We recommend this version for most of our users.** If you wish to help test our continuing porting efforts, you can try the _unstable_ branch, which is based on the current release of Firefox. _The unstable branch does have bugs and is recommended only for advanced users._ For more information, see the [TenFourFox Development](http://tenfourfox.blogspot.com/) blog.
## TenFourFox no longer supports plugins or Flash ##
Plugins on PowerPC are of special concern because Mozilla is making updates to their plugin architecture which may require the plugins themselves to be updated, and there are certain difficult-to-correct bugs with them already on Tiger. Most importantly, Adobe Flash for PowerPC is no longer maintained and has known security risks that can crash or leak data, and QuickTime for Leopard will lose its own support with the release of OS X Lion. In addition, Flash 10.1 is rapidly becoming unsupported by many applications.
**As of TenFourFox 6.0, for these and other reasons (for details, see PluginsNoLongerSupported), plugin support ships disabled.** Plugins will not operate by default, and bug reports will no longer be accepted. Sites will now act as if no plugins were installed at all.
For Internet video, we strongly recommend the use of [Perian](http://www.perian.org/) and any of the available video download add-ons for Firefox.
For YouTube, we recommend [MacTubes](http://macapps.web.infoseek.co.jp/mactubes/index_en.html). If you have a high end G4 or G5, you can also use WebM for selected videos by visiting http://www.youtube.com/html5 and enabling HTML5 video. This will set a temporary cookie enabling browser-based video without Flash. You do not need a YouTube account for this feature, but you may need to periodically renew the cookie setting. Not all video is available in WebM.
For a more in-depth explanation of this policy and other workarounds, see PluginsNoLongerSupported.
## New features specific to TenFourFox ##
* All new standard features of Firefox 10, including developer tools to inspect web pages within the browser, multi-threaded WebM video support, dynamically controlled full-screen web content, 3D CSS support (using software rendering), interface improvements and improved HTML5 compliance.
* Starting with TenFourFox 10, 10.4Fx now uses a new JavaScript accelerator featuring method-based compilation and type inference ("JM+TI"), the same compiler used in standard Firefox ([issue 96](https://code.google.com/p/tenfourfox/issues/detail?id=96)). This compiler meets or exceeds the original tracing JIT on most tested benchmarks, and is now the default compiler. The tracejit remains in the stable branch as a legacy method for testing, and will not be in 11.0 or any subsequent version.
* Additional AltiVec-accelerated text conversion methods ([issue 98](https://code.google.com/p/tenfourfox/issues/detail?id=98)).
## Known issues fixed in this version of TenFourFox ##
* The previous AltiVec-accelerated text converters are fixed and reenabled in this release ([issue 75](https://code.google.com/p/tenfourfox/issues/detail?id=75), [issue 76](https://code.google.com/p/tenfourfox/issues/detail?id=76)).
* An issue with incorrect results from certain regular expressions in JavaScript has been corrected ([issue 120](https://code.google.com/p/tenfourfox/issues/detail?id=120)).
* `about:memory` no longer displays erroneous characters ([issue 121](https://code.google.com/p/tenfourfox/issues/detail?id=121)).
## Known issues specific to TenFourFox ##
* Remember: **Plugins are turned off by default, and code for them will fail to function entirely in a subsequent version.** See PluginsNoLongerSupported for an explanation and suggested workarounds. Please note that out-of-process plugins have never been supported.
* As of TenFourFox 8, TenFourFox uses a lighter chrome for windows and dialogue boxes than prior versions or the official Mac Firefox. This is intentional.
* When 10.4Fx has no suggestions for the awesome bar, a blank box appears instead ([issue 21](https://code.google.com/p/tenfourfox/issues/detail?id=21)). This is intentional.
* 10.4Fx does not currently support WebGL, and Indic, Arabic and other scripts requiring glyph reordering or language-specific ligatures may not appear correctly. See TechnicalDifferences for the complete list of changes necessary for 10.4Fx. See [issue 5](https://code.google.com/p/tenfourfox/issues/detail?id=5) for notes specific to the font issue.
* Animation performance is currently poorer in Mozilla 2.0/Firefox 4.0 and later versions using software rendering, which includes 10.4Fx. Mozilla acknowledges this bug, but there is not yet an ETR. See [issue 7](https://code.google.com/p/tenfourfox/issues/detail?id=7).
* The titlebar does not always properly match the menu gradient ([issue 16](https://code.google.com/p/tenfourfox/issues/detail?id=16)). This problem is also in the official release. Installing a Persona may fix this issue if you find it bothersome.
* Crash reporting is intentionally disabled to avoid polluting Mozilla's crash tracking system with our reports. Please use your system's crash logs if you are reporting a _reproducible_ crash, or (if you are able) provide a `gdb` backtrace.
* Although 10.4Fx will tell you when an update is available, you must download updates manually at this time.
You are welcome to report other bugs that you find. However, please **do not report Mozilla bugs to us.** If the bug or crash occurs in both the official Mozilla Firefox 10 _(3.6 doesn't count!)_ and in 10.4Fx, this is a Mozilla bug, and you should file it at [Bugzilla](http://bugzilla.mozilla.org/). **You must test your bug in both places -- bugs that are not confirmed to be part of 10.4Fx will be marked invalid** so that we can keep our task list focused. This is the [current list of known issues](http://code.google.com/p/tenfourfox/issues/list).

56
ReleaseNotes1001.md Normal file
View File

@ -0,0 +1,56 @@
_This document may be updated for late-breaking changes, so check back here if you are having difficulty._
## System requirements ##
TenFourFox (hereafter "10.4Fx") requires a G3 Power Macintosh, Mac OS X 10.4.11, 100MB of free disk space and 512MB of RAM. 1GB of RAM and a G4 or G5 processor is recommended. Video playback is likely to be poor on systems slower than 1.25GHz; a G5 is recommended. Mac OS X 10.5.8 is supported.
Intel Macintoshes are not supported, but the G3 build is known to run under Rosetta in 10.4.11, 10.5.8 and 10.6.8. Because Apple no longer supports Rosetta and 10.4Fx is not a Universal binary, it will not run under Lion 10.7 or any future version of Mac OS X.
## Getting TenFourFox ##
Make sure you select the appropriate build for your Mac from the [download page](http://www.tenfourfox.com/). The G3 version will run on any supported Macintosh, but it will not take advantage of the additional features of G4 or G5 processors. The G4 and G5 versions will not run correctly on a G3, and the G5 version will perform worse on non-G5 Macintoshes.
If you are using a G4, you should try to choose the correct version for your processor generation (7400 or 7450 "G4e") as performance may be impaired if you run the wrong one. If you don't know which G4 processor you have, the instructions in WhichVersion will tell you how to find out.
## TenFourFox 10.0.x is equivalent to Firefox ESR 10.0.x ##
TenFourFox uses modified Firefox source code, rewritten to remain compatible with Mac OS X v10.4 and the Power Macintosh. It also contains specific optimizations and special features for PowerPC processors. For this reason, it is not exactly the same as Firefox. However, it is intended to be as compatible with it as possible, including most add-ons and [most standard features](TechnicalDifferences.md). You can treat 10.4Fx as equivalent with Firefox ESR 10.0 in most circumstances, with specific exceptions noted below.
Note that add-ons which require an Intel Macintosh will not work with TenFourFox, even if they are otherwise compatible with Firefox 10, and add-ons that require 10.5 Leopard may not be compatible with TenFourFox running on Mac OS X 10.4 Tiger, even if they are compatible with PowerPC.
## This branch of TenFourFox is the _stable_ version ##
Starting with Firefox 10, Mozilla is now offering an extended support release version of Firefox ("Firefox **ESR**") intended for environments where users are unable to use rapid-release versions of Firefox due to policy or technical constraints.
10.4Fx 10.x is based on this extended support release and is intended for users who wish to remain with a stable browser core. The stable branch will continue to receive bugfixes and security updates, but will not receive new Firefox features (although it may receive certain 10.4Fx-specific features judged important for our legacy users).
**We recommend this version for most of our users.** If you wish to help test our continuing porting efforts, you can try the _unstable_ branch, which is based on the current release of Firefox. _The unstable branch does have bugs and is recommended only for advanced users._ For more information, see the [TenFourFox Development](http://tenfourfox.blogspot.com/) blog.
## TenFourFox no longer supports plugins or Flash ##
Plugins on PowerPC are of special concern because Mozilla is making updates to their plugin architecture which may require the plugins themselves to be updated, and there are certain difficult-to-correct bugs with them already on Tiger. Most importantly, Adobe Flash for PowerPC is no longer maintained and has known security risks that can crash or leak data, and QuickTime for Leopard will lose its own support with the release of OS X Lion. In addition, Flash 10.1 is rapidly becoming unsupported by many applications.
**As of TenFourFox 6.0, for these and other reasons (for details, see PluginsNoLongerSupported), plugin support ships disabled.** Plugins will not operate by default, and bug reports will no longer be accepted. Sites will now act as if no plugins were installed at all.
For Internet video, we strongly recommend the use of [Perian](http://www.perian.org/) and any of the available video download add-ons for Firefox.
For YouTube, we recommend [MacTubes](http://macapps.web.infoseek.co.jp/mactubes/index_en.html). If you have a high end G4 or G5, you can also use WebM for selected videos by visiting http://www.youtube.com/html5 and enabling HTML5 video. This will set a temporary cookie enabling browser-based video without Flash. You do not need a YouTube account for this feature, but you may need to periodically renew the cookie setting. Not all video is available in WebM.
For a more in-depth explanation of this policy and other workarounds, see PluginsNoLongerSupported.
## Known issues fixed in this version of TenFourFox ##
* This release fixes a high-priority Mozilla security issue (Mozilla [bug 724284](https://code.google.com/p/tenfourfox/issues/detail?id=24284)). This issue is specific to version 10.
* Certain web pages no longer display random capitalization ([issue 122](https://code.google.com/p/tenfourfox/issues/detail?id=122), [issue 129](https://code.google.com/p/tenfourfox/issues/detail?id=129)). This issue does not affect TenFourFox 9.0 or earlier.
## Known issues specific to TenFourFox ##
* Remember: **Plugins are turned off by default, and code for them will fail to function entirely in a subsequent version.** See PluginsNoLongerSupported for an explanation and suggested workarounds. Please note that out-of-process plugins have never been supported.
* As of TenFourFox 8, TenFourFox uses a lighter chrome for windows and dialogue boxes than prior versions or the official Mac Firefox. This is intentional.
* When 10.4Fx has no suggestions for the awesome bar, a blank box appears instead ([issue 21](https://code.google.com/p/tenfourfox/issues/detail?id=21)). This is intentional.
* 10.4Fx does not currently support WebGL, and Indic, Arabic and other scripts requiring glyph reordering or language-specific ligatures may not appear correctly. See TechnicalDifferences for the complete list of changes necessary for 10.4Fx. See [issue 5](https://code.google.com/p/tenfourfox/issues/detail?id=5) for notes specific to the font issue.
* Animation performance is currently poorer in Mozilla 2.0/Firefox 4.0 and later versions using software rendering, which includes 10.4Fx. Mozilla acknowledges this bug, but there is not yet an ETR. See [issue 7](https://code.google.com/p/tenfourfox/issues/detail?id=7).
* The titlebar does not always properly match the menu gradient ([issue 16](https://code.google.com/p/tenfourfox/issues/detail?id=16)). This problem is also in the official release. Installing a Persona may fix this issue if you find it bothersome.
* Crash reporting is intentionally disabled to avoid polluting Mozilla's crash tracking system with our reports. Please use your system's crash logs if you are reporting a _reproducible_ crash, or (if you are able) provide a `gdb` backtrace.
* Although 10.4Fx will tell you when an update is available, you must download updates manually at this time.
You are welcome to report other bugs that you find. However, please **do not report Mozilla bugs to us.** If the bug or crash occurs in both the official Mozilla Firefox 10 _(3.6 doesn't count!)_ and in 10.4Fx, this is a Mozilla bug, and you should file it at [Bugzilla](http://bugzilla.mozilla.org/). **You must test your bug in both places -- bugs that are not confirmed to be part of 10.4Fx will be marked invalid** so that we can keep our task list focused. This is the [current list of known issues](http://code.google.com/p/tenfourfox/issues/list).

58
ReleaseNotes10010.md Normal file
View File

@ -0,0 +1,58 @@
_This document may be updated for late-breaking changes, so check back here if you are having difficulty._
## System requirements ##
TenFourFox (hereafter "10.4Fx") requires a G3 Power Macintosh, Mac OS X 10.4.11, 100MB of free disk space and 512MB of RAM. 1GB of RAM and a G4 or G5 processor is recommended. Video playback is likely to be poor on systems slower than 1.25GHz; a G5 is recommended. Mac OS X 10.5.8 is supported.
Intel Macintoshes are not supported, but the G3 build is known to run under Rosetta in 10.4.11, 10.5.8 and 10.6.8. Because Apple no longer supports Rosetta and 10.4Fx is not a Universal binary, it will not run under Lion 10.7 or any future version of Mac OS X.
## Getting TenFourFox ##
Make sure you select the appropriate build for your Mac from the [download page](http://www.tenfourfox.com/). The G3 version will run on any supported Macintosh, but it will not take advantage of the additional features of G4 or G5 processors. The G4 and G5 versions will not run correctly if at all on a G3, and the G5 version will perform badly or crash on non-G5 Macintoshes.
If you are using a G4, you should try to choose the correct version for your processor generation (7400 or 7450 "G4e") as performance may be impaired if you run the wrong one. If you don't know which G4 processor you have, the instructions in WhichVersion will tell you how to find out.
## TenFourFox 10.0.x is equivalent to Firefox ESR 10.0.x ##
TenFourFox uses modified Firefox source code, rewritten to remain compatible with Mac OS X v10.4 and the Power Macintosh. It also contains specific optimizations and special features for PowerPC processors. For this reason, it is not exactly the same as Firefox. However, it is intended to be as compatible with it as possible, including most add-ons and [most standard features](TechnicalDifferences.md). You can treat 10.4Fx as equivalent with Firefox ESR 10.0 in most circumstances, with specific exceptions noted below.
Note that add-ons which require an Intel Macintosh will not work with TenFourFox, even if they are otherwise compatible with Firefox 10, and add-ons that require 10.5 Leopard may not be compatible with TenFourFox running on Mac OS X 10.4 Tiger, even if they are compatible with PowerPC.
## This branch of TenFourFox is the _stable_ version ##
Starting with Firefox 10, Mozilla is now offering an extended support release version of Firefox ("Firefox **ESR**") intended for environments where users are unable to use rapid-release versions of Firefox due to policy or technical constraints.
10.4Fx 10.x is based on this extended support release and is intended for users who wish to remain with a stable browser core. The stable branch will continue to receive bugfixes and security updates, but will not receive new Firefox features (although it may receive certain 10.4Fx-specific features judged important for our legacy users).
**We recommend this version for most of our users.** If you wish to help test our continuing porting efforts, you can try the _unstable_ branch, which is based on the current release of Firefox. _The unstable branch does have bugs and is recommended only for advanced users._ For more information, see the [TenFourFox Development](http://tenfourfox.blogspot.com/) blog.
## TenFourFox no longer supports plugins or Flash ##
Plugins on PowerPC are of special concern because Mozilla is making updates to their plugin architecture which may require the plugins themselves to be updated, and there are certain difficult-to-correct bugs with them already on Tiger. Most importantly, QuickTime and Adobe Flash for PowerPC are no longer maintained and have known security risks that can crash, perform malicious operations or leak data, and Flash 10.1 is rapidly becoming unsupported by many applications.
**As of TenFourFox 6.0, for these and other reasons (for details, see PluginsNoLongerSupported), plugin support ships disabled.** Plugins will not operate by default, and bug reports will no longer be accepted. Sites will now act as if no plugins were installed at all.
For Internet video, we now recommend the use of TenFourFox's optional QuickTimeEnabler. This allows many videos to be handled in QuickTime Player directly.
You can also download videos for separate viewing using [Perian](http://www.perian.org/) and any of the available video download add-ons for Firefox.
For YouTube, you may also be able to use [MacTubes](http://macapps.sakura.ne.jp/mactubes/index_en.html). If you have a high end G4 or G5, you can also use WebM for selected videos by visiting http://www.youtube.com/html5 and enabling HTML5 video. This will set a temporary cookie enabling browser-based video without Flash. You do not need a YouTube account for this feature, but you may need to periodically renew the cookie setting. Not all video is available in WebM.
For a more in-depth explanation of this policy and other workarounds, see PluginsNoLongerSupported.
## Known issues fixed in this version of TenFourFox ##
* Fixes four urgent security issues in Firefox (Mozilla bugs 793969, 801305, 802557 and 803583). All users are strongly advised to upgrade as soon as possible. This version also includes all additional ESR fixes to date.
## Known issues specific to TenFourFox ##
* Remember: **Plugins are turned off by default, and code for them will fail to function entirely in a subsequent version.** See PluginsNoLongerSupported for an explanation and suggested workarounds. Please note that out-of-process plugins have never been supported.
* As of TenFourFox 8, TenFourFox uses a lighter chrome for windows and dialogue boxes than prior versions or the official Mac Firefox. This is intentional.
* When 10.4Fx has no suggestions for the awesome bar, a blank box appears instead ([issue 21](https://code.google.com/p/tenfourfox/issues/detail?id=21)). This is intentional.
* 10.4Fx does not currently support WebGL, and scripts such as Indic or Arabic requiring glyph reordering or language-specific ligatures may not appear correctly. See TechnicalDifferences for the complete list of changes necessary for 10.4Fx. See [issue 5](https://code.google.com/p/tenfourfox/issues/detail?id=5) for notes specific to the font issue.
* Animation performance is currently poorer in Mozilla 2.0/Firefox 4.0 and later versions using software rendering, which includes 10.4Fx. The later graphics stack in the unstable release improves greatly upon this issue, and will become available in the near future on the stable branch.
* The titlebar does not always properly match the menu gradient ([issue 16](https://code.google.com/p/tenfourfox/issues/detail?id=16)). This problem is also in the official release. Installing a Persona may fix this issue if you find it bothersome.
* Crash reporting is intentionally disabled to avoid polluting Mozilla's crash tracking system with our reports. Please use your system's crash logs if you are reporting a _reproducible_ crash, or (if you are able) provide a `gdb` backtrace.
* Although 10.4Fx will tell you when an update is available, you must download updates manually at this time.
You are welcome to report other bugs that you find. However, please **do not report Mozilla bugs to us.** If the bug or crash occurs in both the official Mozilla Firefox 10 ESR _(3.6 doesn't count!)_ and in 10.4Fx, this is a Mozilla bug, and you should file it at [Bugzilla](http://bugzilla.mozilla.org/). **You must test your bug in both places -- bugs that are not confirmed to be part of 10.4Fx will be marked invalid** so that we can keep our task list focused. This is the [current list of known issues](http://code.google.com/p/tenfourfox/issues/list).

57
ReleaseNotes10011.md Normal file
View File

@ -0,0 +1,57 @@
_This document may be updated for late-breaking changes, so check back here if you are having difficulty._
## System requirements ##
TenFourFox (hereafter "10.4Fx") requires a G3 Power Macintosh, Mac OS X 10.4.11, 100MB of free disk space and 512MB of RAM. 1GB of RAM and a G4 or G5 processor is recommended. Video playback is likely to be poor on systems slower than 1.25GHz; a G5 is recommended. Mac OS X 10.5.8 is supported.
Intel Macintoshes are not supported, but the G3 build is known to run under Rosetta in 10.4.11, 10.5.8 and 10.6.8. Because Apple no longer supports Rosetta and 10.4Fx is not a Universal binary, it will not run under Lion 10.7 or any future version of Mac OS X.
## Getting TenFourFox ##
Make sure you select the appropriate build for your Mac from the [download page](http://www.tenfourfox.com/). The G3 version will run on any supported Macintosh, but it will not take advantage of the additional features of G4 or G5 processors. The G4 and G5 versions will not run correctly if at all on a G3, and the G5 version will perform badly or crash on non-G5 Macintoshes.
If you are using a G4, you should try to choose the correct version for your processor generation (7400 or 7450 "G4e") as performance may be impaired if you run the wrong one. If you don't know which G4 processor you have, the instructions in WhichVersion will tell you how to find out.
## TenFourFox 10.0.x is equivalent to Firefox ESR 10.0.x ##
TenFourFox uses modified Firefox source code, rewritten to remain compatible with Mac OS X v10.4 and the Power Macintosh. It also contains specific optimizations and special features for PowerPC processors. For this reason, it is not exactly the same as Firefox. However, it is intended to be as compatible with it as possible, including most add-ons and [most standard features](TechnicalDifferences.md). You can treat 10.4Fx as equivalent with Firefox ESR 10.0 in most circumstances, with specific exceptions noted below.
Note that add-ons which require an Intel Macintosh will not work with TenFourFox, even if they are otherwise compatible with Firefox 10, and add-ons that require 10.5 Leopard may not be compatible with TenFourFox running on Mac OS X 10.4 Tiger, even if they are compatible with PowerPC.
## This is the final release of TenFourFox 10 ##
Starting with Firefox 10, Mozilla is now offering an extended support release version of Firefox ("Firefox **ESR**") intended for environments where users are unable to use rapid-release versions of Firefox due to policy or technical constraints.
10.4Fx 10.x was based on this extended support release. The ESR has now moved to Firefox 17, and ESR 10 will be unsupported as of Firefox 19.
**TenFourFox will not produce any further versions of 10.0.x. This version is only for users who have add-ons or applications that are not yet compatible with TenFourFox 17. It will be unsupported in January 2013. You must upgrade to TenFourFox 17 to continue to receive security updates and bug fixes.**
## TenFourFox no longer supports plugins or Flash ##
Plugins on PowerPC are of special concern because Mozilla is making updates to their plugin architecture which may require the plugins themselves to be updated, and there are certain difficult-to-correct bugs with them already on Tiger. Most importantly, QuickTime and Adobe Flash for PowerPC are no longer maintained and have known security risks that can crash, perform malicious operations or leak data, and Flash 10.1 is rapidly becoming unsupported by many applications.
**As of TenFourFox 6.0, for these and other reasons (for details, see PluginsNoLongerSupported), plugin support ships disabled.** Plugins will not operate by default, and bug reports will no longer be accepted. Sites will now act as if no plugins were installed at all.
For Internet video, we now recommend the use of TenFourFox's optional QuickTimeEnabler. This allows many videos to be handled in QuickTime Player directly.
You can also download videos for separate viewing using [Perian](http://www.perian.org/) and any of the available video download add-ons for Firefox.
For YouTube, you may also be able to use [MacTubes](http://macapps.sakura.ne.jp/mactubes/index_en.html). If you have a high end G4 or G5, you can also use WebM for selected videos by visiting http://www.youtube.com/html5 and enabling HTML5 video. This will set a temporary cookie enabling browser-based video without Flash. You do not need a YouTube account for this feature, but you may need to periodically renew the cookie setting. Not all video is available in WebM.
For a more in-depth explanation of this policy and other workarounds, see PluginsNoLongerSupported.
## Known issues fixed in this version of TenFourFox ##
* All security and stability fixes from Firefox ESR 10.0.11.
* The updater correctly responds to the No Thanks button ([issue 130](https://code.google.com/p/tenfourfox/issues/detail?id=130)).
## Known issues specific to TenFourFox ##
* Remember: **Plugins are turned off by default, and code for them will fail to function entirely in TenFourFox 18.** See PluginsNoLongerSupported for an explanation and suggested workarounds. Please note that out-of-process plugins have never been supported.
* As of TenFourFox 8, TenFourFox uses a lighter chrome for windows and dialogue boxes than prior versions or the official Mac Firefox. This is intentional.
* When 10.4Fx has no suggestions for the awesome bar, a blank box appears instead ([issue 21](https://code.google.com/p/tenfourfox/issues/detail?id=21)). This is intentional.
* 10.4Fx does not currently support WebGL, and scripts such as Indic or Arabic requiring glyph reordering or language-specific ligatures may not appear correctly. See TechnicalDifferences for the complete list of changes necessary for 10.4Fx. See [issue 5](https://code.google.com/p/tenfourfox/issues/detail?id=5) for notes specific to the font issue.
* Animation performance is currently poorer in Mozilla 2.0/Firefox 4.0 and later versions using software rendering, which includes 10.4Fx. The later graphics stack in the unstable release improves greatly upon this issue, and will become available in the near future on the stable branch.
* The titlebar does not always properly match the menu gradient ([issue 16](https://code.google.com/p/tenfourfox/issues/detail?id=16)). This problem is also in the official release. Installing a Persona may fix this issue if you find it bothersome.
* Crash reporting is intentionally disabled to avoid polluting Mozilla's crash tracking system with our reports. Please use your system's crash logs if you are reporting a _reproducible_ crash, or (if you are able) provide a `gdb` backtrace.
* Although 10.4Fx will tell you when an update is available, you must download updates manually at this time.

61
ReleaseNotes1002.md Normal file
View File

@ -0,0 +1,61 @@
_This document may be updated for late-breaking changes, so check back here if you are having difficulty._
## System requirements ##
TenFourFox (hereafter "10.4Fx") requires a G3 Power Macintosh, Mac OS X 10.4.11, 100MB of free disk space and 512MB of RAM. 1GB of RAM and a G4 or G5 processor is recommended. Video playback is likely to be poor on systems slower than 1.25GHz; a G5 is recommended. Mac OS X 10.5.8 is supported.
Intel Macintoshes are not supported, but the G3 build is known to run under Rosetta in 10.4.11, 10.5.8 and 10.6.8. Because Apple no longer supports Rosetta and 10.4Fx is not a Universal binary, it will not run under Lion 10.7 or any future version of Mac OS X.
## Getting TenFourFox ##
Make sure you select the appropriate build for your Mac from the [download page](http://www.tenfourfox.com/). The G3 version will run on any supported Macintosh, but it will not take advantage of the additional features of G4 or G5 processors. The G4 and G5 versions will not run correctly on a G3, and the G5 version will perform worse on non-G5 Macintoshes.
If you are using a G4, you should try to choose the correct version for your processor generation (7400 or 7450 "G4e") as performance may be impaired if you run the wrong one. If you don't know which G4 processor you have, the instructions in WhichVersion will tell you how to find out.
## TenFourFox 10.0.x is equivalent to Firefox ESR 10.0.x ##
TenFourFox uses modified Firefox source code, rewritten to remain compatible with Mac OS X v10.4 and the Power Macintosh. It also contains specific optimizations and special features for PowerPC processors. For this reason, it is not exactly the same as Firefox. However, it is intended to be as compatible with it as possible, including most add-ons and [most standard features](TechnicalDifferences.md). You can treat 10.4Fx as equivalent with Firefox ESR 10.0 in most circumstances, with specific exceptions noted below.
Note that add-ons which require an Intel Macintosh will not work with TenFourFox, even if they are otherwise compatible with Firefox 10, and add-ons that require 10.5 Leopard may not be compatible with TenFourFox running on Mac OS X 10.4 Tiger, even if they are compatible with PowerPC.
## This branch of TenFourFox is the _stable_ version ##
Starting with Firefox 10, Mozilla is now offering an extended support release version of Firefox ("Firefox **ESR**") intended for environments where users are unable to use rapid-release versions of Firefox due to policy or technical constraints.
10.4Fx 10.x is based on this extended support release and is intended for users who wish to remain with a stable browser core. The stable branch will continue to receive bugfixes and security updates, but will not receive new Firefox features (although it may receive certain 10.4Fx-specific features judged important for our legacy users).
**We recommend this version for most of our users.** If you wish to help test our continuing porting efforts, you can try the _unstable_ branch, which is based on the current release of Firefox. _The unstable branch does have bugs and is recommended only for advanced users._ For more information, see the [TenFourFox Development](http://tenfourfox.blogspot.com/) blog.
## TenFourFox no longer supports plugins or Flash ##
Plugins on PowerPC are of special concern because Mozilla is making updates to their plugin architecture which may require the plugins themselves to be updated, and there are certain difficult-to-correct bugs with them already on Tiger. Most importantly, QuickTime and Adobe Flash for PowerPC are no longer maintained and have known security risks that can crash, perform malicious operations or leak data, and Flash 10.1 is rapidly becoming unsupported by many applications.
**As of TenFourFox 6.0, for these and other reasons (for details, see PluginsNoLongerSupported), plugin support ships disabled.** Plugins will not operate by default, and bug reports will no longer be accepted. Sites will now act as if no plugins were installed at all.
For Internet video, we strongly recommend the use of [Perian](http://www.perian.org/) and any of the available video download add-ons for Firefox.
For YouTube, we recommend [MacTubes](http://macapps.web.infoseek.co.jp/mactubes/index_en.html). If you have a high end G4 or G5, you can also use WebM for selected videos by visiting http://www.youtube.com/html5 and enabling HTML5 video. This will set a temporary cookie enabling browser-based video without Flash. You do not need a YouTube account for this feature, but you may need to periodically renew the cookie setting. Not all video is available in WebM.
For a more in-depth explanation of this policy and other workarounds, see PluginsNoLongerSupported.
## New features in this version of TenFourFox ##
* Speed improvements to the JavaScript methodjit ([issue 118](https://code.google.com/p/tenfourfox/issues/detail?id=118)) on all four architectures, with specific code for the G5 processor.
* Software square root for G3 and G4 processors ([issue 96](https://code.google.com/p/tenfourfox/issues/detail?id=96)), improving performance with certain math-heavy operations.
## Known issues fixed in this version of TenFourFox ##
* This release fixes a high-priority Mozilla security issue (Mozilla [bug 727401](https://code.google.com/p/tenfourfox/issues/detail?id=27401)). This issue affects all previous versions of TenFourFox as well as Firefox 3.6.
## Known issues specific to TenFourFox ##
* Remember: **Plugins are turned off by default, and code for them will fail to function entirely in a subsequent version.** See PluginsNoLongerSupported for an explanation and suggested workarounds. Please note that out-of-process plugins have never been supported.
* As of TenFourFox 8, TenFourFox uses a lighter chrome for windows and dialogue boxes than prior versions or the official Mac Firefox. This is intentional.
* When 10.4Fx has no suggestions for the awesome bar, a blank box appears instead ([issue 21](https://code.google.com/p/tenfourfox/issues/detail?id=21)). This is intentional.
* 10.4Fx does not currently support WebGL, and Indic, Arabic and other scripts requiring glyph reordering or language-specific ligatures may not appear correctly. See TechnicalDifferences for the complete list of changes necessary for 10.4Fx. See [issue 5](https://code.google.com/p/tenfourfox/issues/detail?id=5) for notes specific to the font issue.
* Animation performance is currently poorer in Mozilla 2.0/Firefox 4.0 and later versions using software rendering, which includes 10.4Fx. Mozilla acknowledges this bug, but there is not yet an ETR. See [issue 7](https://code.google.com/p/tenfourfox/issues/detail?id=7).
* The titlebar does not always properly match the menu gradient ([issue 16](https://code.google.com/p/tenfourfox/issues/detail?id=16)). This problem is also in the official release. Installing a Persona may fix this issue if you find it bothersome.
* Crash reporting is intentionally disabled to avoid polluting Mozilla's crash tracking system with our reports. Please use your system's crash logs if you are reporting a _reproducible_ crash, or (if you are able) provide a `gdb` backtrace.
* Although 10.4Fx will tell you when an update is available, you must download updates manually at this time.
You are welcome to report other bugs that you find. However, please **do not report Mozilla bugs to us.** If the bug or crash occurs in both the official Mozilla Firefox 10 _(3.6 doesn't count!)_ and in 10.4Fx, this is a Mozilla bug, and you should file it at [Bugzilla](http://bugzilla.mozilla.org/). **You must test your bug in both places -- bugs that are not confirmed to be part of 10.4Fx will be marked invalid** so that we can keep our task list focused. This is the [current list of known issues](http://code.google.com/p/tenfourfox/issues/list).

61
ReleaseNotes1003.md Normal file
View File

@ -0,0 +1,61 @@
_This document may be updated for late-breaking changes, so check back here if you are having difficulty._
## System requirements ##
TenFourFox (hereafter "10.4Fx") requires a G3 Power Macintosh, Mac OS X 10.4.11, 100MB of free disk space and 512MB of RAM. 1GB of RAM and a G4 or G5 processor is recommended. Video playback is likely to be poor on systems slower than 1.25GHz; a G5 is recommended. Mac OS X 10.5.8 is supported.
Intel Macintoshes are not supported, but the G3 build is known to run under Rosetta in 10.4.11, 10.5.8 and 10.6.8. Because Apple no longer supports Rosetta and 10.4Fx is not a Universal binary, it will not run under Lion 10.7 or any future version of Mac OS X.
## Getting TenFourFox ##
Make sure you select the appropriate build for your Mac from the [download page](http://www.tenfourfox.com/). The G3 version will run on any supported Macintosh, but it will not take advantage of the additional features of G4 or G5 processors. The G4 and G5 versions will not run correctly on a G3, and the G5 version will perform worse on non-G5 Macintoshes.
If you are using a G4, you should try to choose the correct version for your processor generation (7400 or 7450 "G4e") as performance may be impaired if you run the wrong one. If you don't know which G4 processor you have, the instructions in WhichVersion will tell you how to find out.
## TenFourFox 10.0.x is equivalent to Firefox ESR 10.0.x ##
TenFourFox uses modified Firefox source code, rewritten to remain compatible with Mac OS X v10.4 and the Power Macintosh. It also contains specific optimizations and special features for PowerPC processors. For this reason, it is not exactly the same as Firefox. However, it is intended to be as compatible with it as possible, including most add-ons and [most standard features](TechnicalDifferences.md). You can treat 10.4Fx as equivalent with Firefox ESR 10.0 in most circumstances, with specific exceptions noted below.
Note that add-ons which require an Intel Macintosh will not work with TenFourFox, even if they are otherwise compatible with Firefox 10, and add-ons that require 10.5 Leopard may not be compatible with TenFourFox running on Mac OS X 10.4 Tiger, even if they are compatible with PowerPC.
## This branch of TenFourFox is the _stable_ version ##
Starting with Firefox 10, Mozilla is now offering an extended support release version of Firefox ("Firefox **ESR**") intended for environments where users are unable to use rapid-release versions of Firefox due to policy or technical constraints.
10.4Fx 10.x is based on this extended support release and is intended for users who wish to remain with a stable browser core. The stable branch will continue to receive bugfixes and security updates, but will not receive new Firefox features (although it may receive certain 10.4Fx-specific features judged important for our legacy users).
**We recommend this version for most of our users.** If you wish to help test our continuing porting efforts, you can try the _unstable_ branch, which is based on the current release of Firefox. _The unstable branch does have bugs and is recommended only for advanced users._ For more information, see the [TenFourFox Development](http://tenfourfox.blogspot.com/) blog.
## TenFourFox no longer supports plugins or Flash ##
Plugins on PowerPC are of special concern because Mozilla is making updates to their plugin architecture which may require the plugins themselves to be updated, and there are certain difficult-to-correct bugs with them already on Tiger. Most importantly, QuickTime and Adobe Flash for PowerPC are no longer maintained and have known security risks that can crash, perform malicious operations or leak data, and Flash 10.1 is rapidly becoming unsupported by many applications.
**As of TenFourFox 6.0, for these and other reasons (for details, see PluginsNoLongerSupported), plugin support ships disabled.** Plugins will not operate by default, and bug reports will no longer be accepted. Sites will now act as if no plugins were installed at all.
For Internet video, we strongly recommend the use of [Perian](http://www.perian.org/) and any of the available video download add-ons for Firefox.
For YouTube, we recommend [MacTubes](http://macapps.web.infoseek.co.jp/mactubes/index_en.html). If you have a high end G4 or G5, you can also use WebM for selected videos by visiting http://www.youtube.com/html5 and enabling HTML5 video. This will set a temporary cookie enabling browser-based video without Flash. You do not need a YouTube account for this feature, but you may need to periodically renew the cookie setting. Not all video is available in WebM.
For a more in-depth explanation of this policy and other workarounds, see PluginsNoLongerSupported.
## New features in this version of TenFourFox ##
* WebM video decoding now scales to the proper number of available processors ([issue 133](https://code.google.com/p/tenfourfox/issues/detail?id=133)).
## Known issues fixed in this version of TenFourFox ##
* Completely black images now render properly instead of occasionally being transparent (Mozilla [bug 720035](https://code.google.com/p/tenfourfox/issues/detail?id=20035), [issue 132](https://code.google.com/p/tenfourfox/issues/detail?id=132)). This bug was introduced in Firefox 7.
* The Collusion extension, as well as other JavaScript code dependent on square root, now works properly on G3 and G4 systems ([issue 134](https://code.google.com/p/tenfourfox/issues/detail?id=134)) by replacing the software square root with the slower library routine. This bug was introduced in 10.0.2.
## Known issues specific to TenFourFox ##
* Remember: **Plugins are turned off by default, and code for them will fail to function entirely in a subsequent version.** See PluginsNoLongerSupported for an explanation and suggested workarounds. Please note that out-of-process plugins have never been supported.
* As of TenFourFox 8, TenFourFox uses a lighter chrome for windows and dialogue boxes than prior versions or the official Mac Firefox. This is intentional.
* When 10.4Fx has no suggestions for the awesome bar, a blank box appears instead ([issue 21](https://code.google.com/p/tenfourfox/issues/detail?id=21)). This is intentional.
* 10.4Fx does not currently support WebGL, and Indic, Arabic and other scripts requiring glyph reordering or language-specific ligatures may not appear correctly. See TechnicalDifferences for the complete list of changes necessary for 10.4Fx. See [issue 5](https://code.google.com/p/tenfourfox/issues/detail?id=5) for notes specific to the font issue.
* Animation performance is currently poorer in Mozilla 2.0/Firefox 4.0 and later versions using software rendering, which includes 10.4Fx. Mozilla acknowledges this bug, but there is not yet an ETR. See [issue 7](https://code.google.com/p/tenfourfox/issues/detail?id=7).
* The titlebar does not always properly match the menu gradient ([issue 16](https://code.google.com/p/tenfourfox/issues/detail?id=16)). This problem is also in the official release. Installing a Persona may fix this issue if you find it bothersome.
* Crash reporting is intentionally disabled to avoid polluting Mozilla's crash tracking system with our reports. Please use your system's crash logs if you are reporting a _reproducible_ crash, or (if you are able) provide a `gdb` backtrace.
* Although 10.4Fx will tell you when an update is available, you must download updates manually at this time.
You are welcome to report other bugs that you find. However, please **do not report Mozilla bugs to us.** If the bug or crash occurs in both the official Mozilla Firefox 10 _(3.6 doesn't count!)_ and in 10.4Fx, this is a Mozilla bug, and you should file it at [Bugzilla](http://bugzilla.mozilla.org/). **You must test your bug in both places -- bugs that are not confirmed to be part of 10.4Fx will be marked invalid** so that we can keep our task list focused. This is the [current list of known issues](http://code.google.com/p/tenfourfox/issues/list).

58
ReleaseNotes1004.md Normal file
View File

@ -0,0 +1,58 @@
_This document may be updated for late-breaking changes, so check back here if you are having difficulty._
## System requirements ##
TenFourFox (hereafter "10.4Fx") requires a G3 Power Macintosh, Mac OS X 10.4.11, 100MB of free disk space and 512MB of RAM. 1GB of RAM and a G4 or G5 processor is recommended. Video playback is likely to be poor on systems slower than 1.25GHz; a G5 is recommended. Mac OS X 10.5.8 is supported.
Intel Macintoshes are not supported, but the G3 build is known to run under Rosetta in 10.4.11, 10.5.8 and 10.6.8. Because Apple no longer supports Rosetta and 10.4Fx is not a Universal binary, it will not run under Lion 10.7 or any future version of Mac OS X.
## Getting TenFourFox ##
Make sure you select the appropriate build for your Mac from the [download page](http://www.tenfourfox.com/). The G3 version will run on any supported Macintosh, but it will not take advantage of the additional features of G4 or G5 processors. The G4 and G5 versions will not run correctly on a G3, and the G5 version will perform worse on non-G5 Macintoshes.
If you are using a G4, you should try to choose the correct version for your processor generation (7400 or 7450 "G4e") as performance may be impaired if you run the wrong one. If you don't know which G4 processor you have, the instructions in WhichVersion will tell you how to find out.
## TenFourFox 10.0.x is equivalent to Firefox ESR 10.0.x ##
TenFourFox uses modified Firefox source code, rewritten to remain compatible with Mac OS X v10.4 and the Power Macintosh. It also contains specific optimizations and special features for PowerPC processors. For this reason, it is not exactly the same as Firefox. However, it is intended to be as compatible with it as possible, including most add-ons and [most standard features](TechnicalDifferences.md). You can treat 10.4Fx as equivalent with Firefox ESR 10.0 in most circumstances, with specific exceptions noted below.
Note that add-ons which require an Intel Macintosh will not work with TenFourFox, even if they are otherwise compatible with Firefox 10, and add-ons that require 10.5 Leopard may not be compatible with TenFourFox running on Mac OS X 10.4 Tiger, even if they are compatible with PowerPC.
## This branch of TenFourFox is the _stable_ version ##
Starting with Firefox 10, Mozilla is now offering an extended support release version of Firefox ("Firefox **ESR**") intended for environments where users are unable to use rapid-release versions of Firefox due to policy or technical constraints.
10.4Fx 10.x is based on this extended support release and is intended for users who wish to remain with a stable browser core. The stable branch will continue to receive bugfixes and security updates, but will not receive new Firefox features (although it may receive certain 10.4Fx-specific features judged important for our legacy users).
**We recommend this version for most of our users.** If you wish to help test our continuing porting efforts, you can try the _unstable_ branch, which is based on the current release of Firefox. _The unstable branch does have bugs and is recommended only for advanced users._ For more information, see the [TenFourFox Development](http://tenfourfox.blogspot.com/) blog.
## TenFourFox no longer supports plugins or Flash ##
Plugins on PowerPC are of special concern because Mozilla is making updates to their plugin architecture which may require the plugins themselves to be updated, and there are certain difficult-to-correct bugs with them already on Tiger. Most importantly, QuickTime and Adobe Flash for PowerPC are no longer maintained and have known security risks that can crash, perform malicious operations or leak data, and Flash 10.1 is rapidly becoming unsupported by many applications.
**As of TenFourFox 6.0, for these and other reasons (for details, see PluginsNoLongerSupported), plugin support ships disabled.** Plugins will not operate by default, and bug reports will no longer be accepted. Sites will now act as if no plugins were installed at all.
For Internet video, we strongly recommend the use of [Perian](http://www.perian.org/) and any of the available video download add-ons for Firefox.
For YouTube, we recommend [MacTubes](http://macapps.web.infoseek.co.jp/mactubes/index_en.html). If you have a high end G4 or G5, you can also use WebM for selected videos by visiting http://www.youtube.com/html5 and enabling HTML5 video. This will set a temporary cookie enabling browser-based video without Flash. You do not need a YouTube account for this feature, but you may need to periodically renew the cookie setting. Not all video is available in WebM.
For a more in-depth explanation of this policy and other workarounds, see PluginsNoLongerSupported.
## Known issues fixed in this version of TenFourFox ##
* All security and stability fixes from Firefox ESR 10.0.4.
* Java is now specifically blocked using a lower-level method ([issue 141](https://code.google.com/p/tenfourfox/issues/detail?id=141)) due to the Flashback trojan package. **Java has not been supported on TenFourFox since version 5. No version of 10.4 or 10.5 can be updated to a secure browser JVM.**
* Because the Mozilla blocklist can affect system components that cannot be upgraded, it is now disabled in 10.4Fx ([issue 142](https://code.google.com/p/tenfourfox/issues/detail?id=142)).
## Known issues specific to TenFourFox ##
* Remember: **Plugins are turned off by default, and code for them will fail to function entirely in a subsequent version.** See PluginsNoLongerSupported for an explanation and suggested workarounds. Please note that out-of-process plugins have never been supported.
* As of TenFourFox 8, TenFourFox uses a lighter chrome for windows and dialogue boxes than prior versions or the official Mac Firefox. This is intentional.
* When 10.4Fx has no suggestions for the awesome bar, a blank box appears instead ([issue 21](https://code.google.com/p/tenfourfox/issues/detail?id=21)). This is intentional.
* 10.4Fx does not currently support WebGL, and Indic, Arabic and other scripts requiring glyph reordering or language-specific ligatures may not appear correctly. See TechnicalDifferences for the complete list of changes necessary for 10.4Fx. See [issue 5](https://code.google.com/p/tenfourfox/issues/detail?id=5) for notes specific to the font issue.
* Animation performance is currently poorer in Mozilla 2.0/Firefox 4.0 and later versions using software rendering, which includes 10.4Fx. The later graphics stack in the unstable release improves greatly upon this issue, and will become available in the near future on the stable branch.
* The titlebar does not always properly match the menu gradient ([issue 16](https://code.google.com/p/tenfourfox/issues/detail?id=16)). This problem is also in the official release. Installing a Persona may fix this issue if you find it bothersome.
* Crash reporting is intentionally disabled to avoid polluting Mozilla's crash tracking system with our reports. Please use your system's crash logs if you are reporting a _reproducible_ crash, or (if you are able) provide a `gdb` backtrace.
* Although 10.4Fx will tell you when an update is available, you must download updates manually at this time.
You are welcome to report other bugs that you find. However, please **do not report Mozilla bugs to us.** If the bug or crash occurs in both the official Mozilla Firefox 10 _(3.6 doesn't count!)_ and in 10.4Fx, this is a Mozilla bug, and you should file it at [Bugzilla](http://bugzilla.mozilla.org/). **You must test your bug in both places -- bugs that are not confirmed to be part of 10.4Fx will be marked invalid** so that we can keep our task list focused. This is the [current list of known issues](http://code.google.com/p/tenfourfox/issues/list).

60
ReleaseNotes1005.md Normal file
View File

@ -0,0 +1,60 @@
_This document may be updated for late-breaking changes, so check back here if you are having difficulty._
## System requirements ##
TenFourFox (hereafter "10.4Fx") requires a G3 Power Macintosh, Mac OS X 10.4.11, 100MB of free disk space and 512MB of RAM. 1GB of RAM and a G4 or G5 processor is recommended. Video playback is likely to be poor on systems slower than 1.25GHz; a G5 is recommended. Mac OS X 10.5.8 is supported.
Intel Macintoshes are not supported, but the G3 build is known to run under Rosetta in 10.4.11, 10.5.8 and 10.6.8. Because Apple no longer supports Rosetta and 10.4Fx is not a Universal binary, it will not run under Lion 10.7 or any future version of Mac OS X.
## Getting TenFourFox ##
Make sure you select the appropriate build for your Mac from the [download page](http://www.tenfourfox.com/). The G3 version will run on any supported Macintosh, but it will not take advantage of the additional features of G4 or G5 processors. The G4 and G5 versions will not run correctly if at all on a G3, and the G5 version will perform badly or crash on non-G5 Macintoshes.
If you are using a G4, you should try to choose the correct version for your processor generation (7400 or 7450 "G4e") as performance may be impaired if you run the wrong one. If you don't know which G4 processor you have, the instructions in WhichVersion will tell you how to find out.
## TenFourFox 10.0.x is equivalent to Firefox ESR 10.0.x ##
TenFourFox uses modified Firefox source code, rewritten to remain compatible with Mac OS X v10.4 and the Power Macintosh. It also contains specific optimizations and special features for PowerPC processors. For this reason, it is not exactly the same as Firefox. However, it is intended to be as compatible with it as possible, including most add-ons and [most standard features](TechnicalDifferences.md). You can treat 10.4Fx as equivalent with Firefox ESR 10.0 in most circumstances, with specific exceptions noted below.
Note that add-ons which require an Intel Macintosh will not work with TenFourFox, even if they are otherwise compatible with Firefox 10, and add-ons that require 10.5 Leopard may not be compatible with TenFourFox running on Mac OS X 10.4 Tiger, even if they are compatible with PowerPC.
## This branch of TenFourFox is the _stable_ version ##
Starting with Firefox 10, Mozilla is now offering an extended support release version of Firefox ("Firefox **ESR**") intended for environments where users are unable to use rapid-release versions of Firefox due to policy or technical constraints.
10.4Fx 10.x is based on this extended support release and is intended for users who wish to remain with a stable browser core. The stable branch will continue to receive bugfixes and security updates, but will not receive new Firefox features (although it may receive certain 10.4Fx-specific features judged important for our legacy users).
**We recommend this version for most of our users.** If you wish to help test our continuing porting efforts, you can try the _unstable_ branch, which is based on the current release of Firefox. _The unstable branch does have bugs and is recommended only for advanced users._ For more information, see the [TenFourFox Development](http://tenfourfox.blogspot.com/) blog.
## TenFourFox no longer supports plugins or Flash ##
Plugins on PowerPC are of special concern because Mozilla is making updates to their plugin architecture which may require the plugins themselves to be updated, and there are certain difficult-to-correct bugs with them already on Tiger. Most importantly, QuickTime and Adobe Flash for PowerPC are no longer maintained and have known security risks that can crash, perform malicious operations or leak data, and Flash 10.1 is rapidly becoming unsupported by many applications.
**As of TenFourFox 6.0, for these and other reasons (for details, see PluginsNoLongerSupported), plugin support ships disabled.** Plugins will not operate by default, and bug reports will no longer be accepted. Sites will now act as if no plugins were installed at all.
For Internet video, we strongly recommend the use of [Perian](http://www.perian.org/) and any of the available video download add-ons for Firefox.
For YouTube, we recommend [MacTubes](http://macapps.sakura.ne.jp/mactubes/index_en.html). If you have a high end G4 or G5, you can also use WebM for selected videos by visiting http://www.youtube.com/html5 and enabling HTML5 video. This will set a temporary cookie enabling browser-based video without Flash. You do not need a YouTube account for this feature, but you may need to periodically renew the cookie setting. Not all video is available in WebM.
For a more in-depth explanation of this policy and other workarounds, see PluginsNoLongerSupported.
## New features in this version of TenFourFox ##
* Official language packs for German, French and Polish are now available. These are offered as installers and will work for 10.0.3 or any later version of 10.4Fx 10.x. After downloading TenFourFox, unzip the language pack available from the Downloads section and run the installer. Do not use these installers with unstable releases; they will not work and/or may corrupt the browser. For more information, see [issue 42](https://code.google.com/p/tenfourfox/issues/detail?id=42) and [issue 61](https://code.google.com/p/tenfourfox/issues/detail?id=61).
## Known issues fixed in this version of TenFourFox ##
* All security and stability fixes from Firefox ESR 10.0.5.
## Known issues specific to TenFourFox ##
* Remember: **Plugins are turned off by default, and code for them will fail to function entirely in a subsequent version.** See PluginsNoLongerSupported for an explanation and suggested workarounds. Please note that out-of-process plugins have never been supported.
* As of TenFourFox 8, TenFourFox uses a lighter chrome for windows and dialogue boxes than prior versions or the official Mac Firefox. This is intentional.
* When 10.4Fx has no suggestions for the awesome bar, a blank box appears instead ([issue 21](https://code.google.com/p/tenfourfox/issues/detail?id=21)). This is intentional.
* 10.4Fx does not currently support WebGL, and scripts such as Indic or Arabic requiring glyph reordering or language-specific ligatures may not appear correctly. See TechnicalDifferences for the complete list of changes necessary for 10.4Fx. See [issue 5](https://code.google.com/p/tenfourfox/issues/detail?id=5) for notes specific to the font issue.
* Animation performance is currently poorer in Mozilla 2.0/Firefox 4.0 and later versions using software rendering, which includes 10.4Fx. The later graphics stack in the unstable release improves greatly upon this issue, and will become available in the near future on the stable branch.
* The titlebar does not always properly match the menu gradient ([issue 16](https://code.google.com/p/tenfourfox/issues/detail?id=16)). This problem is also in the official release. Installing a Persona may fix this issue if you find it bothersome.
* Crash reporting is intentionally disabled to avoid polluting Mozilla's crash tracking system with our reports. Please use your system's crash logs if you are reporting a _reproducible_ crash, or (if you are able) provide a `gdb` backtrace.
* Although 10.4Fx will tell you when an update is available, you must download updates manually at this time.
You are welcome to report other bugs that you find. However, please **do not report Mozilla bugs to us.** If the bug or crash occurs in both the official Mozilla Firefox 10 ESR _(3.6 doesn't count!)_ and in 10.4Fx, this is a Mozilla bug, and you should file it at [Bugzilla](http://bugzilla.mozilla.org/). **You must test your bug in both places -- bugs that are not confirmed to be part of 10.4Fx will be marked invalid** so that we can keep our task list focused. This is the [current list of known issues](http://code.google.com/p/tenfourfox/issues/list).

64
ReleaseNotes1006.md Normal file
View File

@ -0,0 +1,64 @@
_This document may be updated for late-breaking changes, so check back here if you are having difficulty._
## System requirements ##
TenFourFox (hereafter "10.4Fx") requires a G3 Power Macintosh, Mac OS X 10.4.11, 100MB of free disk space and 512MB of RAM. 1GB of RAM and a G4 or G5 processor is recommended. Video playback is likely to be poor on systems slower than 1.25GHz; a G5 is recommended. Mac OS X 10.5.8 is supported.
Intel Macintoshes are not supported, but the G3 build is known to run under Rosetta in 10.4.11, 10.5.8 and 10.6.8. Because Apple no longer supports Rosetta and 10.4Fx is not a Universal binary, it will not run under Lion 10.7 or any future version of Mac OS X.
## Getting TenFourFox ##
Make sure you select the appropriate build for your Mac from the [download page](http://www.tenfourfox.com/). The G3 version will run on any supported Macintosh, but it will not take advantage of the additional features of G4 or G5 processors. The G4 and G5 versions will not run correctly if at all on a G3, and the G5 version will perform badly or crash on non-G5 Macintoshes.
If you are using a G4, you should try to choose the correct version for your processor generation (7400 or 7450 "G4e") as performance may be impaired if you run the wrong one. If you don't know which G4 processor you have, the instructions in WhichVersion will tell you how to find out.
## TenFourFox 10.0.x is equivalent to Firefox ESR 10.0.x ##
TenFourFox uses modified Firefox source code, rewritten to remain compatible with Mac OS X v10.4 and the Power Macintosh. It also contains specific optimizations and special features for PowerPC processors. For this reason, it is not exactly the same as Firefox. However, it is intended to be as compatible with it as possible, including most add-ons and [most standard features](TechnicalDifferences.md). You can treat 10.4Fx as equivalent with Firefox ESR 10.0 in most circumstances, with specific exceptions noted below.
Note that add-ons which require an Intel Macintosh will not work with TenFourFox, even if they are otherwise compatible with Firefox 10, and add-ons that require 10.5 Leopard may not be compatible with TenFourFox running on Mac OS X 10.4 Tiger, even if they are compatible with PowerPC.
## This branch of TenFourFox is the _stable_ version ##
Starting with Firefox 10, Mozilla is now offering an extended support release version of Firefox ("Firefox **ESR**") intended for environments where users are unable to use rapid-release versions of Firefox due to policy or technical constraints.
10.4Fx 10.x is based on this extended support release and is intended for users who wish to remain with a stable browser core. The stable branch will continue to receive bugfixes and security updates, but will not receive new Firefox features (although it may receive certain 10.4Fx-specific features judged important for our legacy users).
**We recommend this version for most of our users.** If you wish to help test our continuing porting efforts, you can try the _unstable_ branch, which is based on the current release of Firefox. _The unstable branch does have bugs and is recommended only for advanced users._ For more information, see the [TenFourFox Development](http://tenfourfox.blogspot.com/) blog.
## TenFourFox no longer supports plugins or Flash ##
Plugins on PowerPC are of special concern because Mozilla is making updates to their plugin architecture which may require the plugins themselves to be updated, and there are certain difficult-to-correct bugs with them already on Tiger. Most importantly, QuickTime and Adobe Flash for PowerPC are no longer maintained and have known security risks that can crash, perform malicious operations or leak data, and Flash 10.1 is rapidly becoming unsupported by many applications.
**As of TenFourFox 6.0, for these and other reasons (for details, see PluginsNoLongerSupported), plugin support ships disabled.** Plugins will not operate by default, and bug reports will no longer be accepted. Sites will now act as if no plugins were installed at all.
For Internet video, we now recommend the use of TenFourFox's optional QuickTimeEnabler. This allows many videos to be handled in QuickTime Player directly.
You can also download videos for separate viewing using [Perian](http://www.perian.org/) and any of the available video download add-ons for Firefox.
For YouTube, you may also be able to use [MacTubes](http://macapps.sakura.ne.jp/mactubes/index_en.html). If you have a high end G4 or G5, you can also use WebM for selected videos by visiting http://www.youtube.com/html5 and enabling HTML5 video. This will set a temporary cookie enabling browser-based video without Flash. You do not need a YouTube account for this feature, but you may need to periodically renew the cookie setting. Not all video is available in WebM.
For a more in-depth explanation of this policy and other workarounds, see PluginsNoLongerSupported.
## Known issues fixed in this version of TenFourFox ##
* All security and stability fixes from Firefox ESR 10.0.6.
* Latency in the JavaScript JIT has been reduced ([issue 160](https://code.google.com/p/tenfourfox/issues/detail?id=160)). This was previously made available as a 10.0.5 test version.
* A potential crash in the JavaScript JIT has been protected against ([issue 165](https://code.google.com/p/tenfourfox/issues/detail?id=165)).
## Removed in this version of TenFourFox ##
* Due to a conflict with an important security update, the TraceMonkey alternate JIT is now permanently disabled. Please note: TenFourFox has not enabled TraceMonkey by default since 9.0 and uses the JaegerMonkey JavaScript JIT with type inference instead. **Most users will not be affected.** Enabling TraceMonkey will no longer have any effect.
## Known issues specific to TenFourFox ##
* Remember: **Plugins are turned off by default, and code for them will fail to function entirely in a subsequent version.** See PluginsNoLongerSupported for an explanation and suggested workarounds. Please note that out-of-process plugins have never been supported.
* As of TenFourFox 8, TenFourFox uses a lighter chrome for windows and dialogue boxes than prior versions or the official Mac Firefox. This is intentional.
* When 10.4Fx has no suggestions for the awesome bar, a blank box appears instead ([issue 21](https://code.google.com/p/tenfourfox/issues/detail?id=21)). This is intentional.
* 10.4Fx does not currently support WebGL, and scripts such as Indic or Arabic requiring glyph reordering or language-specific ligatures may not appear correctly. See TechnicalDifferences for the complete list of changes necessary for 10.4Fx. See [issue 5](https://code.google.com/p/tenfourfox/issues/detail?id=5) for notes specific to the font issue.
* Animation performance is currently poorer in Mozilla 2.0/Firefox 4.0 and later versions using software rendering, which includes 10.4Fx. The later graphics stack in the unstable release improves greatly upon this issue, and will become available in the near future on the stable branch.
* The titlebar does not always properly match the menu gradient ([issue 16](https://code.google.com/p/tenfourfox/issues/detail?id=16)). This problem is also in the official release. Installing a Persona may fix this issue if you find it bothersome.
* Crash reporting is intentionally disabled to avoid polluting Mozilla's crash tracking system with our reports. Please use your system's crash logs if you are reporting a _reproducible_ crash, or (if you are able) provide a `gdb` backtrace.
* Although 10.4Fx will tell you when an update is available, you must download updates manually at this time.
You are welcome to report other bugs that you find. However, please **do not report Mozilla bugs to us.** If the bug or crash occurs in both the official Mozilla Firefox 10 ESR _(3.6 doesn't count!)_ and in 10.4Fx, this is a Mozilla bug, and you should file it at [Bugzilla](http://bugzilla.mozilla.org/). **You must test your bug in both places -- bugs that are not confirmed to be part of 10.4Fx will be marked invalid** so that we can keep our task list focused. This is the [current list of known issues](http://code.google.com/p/tenfourfox/issues/list).

58
ReleaseNotes1007.md Normal file
View File

@ -0,0 +1,58 @@
_This document may be updated for late-breaking changes, so check back here if you are having difficulty._
## System requirements ##
TenFourFox (hereafter "10.4Fx") requires a G3 Power Macintosh, Mac OS X 10.4.11, 100MB of free disk space and 512MB of RAM. 1GB of RAM and a G4 or G5 processor is recommended. Video playback is likely to be poor on systems slower than 1.25GHz; a G5 is recommended. Mac OS X 10.5.8 is supported.
Intel Macintoshes are not supported, but the G3 build is known to run under Rosetta in 10.4.11, 10.5.8 and 10.6.8. Because Apple no longer supports Rosetta and 10.4Fx is not a Universal binary, it will not run under Lion 10.7 or any future version of Mac OS X.
## Getting TenFourFox ##
Make sure you select the appropriate build for your Mac from the [download page](http://www.tenfourfox.com/). The G3 version will run on any supported Macintosh, but it will not take advantage of the additional features of G4 or G5 processors. The G4 and G5 versions will not run correctly if at all on a G3, and the G5 version will perform badly or crash on non-G5 Macintoshes.
If you are using a G4, you should try to choose the correct version for your processor generation (7400 or 7450 "G4e") as performance may be impaired if you run the wrong one. If you don't know which G4 processor you have, the instructions in WhichVersion will tell you how to find out.
## TenFourFox 10.0.x is equivalent to Firefox ESR 10.0.x ##
TenFourFox uses modified Firefox source code, rewritten to remain compatible with Mac OS X v10.4 and the Power Macintosh. It also contains specific optimizations and special features for PowerPC processors. For this reason, it is not exactly the same as Firefox. However, it is intended to be as compatible with it as possible, including most add-ons and [most standard features](TechnicalDifferences.md). You can treat 10.4Fx as equivalent with Firefox ESR 10.0 in most circumstances, with specific exceptions noted below.
Note that add-ons which require an Intel Macintosh will not work with TenFourFox, even if they are otherwise compatible with Firefox 10, and add-ons that require 10.5 Leopard may not be compatible with TenFourFox running on Mac OS X 10.4 Tiger, even if they are compatible with PowerPC.
## This branch of TenFourFox is the _stable_ version ##
Starting with Firefox 10, Mozilla is now offering an extended support release version of Firefox ("Firefox **ESR**") intended for environments where users are unable to use rapid-release versions of Firefox due to policy or technical constraints.
10.4Fx 10.x is based on this extended support release and is intended for users who wish to remain with a stable browser core. The stable branch will continue to receive bugfixes and security updates, but will not receive new Firefox features (although it may receive certain 10.4Fx-specific features judged important for our legacy users).
**We recommend this version for most of our users.** If you wish to help test our continuing porting efforts, you can try the _unstable_ branch, which is based on the current release of Firefox. _The unstable branch does have bugs and is recommended only for advanced users._ For more information, see the [TenFourFox Development](http://tenfourfox.blogspot.com/) blog.
## TenFourFox no longer supports plugins or Flash ##
Plugins on PowerPC are of special concern because Mozilla is making updates to their plugin architecture which may require the plugins themselves to be updated, and there are certain difficult-to-correct bugs with them already on Tiger. Most importantly, QuickTime and Adobe Flash for PowerPC are no longer maintained and have known security risks that can crash, perform malicious operations or leak data, and Flash 10.1 is rapidly becoming unsupported by many applications.
**As of TenFourFox 6.0, for these and other reasons (for details, see PluginsNoLongerSupported), plugin support ships disabled.** Plugins will not operate by default, and bug reports will no longer be accepted. Sites will now act as if no plugins were installed at all.
For Internet video, we now recommend the use of TenFourFox's optional QuickTimeEnabler. This allows many videos to be handled in QuickTime Player directly.
You can also download videos for separate viewing using [Perian](http://www.perian.org/) and any of the available video download add-ons for Firefox.
For YouTube, you may also be able to use [MacTubes](http://macapps.sakura.ne.jp/mactubes/index_en.html). If you have a high end G4 or G5, you can also use WebM for selected videos by visiting http://www.youtube.com/html5 and enabling HTML5 video. This will set a temporary cookie enabling browser-based video without Flash. You do not need a YouTube account for this feature, but you may need to periodically renew the cookie setting. Not all video is available in WebM.
For a more in-depth explanation of this policy and other workarounds, see PluginsNoLongerSupported.
## Known issues fixed in this version of TenFourFox ##
* All security and stability fixes from Firefox ESR 10.0.7.
## Known issues specific to TenFourFox ##
* Remember: **Plugins are turned off by default, and code for them will fail to function entirely in a subsequent version.** See PluginsNoLongerSupported for an explanation and suggested workarounds. Please note that out-of-process plugins have never been supported.
* As of TenFourFox 8, TenFourFox uses a lighter chrome for windows and dialogue boxes than prior versions or the official Mac Firefox. This is intentional.
* When 10.4Fx has no suggestions for the awesome bar, a blank box appears instead ([issue 21](https://code.google.com/p/tenfourfox/issues/detail?id=21)). This is intentional.
* 10.4Fx does not currently support WebGL, and scripts such as Indic or Arabic requiring glyph reordering or language-specific ligatures may not appear correctly. See TechnicalDifferences for the complete list of changes necessary for 10.4Fx. See [issue 5](https://code.google.com/p/tenfourfox/issues/detail?id=5) for notes specific to the font issue.
* Animation performance is currently poorer in Mozilla 2.0/Firefox 4.0 and later versions using software rendering, which includes 10.4Fx. The later graphics stack in the unstable release improves greatly upon this issue, and will become available in the near future on the stable branch.
* The titlebar does not always properly match the menu gradient ([issue 16](https://code.google.com/p/tenfourfox/issues/detail?id=16)). This problem is also in the official release. Installing a Persona may fix this issue if you find it bothersome.
* Crash reporting is intentionally disabled to avoid polluting Mozilla's crash tracking system with our reports. Please use your system's crash logs if you are reporting a _reproducible_ crash, or (if you are able) provide a `gdb` backtrace.
* Although 10.4Fx will tell you when an update is available, you must download updates manually at this time.
You are welcome to report other bugs that you find. However, please **do not report Mozilla bugs to us.** If the bug or crash occurs in both the official Mozilla Firefox 10 ESR _(3.6 doesn't count!)_ and in 10.4Fx, this is a Mozilla bug, and you should file it at [Bugzilla](http://bugzilla.mozilla.org/). **You must test your bug in both places -- bugs that are not confirmed to be part of 10.4Fx will be marked invalid** so that we can keep our task list focused. This is the [current list of known issues](http://code.google.com/p/tenfourfox/issues/list).

58
ReleaseNotes1008.md Normal file
View File

@ -0,0 +1,58 @@
_This document may be updated for late-breaking changes, so check back here if you are having difficulty._
## System requirements ##
TenFourFox (hereafter "10.4Fx") requires a G3 Power Macintosh, Mac OS X 10.4.11, 100MB of free disk space and 512MB of RAM. 1GB of RAM and a G4 or G5 processor is recommended. Video playback is likely to be poor on systems slower than 1.25GHz; a G5 is recommended. Mac OS X 10.5.8 is supported.
Intel Macintoshes are not supported, but the G3 build is known to run under Rosetta in 10.4.11, 10.5.8 and 10.6.8. Because Apple no longer supports Rosetta and 10.4Fx is not a Universal binary, it will not run under Lion 10.7 or any future version of Mac OS X.
## Getting TenFourFox ##
Make sure you select the appropriate build for your Mac from the [download page](http://www.tenfourfox.com/). The G3 version will run on any supported Macintosh, but it will not take advantage of the additional features of G4 or G5 processors. The G4 and G5 versions will not run correctly if at all on a G3, and the G5 version will perform badly or crash on non-G5 Macintoshes.
If you are using a G4, you should try to choose the correct version for your processor generation (7400 or 7450 "G4e") as performance may be impaired if you run the wrong one. If you don't know which G4 processor you have, the instructions in WhichVersion will tell you how to find out.
## TenFourFox 10.0.x is equivalent to Firefox ESR 10.0.x ##
TenFourFox uses modified Firefox source code, rewritten to remain compatible with Mac OS X v10.4 and the Power Macintosh. It also contains specific optimizations and special features for PowerPC processors. For this reason, it is not exactly the same as Firefox. However, it is intended to be as compatible with it as possible, including most add-ons and [most standard features](TechnicalDifferences.md). You can treat 10.4Fx as equivalent with Firefox ESR 10.0 in most circumstances, with specific exceptions noted below.
Note that add-ons which require an Intel Macintosh will not work with TenFourFox, even if they are otherwise compatible with Firefox 10, and add-ons that require 10.5 Leopard may not be compatible with TenFourFox running on Mac OS X 10.4 Tiger, even if they are compatible with PowerPC.
## This branch of TenFourFox is the _stable_ version ##
Starting with Firefox 10, Mozilla is now offering an extended support release version of Firefox ("Firefox **ESR**") intended for environments where users are unable to use rapid-release versions of Firefox due to policy or technical constraints.
10.4Fx 10.x is based on this extended support release and is intended for users who wish to remain with a stable browser core. The stable branch will continue to receive bugfixes and security updates, but will not receive new Firefox features (although it may receive certain 10.4Fx-specific features judged important for our legacy users).
**We recommend this version for most of our users.** If you wish to help test our continuing porting efforts, you can try the _unstable_ branch, which is based on the current release of Firefox. _The unstable branch does have bugs and is recommended only for advanced users._ For more information, see the [TenFourFox Development](http://tenfourfox.blogspot.com/) blog.
## TenFourFox no longer supports plugins or Flash ##
Plugins on PowerPC are of special concern because Mozilla is making updates to their plugin architecture which may require the plugins themselves to be updated, and there are certain difficult-to-correct bugs with them already on Tiger. Most importantly, QuickTime and Adobe Flash for PowerPC are no longer maintained and have known security risks that can crash, perform malicious operations or leak data, and Flash 10.1 is rapidly becoming unsupported by many applications.
**As of TenFourFox 6.0, for these and other reasons (for details, see PluginsNoLongerSupported), plugin support ships disabled.** Plugins will not operate by default, and bug reports will no longer be accepted. Sites will now act as if no plugins were installed at all.
For Internet video, we now recommend the use of TenFourFox's optional QuickTimeEnabler. This allows many videos to be handled in QuickTime Player directly.
You can also download videos for separate viewing using [Perian](http://www.perian.org/) and any of the available video download add-ons for Firefox.
For YouTube, you may also be able to use [MacTubes](http://macapps.sakura.ne.jp/mactubes/index_en.html). If you have a high end G4 or G5, you can also use WebM for selected videos by visiting http://www.youtube.com/html5 and enabling HTML5 video. This will set a temporary cookie enabling browser-based video without Flash. You do not need a YouTube account for this feature, but you may need to periodically renew the cookie setting. Not all video is available in WebM.
For a more in-depth explanation of this policy and other workarounds, see PluginsNoLongerSupported.
## Known issues fixed in this version of TenFourFox ##
* All security and stability fixes from Firefox ESR 10.0.8.
## Known issues specific to TenFourFox ##
* Remember: **Plugins are turned off by default, and code for them will fail to function entirely in a subsequent version.** See PluginsNoLongerSupported for an explanation and suggested workarounds. Please note that out-of-process plugins have never been supported.
* As of TenFourFox 8, TenFourFox uses a lighter chrome for windows and dialogue boxes than prior versions or the official Mac Firefox. This is intentional.
* When 10.4Fx has no suggestions for the awesome bar, a blank box appears instead ([issue 21](https://code.google.com/p/tenfourfox/issues/detail?id=21)). This is intentional.
* 10.4Fx does not currently support WebGL, and scripts such as Indic or Arabic requiring glyph reordering or language-specific ligatures may not appear correctly. See TechnicalDifferences for the complete list of changes necessary for 10.4Fx. See [issue 5](https://code.google.com/p/tenfourfox/issues/detail?id=5) for notes specific to the font issue.
* Animation performance is currently poorer in Mozilla 2.0/Firefox 4.0 and later versions using software rendering, which includes 10.4Fx. The later graphics stack in the unstable release improves greatly upon this issue, and will become available in the near future on the stable branch.
* The titlebar does not always properly match the menu gradient ([issue 16](https://code.google.com/p/tenfourfox/issues/detail?id=16)). This problem is also in the official release. Installing a Persona may fix this issue if you find it bothersome.
* Crash reporting is intentionally disabled to avoid polluting Mozilla's crash tracking system with our reports. Please use your system's crash logs if you are reporting a _reproducible_ crash, or (if you are able) provide a `gdb` backtrace.
* Although 10.4Fx will tell you when an update is available, you must download updates manually at this time.
You are welcome to report other bugs that you find. However, please **do not report Mozilla bugs to us.** If the bug or crash occurs in both the official Mozilla Firefox 10 ESR _(3.6 doesn't count!)_ and in 10.4Fx, this is a Mozilla bug, and you should file it at [Bugzilla](http://bugzilla.mozilla.org/). **You must test your bug in both places -- bugs that are not confirmed to be part of 10.4Fx will be marked invalid** so that we can keep our task list focused. This is the [current list of known issues](http://code.google.com/p/tenfourfox/issues/list).

58
ReleaseNotes1009.md Normal file
View File

@ -0,0 +1,58 @@
_This document may be updated for late-breaking changes, so check back here if you are having difficulty._
## System requirements ##
TenFourFox (hereafter "10.4Fx") requires a G3 Power Macintosh, Mac OS X 10.4.11, 100MB of free disk space and 512MB of RAM. 1GB of RAM and a G4 or G5 processor is recommended. Video playback is likely to be poor on systems slower than 1.25GHz; a G5 is recommended. Mac OS X 10.5.8 is supported.
Intel Macintoshes are not supported, but the G3 build is known to run under Rosetta in 10.4.11, 10.5.8 and 10.6.8. Because Apple no longer supports Rosetta and 10.4Fx is not a Universal binary, it will not run under Lion 10.7 or any future version of Mac OS X.
## Getting TenFourFox ##
Make sure you select the appropriate build for your Mac from the [download page](http://www.tenfourfox.com/). The G3 version will run on any supported Macintosh, but it will not take advantage of the additional features of G4 or G5 processors. The G4 and G5 versions will not run correctly if at all on a G3, and the G5 version will perform badly or crash on non-G5 Macintoshes.
If you are using a G4, you should try to choose the correct version for your processor generation (7400 or 7450 "G4e") as performance may be impaired if you run the wrong one. If you don't know which G4 processor you have, the instructions in WhichVersion will tell you how to find out.
## TenFourFox 10.0.x is equivalent to Firefox ESR 10.0.x ##
TenFourFox uses modified Firefox source code, rewritten to remain compatible with Mac OS X v10.4 and the Power Macintosh. It also contains specific optimizations and special features for PowerPC processors. For this reason, it is not exactly the same as Firefox. However, it is intended to be as compatible with it as possible, including most add-ons and [most standard features](TechnicalDifferences.md). You can treat 10.4Fx as equivalent with Firefox ESR 10.0 in most circumstances, with specific exceptions noted below.
Note that add-ons which require an Intel Macintosh will not work with TenFourFox, even if they are otherwise compatible with Firefox 10, and add-ons that require 10.5 Leopard may not be compatible with TenFourFox running on Mac OS X 10.4 Tiger, even if they are compatible with PowerPC.
## This branch of TenFourFox is the _stable_ version ##
Starting with Firefox 10, Mozilla is now offering an extended support release version of Firefox ("Firefox **ESR**") intended for environments where users are unable to use rapid-release versions of Firefox due to policy or technical constraints.
10.4Fx 10.x is based on this extended support release and is intended for users who wish to remain with a stable browser core. The stable branch will continue to receive bugfixes and security updates, but will not receive new Firefox features (although it may receive certain 10.4Fx-specific features judged important for our legacy users).
**We recommend this version for most of our users.** If you wish to help test our continuing porting efforts, you can try the _unstable_ branch, which is based on the current release of Firefox. _The unstable branch does have bugs and is recommended only for advanced users._ For more information, see the [TenFourFox Development](http://tenfourfox.blogspot.com/) blog.
## TenFourFox no longer supports plugins or Flash ##
Plugins on PowerPC are of special concern because Mozilla is making updates to their plugin architecture which may require the plugins themselves to be updated, and there are certain difficult-to-correct bugs with them already on Tiger. Most importantly, QuickTime and Adobe Flash for PowerPC are no longer maintained and have known security risks that can crash, perform malicious operations or leak data, and Flash 10.1 is rapidly becoming unsupported by many applications.
**As of TenFourFox 6.0, for these and other reasons (for details, see PluginsNoLongerSupported), plugin support ships disabled.** Plugins will not operate by default, and bug reports will no longer be accepted. Sites will now act as if no plugins were installed at all.
For Internet video, we now recommend the use of TenFourFox's optional QuickTimeEnabler. This allows many videos to be handled in QuickTime Player directly.
You can also download videos for separate viewing using [Perian](http://www.perian.org/) and any of the available video download add-ons for Firefox.
For YouTube, you may also be able to use [MacTubes](http://macapps.sakura.ne.jp/mactubes/index_en.html). If you have a high end G4 or G5, you can also use WebM for selected videos by visiting http://www.youtube.com/html5 and enabling HTML5 video. This will set a temporary cookie enabling browser-based video without Flash. You do not need a YouTube account for this feature, but you may need to periodically renew the cookie setting. Not all video is available in WebM.
For a more in-depth explanation of this policy and other workarounds, see PluginsNoLongerSupported.
## Known issues fixed in this version of TenFourFox ##
* Fixes an urgent security issue in Firefox (Mozilla [bug 720619](https://code.google.com/p/tenfourfox/issues/detail?id=20619)). All users are strongly advised to upgrade as soon as possible.
## Known issues specific to TenFourFox ##
* Remember: **Plugins are turned off by default, and code for them will fail to function entirely in a subsequent version.** See PluginsNoLongerSupported for an explanation and suggested workarounds. Please note that out-of-process plugins have never been supported.
* As of TenFourFox 8, TenFourFox uses a lighter chrome for windows and dialogue boxes than prior versions or the official Mac Firefox. This is intentional.
* When 10.4Fx has no suggestions for the awesome bar, a blank box appears instead ([issue 21](https://code.google.com/p/tenfourfox/issues/detail?id=21)). This is intentional.
* 10.4Fx does not currently support WebGL, and scripts such as Indic or Arabic requiring glyph reordering or language-specific ligatures may not appear correctly. See TechnicalDifferences for the complete list of changes necessary for 10.4Fx. See [issue 5](https://code.google.com/p/tenfourfox/issues/detail?id=5) for notes specific to the font issue.
* Animation performance is currently poorer in Mozilla 2.0/Firefox 4.0 and later versions using software rendering, which includes 10.4Fx. The later graphics stack in the unstable release improves greatly upon this issue, and will become available in the near future on the stable branch.
* The titlebar does not always properly match the menu gradient ([issue 16](https://code.google.com/p/tenfourfox/issues/detail?id=16)). This problem is also in the official release. Installing a Persona may fix this issue if you find it bothersome.
* Crash reporting is intentionally disabled to avoid polluting Mozilla's crash tracking system with our reports. Please use your system's crash logs if you are reporting a _reproducible_ crash, or (if you are able) provide a `gdb` backtrace.
* Although 10.4Fx will tell you when an update is available, you must download updates manually at this time.
You are welcome to report other bugs that you find. However, please **do not report Mozilla bugs to us.** If the bug or crash occurs in both the official Mozilla Firefox 10 ESR _(3.6 doesn't count!)_ and in 10.4Fx, this is a Mozilla bug, and you should file it at [Bugzilla](http://bugzilla.mozilla.org/). **You must test your bug in both places -- bugs that are not confirmed to be part of 10.4Fx will be marked invalid** so that we can keep our task list focused. This is the [current list of known issues](http://code.google.com/p/tenfourfox/issues/list).

67
ReleaseNotes10Beta1.md Normal file
View File

@ -0,0 +1,67 @@
_This document may be updated for late-breaking changes, so check back here if you are having difficulty._
## System requirements ##
TenFourFox (hereafter "10.4Fx") requires a G3 Power Macintosh, Mac OS X 10.4.11, 100MB of free disk space and 512MB of RAM. 1GB of RAM and a G4 or G5 processor is recommended. Video playback is likely to be poor on systems slower than 1.25GHz; a G5 is recommended. Mac OS X 10.5.8 is supported.
Intel Macintoshes are not supported, but the G3 build is known to run under Rosetta in 10.4.11, 10.5.8 and 10.6.8. Because Apple no longer supports Rosetta and 10.4Fx is not a Universal binary, it will not run under Lion 10.7 or any future version of Mac OS X.
## Getting TenFourFox ##
Make sure you select the appropriate build for your Mac from the [download page](http://www.tenfourfox.com/). The G3 version will run on any supported Macintosh, but it will not take advantage of the additional features of G4 or G5 processors. The G4 and G5 versions will not run correctly on a G3, and the G5 version will perform worse on non-G5 Macintoshes.
If you are using a G4, you should try to choose the correct version for your processor generation (7400 or 7450 "G4e") as performance may be impaired if you run the wrong one. If you don't know which G4 processor you have, the instructions in WhichVersion will tell you how to find out.
## Beta considerations ##
**This version of TenFourFox is a beta.** It is only _mostly_ complete. In particular, there may be some late breaking features planned for the final version which are not yet present in this beta (which is approximately equivalent to Mozilla Firefox 10.0 beta 3), and there may be some final additional optimizations specific to 10.4Fx which will be made just prior to final release. **You should know that you are using this software at your own risk. It may cause data loss, security breaches, system instability and crashes. If you are not comfortable with these (remote but possible) possibilities, do not use this beta release.**
## TenFourFox 10.0.x is equivalent to Firefox ESR 10.0.x ##
TenFourFox uses modified Firefox source code, rewritten to remain compatible with Mac OS X v10.4 and the Power Macintosh. It also contains specific optimizations and special features for PowerPC processors. For this reason, it is not exactly the same as Firefox. However, it is intended to be as compatible with it as possible, including most add-ons and [most standard features](TechnicalDifferences.md). You can treat 10.4Fx as equivalent with Firefox ESR 10.0 in most circumstances, with specific exceptions noted below.
Note that add-ons which require an Intel Macintosh will not work with TenFourFox, even if they are otherwise compatible with Firefox 10, and add-ons that require 10.5 Leopard may not be compatible with TenFourFox running on Mac OS X 10.4 Tiger, even if they are compatible with PowerPC.
## This branch of TenFourFox is the _stable_ version ##
Starting with Firefox 10, Mozilla is now offering an extended support release version of Firefox ("Firefox **ESR**") intended for environments where users are unable to use rapid-release versions of Firefox due to policy or technical constraints.
10.4Fx 10.x is based on this extended support release and is intended for users who wish to remain with a stable browser core. The stable branch will continue to receive bugfixes and security updates, but will not receive new Firefox features (although it may receive certain 10.4Fx-specific features judged important for our legacy users).
**We recommend this version for most of our users.** If you wish to help test our continuing porting efforts, you can try the _unstable_ branch, which is based on the current release of Firefox. _The unstable branch does have bugs and is recommended only for advanced users._ For more information, see the [TenFourFox Development](http://tenfourfox.blogspot.com/) blog.
## TenFourFox no longer supports plugins or Flash ##
Plugins on PowerPC are of special concern because Mozilla is making updates to their plugin architecture which may require the plugins themselves to be updated, and there are certain difficult-to-correct bugs with them already on Tiger. Most importantly, Adobe Flash for PowerPC is no longer maintained and has known security risks that can crash or leak data, and QuickTime for Leopard will lose its own support with the release of OS X Lion. In addition, Flash 10.1 is rapidly becoming unsupported by many applications.
**As of TenFourFox 6.0, for these and other reasons (for details, see PluginsNoLongerSupported), plugin support ships disabled.** Plugins will not operate by default, and bug reports will no longer be accepted. Sites will now act as if no plugins were installed at all.
For Internet video, we strongly recommend the use of [Perian](http://www.perian.org/) and any of the available video download add-ons for Firefox.
For YouTube, we recommend [MacTubes](http://macapps.web.infoseek.co.jp/mactubes/index_en.html). If you have a high end G4 or G5, you can also use WebM for selected videos by visiting http://www.youtube.com/html5 and enabling HTML5 video. This will set a temporary cookie enabling browser-based video without Flash. You do not need a YouTube account for this feature, but you may need to periodically renew the cookie setting. Not all video is available in WebM.
For a more in-depth explanation of this policy and other workarounds, see PluginsNoLongerSupported.
## New features specific to TenFourFox ##
* All new standard features of Firefox 10, including developer tools to inspect web pages within the browser, multi-threaded WebM video support, dynamically controlled full-screen web content, 3D CSS support (using software rendering), interface improvements and improved HTML5 compliance.
* Starting with TenFourFox 10, 10.4Fx now uses a new JavaScript accelerator featuring method-based compilation and type inference ("JM+TI"), the same compiler used in standard Firefox ([issue 96](https://code.google.com/p/tenfourfox/issues/detail?id=96)). This compiler meets or exceeds the original tracing JIT on most tested benchmarks, and is now the default compiler. The tracejit remains in the stable branch as a legacy method for testing, and will not be in 11.0 or any subsequent version.
* Additional AltiVec-accelerated text conversion methods ([issue 98](https://code.google.com/p/tenfourfox/issues/detail?id=98)).
## Known issues fixed in this version of TenFourFox ##
* The previous AltiVec-accelerated text converters are fixed and reenabled in this release ([issue 75](https://code.google.com/p/tenfourfox/issues/detail?id=75), [issue 76](https://code.google.com/p/tenfourfox/issues/detail?id=76)).
* An issue with incorrect results from certain regular expressions in JavaScript has been corrected ([issue 120](https://code.google.com/p/tenfourfox/issues/detail?id=120)).
* `about:memory` no longer displays erroneous characters ([issue 121](https://code.google.com/p/tenfourfox/issues/detail?id=121)).
## Known issues specific to TenFourFox ##
* Remember: **Plugins are turned off by default, and code for them will fail to function entirely in a subsequent version.** See PluginsNoLongerSupported for an explanation and suggested workarounds. Please note that out-of-process plugins have never been supported.
* As of TenFourFox 8, TenFourFox uses a lighter chrome for windows and dialogue boxes than prior versions or the official Mac Firefox. This is intentional.
* When 10.4Fx has no suggestions for the awesome bar, a blank box appears instead ([issue 21](https://code.google.com/p/tenfourfox/issues/detail?id=21)). This is intentional.
* 10.4Fx does not currently support WebGL, and Indic, Arabic and other scripts requiring glyph reordering or language-specific ligatures may not appear correctly. See TechnicalDifferences for the complete list of changes necessary for 10.4Fx. See [issue 5](https://code.google.com/p/tenfourfox/issues/detail?id=5) for notes specific to the font issue.
* Animation performance is currently poorer in Mozilla 2.0/Firefox 4.0 and later versions using software rendering, which includes 10.4Fx. Mozilla acknowledges this bug, but there is not yet an ETR. See [issue 7](https://code.google.com/p/tenfourfox/issues/detail?id=7).
* The titlebar does not always properly match the menu gradient ([issue 16](https://code.google.com/p/tenfourfox/issues/detail?id=16)). This problem is also in the official release. Installing a Persona may fix this issue if you find it bothersome.
* Crash reporting is intentionally disabled to avoid polluting Mozilla's crash tracking system with our reports. Please use your system's crash logs if you are reporting a _reproducible_ crash, or (if you are able) provide a `gdb` backtrace.
* Although 10.4Fx will tell you when an update is available, you must download updates manually at this time.
You are welcome to report other bugs that you find. However, please **do not report Mozilla bugs to us.** If the bug or crash occurs in both the official Mozilla Firefox 10 _(3.6 doesn't count!)_ and in 10.4Fx, this is a Mozilla bug, and you should file it at [Bugzilla](http://bugzilla.mozilla.org/). **You must test your bug in both places -- bugs that are not confirmed to be part of 10.4Fx will be marked invalid** so that we can keep our task list focused. This is the [current list of known issues](http://code.google.com/p/tenfourfox/issues/list).

59
ReleaseNotes110.md Normal file
View File

@ -0,0 +1,59 @@
_This document may be updated for late-breaking changes, so check back here if you are having difficulty._
## System requirements ##
TenFourFox (hereafter "10.4Fx") requires a G3 Power Macintosh, Mac OS X 10.4.11, 100MB of free disk space and 512MB of RAM. 1GB of RAM and a G4 or G5 processor is recommended. Video playback is likely to be poor on systems slower than 1.25GHz; a G5 is recommended. Mac OS X 10.5.8 is supported.
Intel Macintoshes are not supported, but the G3 build is known to run under Rosetta in 10.4.11, 10.5.8 and 10.6.8. Because Apple no longer supports Rosetta and 10.4Fx is not a Universal binary, it will not run under Lion 10.7 or any future version of Mac OS X.
## Getting TenFourFox ##
Make sure you select the appropriate build for your Mac from the [download page](http://www.tenfourfox.com/). The G3 version will run on any supported Macintosh, but it will not take advantage of the additional features of G4 or G5 processors. The G4 and G5 versions will not run correctly on a G3, and the G5 version will perform worse on non-G5 Macintoshes.
If you are using a G4, you should try to choose the correct version for your processor generation (7400 or 7450 "G4e") as performance may be impaired if you run the wrong one. If you don't know which G4 processor you have, the instructions in WhichVersion will tell you how to find out.
## TenFourFox 11 is equivalent to Firefox 11 ##
TenFourFox uses modified Firefox source code, rewritten to remain compatible with Mac OS X v10.4 and the Power Macintosh. It also contains specific optimizations and special features for PowerPC processors. For this reason, it is not exactly the same as Firefox. However, it is intended to be as compatible with it as possible, including most add-ons and [most standard features](TechnicalDifferences.md). You can treat 10.4Fx 11 as equivalent with Firefox 11 in most circumstances, with specific exceptions noted below.
Note that add-ons which require an Intel Macintosh will not work with TenFourFox, even if they are otherwise compatible with Firefox 11, and add-ons that require 10.5 Leopard may not be compatible with TenFourFox running on Mac OS X 10.4 Tiger, even if they are compatible with PowerPC.
## This branch of TenFourFox is the _unstable_ version ##
Starting with Firefox 10, Mozilla is now offering an extended support release version of Firefox ("Firefox **ESR**") intended for environments where users are unable to use rapid-release versions of Firefox due to policy or technical constraints. 10.4Fx 10.x is based on this extended support release and is intended for users who wish to remain with a stable browser core. The _stable_ branch will continue to receive bugfixes and security updates, but will not receive new Firefox features (although it may receive certain 10.4Fx-specific features judged important for our legacy users).
However, for more proficient users who want to try more up-to-date features and help us test new builds of 10.4Fx based on current releases of Firefox, we make available the _unstable_ branch, which is this release. **While the unstable branch is generally suitable for day-to-day use, it does have bugs and is recommended only for advanced users.** Although major bugs will be repaired as promptly as possible, minor and even some moderate severity bugs might not be fixed on a particular timetable. The highest priority is to keep the port viable, which may mean diverting our limited time away from non-critical issues. **If you need a release-quality version of TenFourFox, please use the stable version instead.** You can download the stable version from [our main page](http://www.tenfourfox.com/).
## TenFourFox no longer supports plugins or Flash ##
Plugins on PowerPC are of special concern because Mozilla is making updates to their plugin architecture which may require the plugins themselves to be updated, and there are certain difficult-to-correct bugs with them already on Tiger. Most importantly, QuickTime and Adobe Flash for PowerPC are no longer maintained and have known security risks that can crash, perform malicious operations or leak data, and Flash 10.1 is rapidly becoming unsupported by many applications.
**As of TenFourFox 6.0, for these and other reasons (for details, see PluginsNoLongerSupported), plugin support ships disabled.** Plugins will not operate by default, and bug reports will no longer be accepted. Sites will now act as if no plugins were installed at all.
For Internet video, we strongly recommend the use of [Perian](http://www.perian.org/) and any of the available video download add-ons for Firefox.
For YouTube, we recommend [MacTubes](http://macapps.web.infoseek.co.jp/mactubes/index_en.html). If you have a high end G4 or G5, you can also use WebM for selected videos by visiting http://www.youtube.com/html5 and enabling HTML5 video. This will set a temporary cookie enabling browser-based video without Flash. You do not need a YouTube account for this feature, but you may need to periodically renew the cookie setting. Not all video is available in WebM.
For a more in-depth explanation of this policy and other workarounds, see PluginsNoLongerSupported.
## New features in this version of TenFourFox ##
* All new standard features of Firefox 11 where supported, including SPDY protocol support (disabled by default), battery API support, improved animated GIF performance, Graphite font compatibility, WebSockets improvements and new IndexedDB features.
* Improved performance for G3 and G4 square root in JavaScript ([issue 134](https://code.google.com/p/tenfourfox/issues/detail?id=134)).
* Improved G5 JavaScript overall performance ([issue 135](https://code.google.com/p/tenfourfox/issues/detail?id=135)).
## Known issues fixed in this version of TenFourFox ##
* All bug fixes in [10.0.3 stable](ReleaseNotes1003.md) (except this version has a different square root routine).
## Known issues specific to TenFourFox ##
* Remember: **Plugins are turned off by default, and code for them will fail to function entirely in a subsequent version.** See PluginsNoLongerSupported for an explanation and suggested workarounds. Please note that out-of-process plugins have never been supported.
* As of TenFourFox 8, TenFourFox uses a lighter chrome for windows and dialogue boxes than prior versions or the official Mac Firefox. This is intentional.
* When 10.4Fx has no suggestions for the awesome bar, a blank box appears instead ([issue 21](https://code.google.com/p/tenfourfox/issues/detail?id=21)). This is intentional.
* 10.4Fx does not currently support WebGL, and Indic, Arabic and other scripts requiring glyph reordering or language-specific ligatures may not appear correctly. See TechnicalDifferences for the complete list of changes necessary for 10.4Fx. See [issue 5](https://code.google.com/p/tenfourfox/issues/detail?id=5) for notes specific to the font issue.
* The titlebar does not always properly match the menu gradient ([issue 16](https://code.google.com/p/tenfourfox/issues/detail?id=16)). This problem is also in the official release. Installing a Persona may fix this issue if you find it bothersome.
* Crash reporting is intentionally disabled to avoid polluting Mozilla's crash tracking system with our reports. Please use your system's crash logs if you are reporting a _reproducible_ crash, or (if you are able) provide a `gdb` backtrace.
* Although 10.4Fx will tell you when an update is available, you must download updates manually at this time.
You are welcome to report other bugs that you find. However, please **do not report Mozilla bugs to us.** If the bug or crash occurs in both the official Mozilla Firefox 11 _(3.6 doesn't count!)_ and in 10.4Fx, this is a Mozilla bug, and you should file it at [Bugzilla](http://bugzilla.mozilla.org/). **You must test your bug in both places -- bugs that are not confirmed to be part of 10.4Fx will be marked invalid** so that we can keep our task list focused. This is the [current list of known issues](http://code.google.com/p/tenfourfox/issues/list).

59
ReleaseNotes120.md Normal file
View File

@ -0,0 +1,59 @@
_This document may be updated for late-breaking changes, so check back here if you are having difficulty._
## System requirements ##
TenFourFox (hereafter "10.4Fx") requires a G3 Power Macintosh, Mac OS X 10.4.11, 100MB of free disk space and 512MB of RAM. 1GB of RAM and a G4 or G5 processor is recommended. Video playback is likely to be poor on systems slower than 1.25GHz; a G5 is recommended. Mac OS X 10.5.8 is supported.
Intel Macintoshes are not supported, but the G3 build is known to run under Rosetta in 10.4.11, 10.5.8 and 10.6.8. Because Apple no longer supports Rosetta and 10.4Fx is not a Universal binary, it will not run under Lion 10.7 or any future version of Mac OS X.
## Getting TenFourFox ##
Make sure you select the appropriate build for your Mac from the [download page](http://www.tenfourfox.com/). The G3 version will run on any supported Macintosh, but it will not take advantage of the additional features of G4 or G5 processors. The G4 and G5 versions will not run correctly on a G3, and the G5 version will perform worse on non-G5 Macintoshes.
If you are using a G4, you should try to choose the correct version for your processor generation (7400 or 7450 "G4e") as performance may be impaired if you run the wrong one. If you don't know which G4 processor you have, the instructions in WhichVersion will tell you how to find out.
## TenFourFox 12 is equivalent to Firefox 12 ##
TenFourFox uses modified Firefox source code, rewritten to remain compatible with Mac OS X v10.4 and the Power Macintosh. It also contains specific optimizations and special features for PowerPC processors. For this reason, it is not exactly the same as Firefox. However, it is intended to be as compatible with it as possible, including most add-ons and [most standard features](TechnicalDifferences.md). You can treat 10.4Fx 12 as equivalent with Firefox 12 in most circumstances, with specific exceptions noted below.
Note that add-ons which require an Intel Macintosh will not work with TenFourFox, even if they are otherwise compatible with Firefox 12, and add-ons that require 10.5 Leopard may not be compatible with TenFourFox running on Mac OS X 10.4 Tiger, even if they are compatible with PowerPC.
## This branch of TenFourFox is the _unstable_ version ##
Starting with Firefox 10, Mozilla is now offering an extended support release version of Firefox ("Firefox **ESR**") intended for environments where users are unable to use rapid-release versions of Firefox due to policy or technical constraints. 10.4Fx 10.x is based on this extended support release and is intended for users who wish to remain with a stable browser core. The _stable_ branch will continue to receive bugfixes and security updates, but will not receive new Firefox features (although it may receive certain 10.4Fx-specific features judged important for our legacy users).
However, for more proficient users who want to try more up-to-date features and help us test new builds of 10.4Fx based on current releases of Firefox, we make available the _unstable_ branch, which is this release. **While the unstable branch is generally suitable for day-to-day use, it does have bugs and is recommended only for advanced users.** Although major bugs will be repaired as promptly as possible, minor and even some moderate severity bugs might not be fixed on a particular timetable. The highest priority is to keep the port viable, which may mean diverting our limited time away from non-critical issues. **If you need a release-quality version of TenFourFox, please use the stable version instead.** You can download the stable version from [our main page](http://www.tenfourfox.com/).
## TenFourFox no longer supports plugins or Flash ##
Plugins on PowerPC are of special concern because Mozilla is making updates to their plugin architecture which may require the plugins themselves to be updated, and there are certain difficult-to-correct bugs with them already on Tiger. Most importantly, QuickTime, Java and Adobe Flash for PowerPC are no longer maintained and have known security risks that can crash, perform malicious operations or leak data, and Flash 10.1 is rapidly becoming unsupported by many applications.
**As of TenFourFox 6.0, for these and other reasons (for details, see PluginsNoLongerSupported), plugin support ships disabled.** Plugins will not operate by default, and bug reports will no longer be accepted. Sites will now act as if no plugins were installed at all.
For Internet video, we strongly recommend the use of [Perian](http://www.perian.org/) and any of the available video download add-ons for Firefox.
For YouTube, we recommend [MacTubes](http://macapps.web.infoseek.co.jp/mactubes/index_en.html). If you have a high end G4 or G5, you can also use WebM for selected videos by visiting http://www.youtube.com/html5 and enabling HTML5 video. This will set a temporary cookie enabling browser-based video without Flash. You do not need a YouTube account for this feature, but you may need to periodically renew the cookie setting. Not all video is available in WebM.
For a more in-depth explanation of this policy and other workarounds, see PluginsNoLongerSupported.
## New features in this version of TenFourFox ##
* All new standard features of Firefox 12 where supported, including Azure CoreGraphics canvas acceleration, additional CSS property support and additional DOM 4 features.
* Custom CoreGraphics accelerated graphics backend for 10.4 and 10.5 ([issue 125](https://code.google.com/p/tenfourfox/issues/detail?id=125)). This is currently used only for HTML canvas objects, but will be extended to other browser components in the future.
* Accelerated calls to system components from JavaScript ([issue 137](https://code.google.com/p/tenfourfox/issues/detail?id=137)).
## Known issues fixed in this version of TenFourFox ##
* All bug fixes in [10.0.4 stable](ReleaseNotes1004.md) except the blocklist disable (a 10.4Fx-specific blocklist is planned).
## Known issues specific to TenFourFox ##
* Remember: **Plugins are turned off by default, and code for them will fail to function entirely in a subsequent version.** See PluginsNoLongerSupported for an explanation and suggested workarounds. Please note that out-of-process plugins have never been supported.
* As of TenFourFox 8, TenFourFox uses a lighter chrome for windows and dialogue boxes than prior versions or the official Mac Firefox. This is intentional.
* When 10.4Fx has no suggestions for the awesome bar, a blank box appears instead ([issue 21](https://code.google.com/p/tenfourfox/issues/detail?id=21)). This is intentional.
* 10.4Fx does not currently support WebGL, and Indic, Arabic and other scripts requiring glyph reordering or language-specific ligatures may not appear correctly. See TechnicalDifferences for the complete list of changes necessary for 10.4Fx. See [issue 5](https://code.google.com/p/tenfourfox/issues/detail?id=5) for notes specific to the font issue.
* The titlebar does not always properly match the menu gradient ([issue 16](https://code.google.com/p/tenfourfox/issues/detail?id=16)). This problem is also in the official release. Installing a Persona may fix this issue if you find it bothersome.
* Crash reporting is intentionally disabled to avoid polluting Mozilla's crash tracking system with our reports. Please use your system's crash logs if you are reporting a _reproducible_ crash, or (if you are able) provide a `gdb` backtrace.
* Although 10.4Fx will tell you when an update is available, you must download updates manually at this time.
You are welcome to report other bugs that you find. However, please **do not report Mozilla bugs to us.** If the bug or crash occurs in both the official Mozilla Firefox 12 _(3.6 doesn't count!)_ and in 10.4Fx, this is a Mozilla bug, and you should file it at [Bugzilla](http://bugzilla.mozilla.org/). **You must test your bug in both places -- bugs that are not confirmed to be part of 10.4Fx will be marked invalid** so that we can keep our task list focused. This is the [current list of known issues](http://code.google.com/p/tenfourfox/issues/list).

59
ReleaseNotes130.md Normal file
View File

@ -0,0 +1,59 @@
_This document may be updated for late-breaking changes, so check back here if you are having difficulty._
## System requirements ##
TenFourFox (hereafter "10.4Fx") requires a G3 Power Macintosh, Mac OS X 10.4.11, 100MB of free disk space and 512MB of RAM. 1GB of RAM and a G4 or G5 processor is recommended. Video playback is likely to be poor on systems slower than 1.25GHz; a G5 is recommended. Mac OS X 10.5.8 is supported.
Intel Macintoshes are not supported, but the G3 build is known to run under Rosetta in 10.4.11, 10.5.8 and 10.6.8. Because Apple no longer supports Rosetta and 10.4Fx is not a Universal binary, it will not run under Lion 10.7 or any future version of Mac OS X.
## Getting TenFourFox ##
Make sure you select the appropriate build for your Mac from the [download page](http://www.tenfourfox.com/). The G3 version will run on any supported Macintosh, but it will not take advantage of the additional features of G4 or G5 processors. The G4 and G5 versions will not run at all on a G3, and the G5 version will perform badly or crash on non-G5 Macintoshes.
If you are using a G4, you should try to choose the correct version for your processor generation (7400 or 7450 "G4e") as performance may be impaired if you run the wrong one. If you don't know which G4 processor you have, the instructions in WhichVersion will tell you how to find out.
## TenFourFox 13 is equivalent to Firefox 13 ##
TenFourFox uses modified Firefox source code, rewritten to remain compatible with Mac OS X v10.4 and the Power Macintosh. It also contains specific optimizations and special features for PowerPC processors. For this reason, it is not exactly the same as Firefox. However, it is intended to be as compatible with it as possible, including most add-ons and [most standard features](TechnicalDifferences.md). You can treat 10.4Fx 13 as equivalent with Firefox 13 in most circumstances, with specific exceptions noted below.
Note that add-ons which require an Intel Macintosh will not work with TenFourFox, even if they are otherwise compatible with Firefox 13, and add-ons that require 10.5 Leopard may not be compatible with TenFourFox running on Mac OS X 10.4 Tiger, even if they are compatible with PowerPC.
## This branch of TenFourFox is the _unstable_ version ##
Starting with Firefox 10, Mozilla is now offering an extended support release version of Firefox ("Firefox **ESR**") intended for environments where users are unable to use rapid-release versions of Firefox due to policy or technical constraints. 10.4Fx 10.x is based on this extended support release and is intended for users who wish to remain with a stable browser core. The _stable_ branch will continue to receive bugfixes and security updates, but will not receive new Firefox features (although it may receive certain 10.4Fx-specific features judged important for our legacy users).
However, for more proficient users who want to try more up-to-date features and help us test new builds of 10.4Fx based on current releases of Firefox, we make available the _unstable_ branch, which is this release. **While the unstable branch is generally suitable for day-to-day use, it does have bugs and is recommended only for advanced users.** Although major bugs will be repaired as promptly as possible, minor and even some moderate severity bugs might not be fixed on a particular timetable. The highest priority is to keep the port viable, which may mean diverting our limited time away from non-critical issues. **If you need a release-quality version of TenFourFox, please use the stable version instead.** You can download the stable version from [our main page](http://www.tenfourfox.com/).
## TenFourFox no longer supports plugins or Flash ##
Plugins on PowerPC are of special concern because Mozilla is making updates to their plugin architecture which may require the plugins themselves to be updated, and there are certain difficult-to-correct bugs with them already on Tiger. Most importantly, QuickTime, Java and Adobe Flash for PowerPC are no longer maintained and have known security risks that can crash, perform malicious operations or leak data, and Flash 10.1 is rapidly becoming unsupported by many applications.
**As of TenFourFox 6.0, for these and other reasons (for details, see PluginsNoLongerSupported), plugin support ships disabled.** Plugins will not operate by default, and bug reports will no longer be accepted. Sites will now act as if no plugins were installed at all.
For Internet video, we strongly recommend the use of [Perian](http://www.perian.org/) and any of the available video download add-ons for Firefox.
For YouTube, we recommend [MacTubes](http://macapps.sakura.ne.jp/mactubes/index_en.html). If you have a high end G4 or G5, you can also use WebM for selected videos by visiting http://www.youtube.com/html5 and enabling HTML5 video. This will set a temporary cookie enabling browser-based video without Flash. You do not need a YouTube account for this feature, but you may need to periodically renew the cookie setting. Not all video is available in WebM.
For a more in-depth explanation of this policy and other workarounds, see PluginsNoLongerSupported.
## New features in this version of TenFourFox ##
* All new standard features of Firefox 13 where supported, including SPDY acceleration on supported web servers, new "new tab" page, on-demand tab loading, and additional CSS 4 features.
* 10.4Fx is now built with `-mdynamic-no-pic`, which improves overall performance on all architectures ([issue 153](https://code.google.com/p/tenfourfox/issues/detail?id=153)).
## Known issues fixed in this version of TenFourFox ##
* WOFF fonts should now correctly load again ([issue 146](https://code.google.com/p/tenfourfox/issues/detail?id=146)), correcting the regression caused by Mozilla in 12.0.
* All known bugs with gradients using the accelerated Azure backend are now fixed ([issue 152](https://code.google.com/p/tenfourfox/issues/detail?id=152)).
* WebM is now single-threaded again ([issue 148](https://code.google.com/p/tenfourfox/issues/detail?id=148)) due to changes in the video stack that behave adversely with multi-threaded decoding. This change will not be backported to the stable branch, which uses the older stack.
## Known issues specific to TenFourFox ##
* Remember: **Plugins are turned off by default, and code for them will fail to function entirely in a subsequent version.** See PluginsNoLongerSupported for an explanation and suggested workarounds. Please note that out-of-process plugins have never been supported.
* As of TenFourFox 8, TenFourFox uses a lighter chrome for windows and dialogue boxes than prior versions or the official Mac Firefox. This is intentional.
* 10.4Fx does not currently support WebGL, and scripts such as Arabic or Indic requiring glyph reordering or language-specific ligatures may not appear correctly. See TechnicalDifferences for the complete list of changes necessary for 10.4Fx. See [issue 5](https://code.google.com/p/tenfourfox/issues/detail?id=5) for notes specific to the font issue.
* The titlebar does not always properly match the menu gradient ([issue 16](https://code.google.com/p/tenfourfox/issues/detail?id=16)). This problem is also in the official release. Installing a Persona may fix this issue if you find it bothersome.
* Crash reporting is intentionally disabled to avoid polluting Mozilla's crash tracking system with our reports. Please use your system's crash logs if you are reporting a _reproducible_ crash, or (if you are able) provide a `gdb` backtrace.
* Although 10.4Fx will tell you when an update is available, you must download updates manually at this time.
You are welcome to report other bugs that you find. However, please **do not report Mozilla bugs to us.** If the bug or crash occurs in both the official Mozilla Firefox 13 _(3.6 doesn't count!)_ and in 10.4Fx, this is a Mozilla bug, and you should file it at [Bugzilla](http://bugzilla.mozilla.org/). **You must test your bug in both places -- bugs that are not confirmed to be part of 10.4Fx will be marked invalid** so that we can keep our task list focused. This is the [current list of known issues](http://code.google.com/p/tenfourfox/issues/list).

55
ReleaseNotes140.md Normal file
View File

@ -0,0 +1,55 @@
_This document may be updated for late-breaking changes, so check back here if you are having difficulty._
## System requirements ##
TenFourFox (hereafter "10.4Fx") requires a G3 Power Macintosh, Mac OS X 10.4.11, 100MB of free disk space and 512MB of RAM. 1GB of RAM and a G4 or G5 processor is recommended. Video playback is likely to be poor on systems slower than 1.25GHz; a G5 is recommended. Mac OS X 10.5.8 is supported.
Intel Macintoshes are not supported, but the G3 build is known to run under Rosetta in 10.4.11, 10.5.8 and 10.6.8. Because Apple no longer supports Rosetta and 10.4Fx is not a Universal binary, it will not run under Lion 10.7 or any future version of Mac OS X.
## Getting TenFourFox ##
Make sure you select the appropriate build for your Mac from the [download page](http://www.tenfourfox.com/). The G3 version will run on any supported Macintosh, but it will not take advantage of the additional features of G4 or G5 processors. The G4 and G5 versions will not run at all on a G3, and the G5 version will perform badly or crash on non-G5 Macintoshes.
If you are using a G4, you should try to choose the correct version for your processor generation (7400 or 7450 "G4e") as performance may be impaired if you run the wrong one. If you don't know which G4 processor you have, the instructions in WhichVersion will tell you how to find out.
## TenFourFox 14 is equivalent to Firefox 14 ##
TenFourFox uses modified Firefox source code, rewritten to remain compatible with Mac OS X v10.4 and the Power Macintosh. It also contains specific optimizations and special features for PowerPC processors. For this reason, it is not exactly the same as Firefox. However, it is intended to be as compatible with it as possible, including most add-ons and [most standard features](TechnicalDifferences.md). You can treat 10.4Fx 14 as equivalent with Firefox 14 in most circumstances, with specific exceptions noted below.
Note that add-ons which require an Intel Macintosh will not work with TenFourFox, even if they are otherwise compatible with Firefox 14, and add-ons that require 10.5 Leopard may not be compatible with TenFourFox running on Mac OS X 10.4 Tiger, even if they are compatible with PowerPC.
## This branch of TenFourFox is the _unstable_ version ##
Starting with Firefox 10, Mozilla is now offering an extended support release version of Firefox ("Firefox **ESR**") intended for environments where users are unable to use rapid-release versions of Firefox due to policy or technical constraints. 10.4Fx 10.x is based on this extended support release and is intended for users who wish to remain with a stable browser core. The _stable_ branch will continue to receive bugfixes and security updates, but will not receive new Firefox features (although it may receive certain 10.4Fx-specific features judged important for our legacy users).
However, for more proficient users who want to try more up-to-date features and help us test new builds of 10.4Fx based on current releases of Firefox, we make available the _unstable_ branch, which is this release. **While the unstable branch is generally suitable for day-to-day use, it does have bugs and is recommended only for advanced users.** Although major bugs will be repaired as promptly as possible, minor and even some moderate severity bugs might not be fixed on a particular timetable. The highest priority is to keep the port viable, which may mean diverting our limited time away from non-critical issues. **If you need a release-quality version of TenFourFox, please use the stable version instead.** You can download the stable version from [our main page](http://www.tenfourfox.com/).
## TenFourFox no longer supports plugins or Flash ##
Plugins on PowerPC are of special concern because Mozilla is making updates to their plugin architecture which may require the plugins themselves to be updated, and there are certain difficult-to-correct bugs with them already on Tiger. Most importantly, QuickTime, Java and Adobe Flash for PowerPC are no longer maintained and have known security risks that can crash, perform malicious operations or leak data, and Flash 10.1 is rapidly becoming unsupported by many applications.
**As of TenFourFox 6.0, for these and other reasons (for details, see PluginsNoLongerSupported), plugin support ships disabled.** Plugins will not operate by default, and bug reports will no longer be accepted. Sites will now act as if no plugins were installed at all.
For Internet video, we now recommend the use of TenFourFox's optional QuickTimeEnabler. This allows many videos to be handled in QuickTime Player directly.
You can also download videos for separate viewing using [Perian](http://www.perian.org/) and any of the available video download add-ons for Firefox.
For YouTube, you may also be able to use [MacTubes](http://macapps.sakura.ne.jp/mactubes/index_en.html). If you have a high end G4 or G5, you can also use WebM for selected videos by visiting http://www.youtube.com/html5 and enabling HTML5 video. This will set a temporary cookie enabling browser-based video without Flash. You do not need a YouTube account for this feature, but you may need to periodically renew the cookie setting. Not all video is available in WebM.
For a more in-depth explanation of this policy and other workarounds, see PluginsNoLongerSupported.
## New features in this version of TenFourFox ##
* All new standard features of Firefox 14 where supported, including optimized awesome bar suggestions and improved graphic performance.
* Reduced latency in the JavaScript interpreter ([issue 160](https://code.google.com/p/tenfourfox/issues/detail?id=160)).
## Known issues specific to TenFourFox ##
* Remember: **Plugins are turned off by default, and code for them will fail to function entirely in a subsequent version.** See PluginsNoLongerSupported for an explanation and suggested workarounds. Please note that out-of-process plugins have never been supported.
* As of TenFourFox 8, TenFourFox uses a lighter chrome for windows and dialogue boxes than prior versions or the official Mac Firefox. This is intentional.
* 10.4Fx does not currently support WebGL, and scripts such as Arabic or Indic requiring glyph reordering or language-specific ligatures may not appear correctly. See TechnicalDifferences for the complete list of changes necessary for 10.4Fx. See [issue 5](https://code.google.com/p/tenfourfox/issues/detail?id=5) for notes specific to the font issue.
* The titlebar does not always properly match the menu gradient ([issue 16](https://code.google.com/p/tenfourfox/issues/detail?id=16)). This problem is also in the official release. Installing a Persona may fix this issue if you find it bothersome.
* Crash reporting is intentionally disabled to avoid polluting Mozilla's crash tracking system with our reports. Please use your system's crash logs if you are reporting a _reproducible_ crash, or (if you are able) provide a `gdb` backtrace.
* Although 10.4Fx will tell you when an update is available, you must download updates manually at this time.
You are welcome to report other bugs that you find. However, please **do not report Mozilla bugs to us.** If the bug or crash occurs in both the official Mozilla Firefox 14 _(3.6 doesn't count!)_ and in 10.4Fx, this is a Mozilla bug, and you should file it at [Bugzilla](http://bugzilla.mozilla.org/). **You must test your bug in both places -- bugs that are not confirmed to be part of 10.4Fx will be marked invalid** so that we can keep our task list focused. This is the [current list of known issues](http://code.google.com/p/tenfourfox/issues/list).

61
ReleaseNotes150.md Normal file
View File

@ -0,0 +1,61 @@
_This document may be updated for late-breaking changes, so check back here if you are having difficulty._
## System requirements ##
TenFourFox (hereafter "10.4Fx") requires a G3 Power Macintosh, Mac OS X 10.4.11, 100MB of free disk space and 512MB of RAM. 1GB of RAM and a G4 or G5 processor is recommended. Video playback is likely to be poor on systems slower than 1.25GHz; a G5 is recommended. Mac OS X 10.5.8 is supported.
Intel Macintoshes are not supported, but the G3 build is known to run under Rosetta in 10.4.11, 10.5.8 and 10.6.8. Because Apple no longer supports Rosetta and 10.4Fx is not a Universal binary, it will not run under Lion 10.7 or any future version of Mac OS X.
## Getting TenFourFox ##
Make sure you select the appropriate build for your Mac from the [download page](http://www.tenfourfox.com/). The G3 version will run on any supported Macintosh, but it will not take advantage of the additional features of G4 or G5 processors. The G4 and G5 versions will not run at all on a G3, and the G5 version will perform badly or crash on non-G5 Macintoshes.
If you are using a G4, you should try to choose the correct version for your processor generation (7400 or 7450 "G4e") as performance may be impaired if you run the wrong one. If you don't know which G4 processor you have, the instructions in WhichVersion will tell you how to find out.
## TenFourFox 15 is equivalent to Firefox 15 ##
TenFourFox uses modified Firefox source code, rewritten to remain compatible with Mac OS X v10.4 and the Power Macintosh. It also contains specific optimizations and special features for PowerPC processors. For this reason, it is not exactly the same as Firefox. However, it is intended to be as compatible with it as possible, including most add-ons and [most standard features](TechnicalDifferences.md). You can treat 10.4Fx 14 as equivalent with Firefox 15 in most circumstances, with specific exceptions noted below.
Note that add-ons which require an Intel Macintosh will not work with TenFourFox, even if they are otherwise compatible with Firefox 15, and add-ons that require 10.5 Leopard may not be compatible with TenFourFox running on Mac OS X 10.4 Tiger, even if they are compatible with PowerPC.
## This branch of TenFourFox is the _unstable_ version ##
Starting with Firefox 10, Mozilla is now offering an extended support release version of Firefox ("Firefox **ESR**") intended for environments where users are unable to use rapid-release versions of Firefox due to policy or technical constraints. 10.4Fx 10.x is based on this extended support release and is intended for users who wish to remain with a stable browser core. The _stable_ branch will continue to receive bugfixes and security updates, but will not receive new Firefox features (although it may receive certain 10.4Fx-specific features judged important for our legacy users).
However, for more proficient users who want to try more up-to-date features and help us test new builds of 10.4Fx based on current releases of Firefox, we make available the _unstable_ branch, which is this release. **While the unstable branch is generally suitable for day-to-day use, it does have bugs and is recommended only for advanced users.** Although major bugs will be repaired as promptly as possible, minor and even some moderate severity bugs might not be fixed on a particular timetable. The highest priority is to keep the port viable, which may mean diverting our limited time away from non-critical issues. **If you need a release-quality version of TenFourFox, please use the stable version instead.** You can download the stable version from [our main page](http://www.tenfourfox.com/).
## TenFourFox no longer supports plugins or Flash ##
Plugins on PowerPC are of special concern because Mozilla is making updates to their plugin architecture which may require the plugins themselves to be updated, and there are certain difficult-to-correct bugs with them already on Tiger. Most importantly, QuickTime, Java and Adobe Flash for PowerPC are no longer maintained and have known security risks that can crash, perform malicious operations or leak data, and Flash 10.1 is rapidly becoming unsupported by many applications.
**As of TenFourFox 6.0, for these and other reasons (for details, see PluginsNoLongerSupported), plugin support ships disabled.** Plugins will not operate by default, and bug reports will no longer be accepted. Sites will now act as if no plugins were installed at all.
For Internet video, we now recommend the use of TenFourFox's optional QuickTimeEnabler. This allows many videos to be handled in QuickTime Player directly.
You can also download videos for separate viewing using [Perian](http://www.perian.org/) and any of the available video download add-ons for Firefox.
For YouTube, you may also be able to use [MacTubes](http://macapps.sakura.ne.jp/mactubes/index_en.html). If you have a high end G4 or G5, you can also use WebM for selected videos by visiting http://www.youtube.com/html5 and enabling HTML5 video. This will set a temporary cookie enabling browser-based video without Flash. You do not need a YouTube account for this feature, but you may need to periodically renew the cookie setting. Not all video is available in WebM.
For a more in-depth explanation of this policy and other workarounds, see PluginsNoLongerSupported.
## New features in this version of TenFourFox ##
* All new standard features of Firefox 15 where supported, including memory usage optimizations and improved developer tools.
* Faster JavaScript typed arrays ([issue 167](https://code.google.com/p/tenfourfox/issues/detail?id=167)).
* Improved JavaScript performance on G5 ([issue 174](https://code.google.com/p/tenfourfox/issues/detail?id=174)).
## Known issues fixed in this version of TenFourFox ##
* Window activation responds more quickly ([issue 168](https://code.google.com/p/tenfourfox/issues/detail?id=168)).
## Known issues specific to TenFourFox ##
* Remember: **Plugins are turned off by default, and code for them will fail to function entirely in a subsequent version.** See PluginsNoLongerSupported for an explanation and suggested workarounds. Please note that out-of-process plugins have never been supported.
* TenFourFox does not currently support the Firefox webapp runtime.
* As of TenFourFox 8, TenFourFox uses a lighter chrome for windows and dialogue boxes than prior versions or the official Mac Firefox. This is intentional.
* 10.4Fx does not currently support WebGL, and scripts such as Arabic or Indic requiring glyph reordering or language-specific ligatures may not appear correctly. See TechnicalDifferences for the complete list of changes necessary for 10.4Fx. See [issue 5](https://code.google.com/p/tenfourfox/issues/detail?id=5) for notes specific to the font issue.
* The titlebar does not always properly match the menu gradient ([issue 16](https://code.google.com/p/tenfourfox/issues/detail?id=16)). This problem is also in the official release. Installing a Persona may fix this issue if you find it bothersome.
* Crash reporting is intentionally disabled to avoid polluting Mozilla's crash tracking system with our reports. Please use your system's crash logs if you are reporting a _reproducible_ crash, or (if you are able) provide a `gdb` backtrace.
* Although 10.4Fx will tell you when an update is available, you must download updates manually at this time.
You are welcome to report other bugs that you find. However, please **do not report Mozilla bugs to us.** If the bug or crash occurs in both the official Mozilla Firefox 15 _(3.6 doesn't count!)_ and in 10.4Fx, this is a Mozilla bug, and you should file it at [Bugzilla](http://bugzilla.mozilla.org/). **You must test your bug in both places -- bugs that are not confirmed to be part of 10.4Fx will be marked invalid** so that we can keep our task list focused. This is the [current list of known issues](http://code.google.com/p/tenfourfox/issues/list).

55
ReleaseNotes1501.md Normal file
View File

@ -0,0 +1,55 @@
_This document may be updated for late-breaking changes, so check back here if you are having difficulty._
## System requirements ##
TenFourFox (hereafter "10.4Fx") requires a G3 Power Macintosh, Mac OS X 10.4.11, 100MB of free disk space and 512MB of RAM. 1GB of RAM and a G4 or G5 processor is recommended. Video playback is likely to be poor on systems slower than 1.25GHz; a G5 is recommended. Mac OS X 10.5.8 is supported.
Intel Macintoshes are not supported, but the G3 build is known to run under Rosetta in 10.4.11, 10.5.8 and 10.6.8. Because Apple no longer supports Rosetta and 10.4Fx is not a Universal binary, it will not run under Lion 10.7 or any future version of Mac OS X.
## Getting TenFourFox ##
Make sure you select the appropriate build for your Mac from the [download page](http://www.tenfourfox.com/). The G3 version will run on any supported Macintosh, but it will not take advantage of the additional features of G4 or G5 processors. The G4 and G5 versions will not run at all on a G3, and the G5 version will perform badly or crash on non-G5 Macintoshes.
If you are using a G4, you should try to choose the correct version for your processor generation (7400 or 7450 "G4e") as performance may be impaired if you run the wrong one. If you don't know which G4 processor you have, the instructions in WhichVersion will tell you how to find out.
## TenFourFox 15 is equivalent to Firefox 15 ##
TenFourFox uses modified Firefox source code, rewritten to remain compatible with Mac OS X v10.4 and the Power Macintosh. It also contains specific optimizations and special features for PowerPC processors. For this reason, it is not exactly the same as Firefox. However, it is intended to be as compatible with it as possible, including most add-ons and [most standard features](TechnicalDifferences.md). You can treat 10.4Fx 14 as equivalent with Firefox 15 in most circumstances, with specific exceptions noted below.
Note that add-ons which require an Intel Macintosh will not work with TenFourFox, even if they are otherwise compatible with Firefox 15, and add-ons that require 10.5 Leopard may not be compatible with TenFourFox running on Mac OS X 10.4 Tiger, even if they are compatible with PowerPC.
## This branch of TenFourFox is the _unstable_ version ##
Starting with Firefox 10, Mozilla is now offering an extended support release version of Firefox ("Firefox **ESR**") intended for environments where users are unable to use rapid-release versions of Firefox due to policy or technical constraints. 10.4Fx 10.x is based on this extended support release and is intended for users who wish to remain with a stable browser core. The _stable_ branch will continue to receive bugfixes and security updates, but will not receive new Firefox features (although it may receive certain 10.4Fx-specific features judged important for our legacy users).
However, for more proficient users who want to try more up-to-date features and help us test new builds of 10.4Fx based on current releases of Firefox, we make available the _unstable_ branch, which is this release. **While the unstable branch is generally suitable for day-to-day use, it does have bugs and is recommended only for advanced users.** Although major bugs will be repaired as promptly as possible, minor and even some moderate severity bugs might not be fixed on a particular timetable. The highest priority is to keep the port viable, which may mean diverting our limited time away from non-critical issues. **If you need a release-quality version of TenFourFox, please use the stable version instead.** You can download the stable version from [our main page](http://www.tenfourfox.com/).
## TenFourFox no longer supports plugins or Flash ##
Plugins on PowerPC are of special concern because Mozilla is making updates to their plugin architecture which may require the plugins themselves to be updated, and there are certain difficult-to-correct bugs with them already on Tiger. Most importantly, QuickTime, Java and Adobe Flash for PowerPC are no longer maintained and have known security risks that can crash, perform malicious operations or leak data, and Flash 10.1 is rapidly becoming unsupported by many applications.
**As of TenFourFox 6.0, for these and other reasons (for details, see PluginsNoLongerSupported), plugin support ships disabled.** Plugins will not operate by default, and bug reports will no longer be accepted. Sites will now act as if no plugins were installed at all.
For Internet video, we now recommend the use of TenFourFox's optional QuickTimeEnabler. This allows many videos to be handled in QuickTime Player directly.
You can also download videos for separate viewing using [Perian](http://www.perian.org/) and any of the available video download add-ons for Firefox.
For YouTube, you may also be able to use [MacTubes](http://macapps.sakura.ne.jp/mactubes/index_en.html). If you have a high end G4 or G5, you can also use WebM for selected videos by visiting http://www.youtube.com/html5 and enabling HTML5 video. This will set a temporary cookie enabling browser-based video without Flash. You do not need a YouTube account for this feature, but you may need to periodically renew the cookie setting. Not all video is available in WebM.
For a more in-depth explanation of this policy and other workarounds, see PluginsNoLongerSupported.
## Known issues fixed in this version of TenFourFox ##
* Private browsing mode no longer improperly records activity to the cache (Mozilla [bug 787743](https://code.google.com/p/tenfourfox/issues/detail?id=87743)). This issue does not affect TenFourFox 10.0.7 or any version prior to 15.0.
## Known issues specific to TenFourFox ##
* Remember: **Plugins are turned off by default, and code for them will fail to function entirely in a subsequent version.** See PluginsNoLongerSupported for an explanation and suggested workarounds. Please note that out-of-process plugins have never been supported.
* TenFourFox does not currently support the Firefox webapp runtime.
* As of TenFourFox 8, TenFourFox uses a lighter chrome for windows and dialogue boxes than prior versions or the official Mac Firefox. This is intentional.
* 10.4Fx does not currently support WebGL, and scripts such as Arabic or Indic requiring glyph reordering or language-specific ligatures may not appear correctly. See TechnicalDifferences for the complete list of changes necessary for 10.4Fx. See [issue 5](https://code.google.com/p/tenfourfox/issues/detail?id=5) for notes specific to the font issue.
* The titlebar does not always properly match the menu gradient ([issue 16](https://code.google.com/p/tenfourfox/issues/detail?id=16)). This problem is also in the official release. Installing a Persona may fix this issue if you find it bothersome.
* Crash reporting is intentionally disabled to avoid polluting Mozilla's crash tracking system with our reports. Please use your system's crash logs if you are reporting a _reproducible_ crash, or (if you are able) provide a `gdb` backtrace.
* Although 10.4Fx will tell you when an update is available, you must download updates manually at this time.
You are welcome to report other bugs that you find. However, please **do not report Mozilla bugs to us.** If the bug or crash occurs in both the official Mozilla Firefox 15 _(3.6 doesn't count!)_ and in 10.4Fx, this is a Mozilla bug, and you should file it at [Bugzilla](http://bugzilla.mozilla.org/). **You must test your bug in both places -- bugs that are not confirmed to be part of 10.4Fx will be marked invalid** so that we can keep our task list focused. This is the [current list of known issues](http://code.google.com/p/tenfourfox/issues/list).

70
ReleaseNotes170.md Normal file
View File

@ -0,0 +1,70 @@
_This document may be updated for late-breaking changes, so check back here if you are having difficulty._
## System requirements ##
TenFourFox (hereafter "10.4Fx") requires a G3 Power Macintosh, Mac OS X 10.4.11, 100MB of free disk space and 512MB of RAM. 1GB of RAM and a G4 or G5 processor is recommended. Video playback is likely to be poor on systems slower than 1.25GHz; a G5 is recommended. Mac OS X 10.5.8 is supported.
Intel Macintoshes are not supported, although some users have reported success getting it to run under Rosetta. Certain features may not work correctly on Intel Macs (see [the FAQ](AAATheFAQ.md)). Because Apple no longer supports Rosetta and 10.4Fx is not a Universal binary, it will not run under Lion 10.7 or any subsequent version of Mac OS X.
## Getting TenFourFox ##
Make sure you select the appropriate build for your Mac from the [download page](http://www.tenfourfox.com/). The G3 version will run on any supported Macintosh, but it will not take advantage of the additional features of G4 or G5 processors. The G4 and G5 versions will not run at all on a G3, and the G5 version will perform badly or crash on non-G5 Macintoshes.
If you are using a G4, you should try to choose the correct version for your processor generation (7400 or 7450 "G4e") as performance may be impaired if you run the wrong one. If you don't know which G4 processor you have, the instructions in WhichVersion will tell you how to find out.
## TenFourFox 17 is equivalent to Firefox 17 ##
TenFourFox uses modified Firefox source code, rewritten to remain compatible with Mac OS X v10.4 and the Power Macintosh. It also contains specific optimizations and special features for PowerPC processors. For this reason, it is not exactly the same as Firefox. However, it is intended to be as compatible with it as possible, including most add-ons and [most standard features](TechnicalDifferences.md). You can treat 10.4Fx 17 as equivalent with Firefox 17 in most circumstances, with specific exceptions noted below.
Note that add-ons which require an Intel Macintosh will not work with TenFourFox, even if they are otherwise compatible with Firefox 17, and add-ons that require 10.5 Leopard may not be compatible with TenFourFox running on Mac OS X 10.4 Tiger, even if they are compatible with PowerPC.
## This branch of TenFourFox is the stable version ##
Starting with Firefox 10, Mozilla began offering an extended support release version of Firefox ("Firefox **ESR**") intended for environments where users are unable to use rapid-release versions of Firefox due to policy or technical constraints. This ESR is the basis of the TenFourFox **stable** branch.
The current ESR release is based on Firefox 17. 10.4Fx 17.x is based on this extended support release and is intended for users who wish to remain with a stable browser core. The stable branch will continue to receive bugfixes and security updates, but will not receive new Firefox features (although it may receive certain 10.4Fx-specific features judged important for our legacy users).
**We recommend this version for most of our users.** If you wish to help test our continuing porting efforts, you can try the _unstable_ branch, which is based on the current release of Firefox. _The unstable branch does have bugs and is recommended only for advanced users._ For more information, see the [TenFourFox Development](http://tenfourfox.blogspot.com/) blog.
## TenFourFox no longer supports plugins or Flash ##
Plugins on PowerPC are of special concern because Mozilla is making updates to their plugin architecture which may require the plugins themselves to be updated, and there are certain difficult-to-correct bugs with them already on Tiger. Most importantly, QuickTime, Java and Adobe Flash for PowerPC are no longer maintained and have known security risks that can crash, perform malicious operations or leak data, and Flash 10.1 is rapidly becoming unsupported by many applications.
**For these and other reasons (for details, see PluginsNoLongerSupported), plugin support ships disabled.** Plugins will not operate by default, and bug reports will no longer be accepted. Sites will now act as if no plugins were installed at all. Plugin support will be completely decommissioned in version 18 due to incompatible browser changes.
For Internet video, we now recommend the use of TenFourFox's optional QuickTimeEnabler. This allows many videos to be handled in QuickTime Player directly.
You can also download videos for separate viewing using [Perian](http://www.perian.org/) and any of the available video download add-ons for Firefox.
For YouTube, you may also be able to use [MacTubes](http://macapps.sakura.ne.jp/mactubes/index_en.html). If you have a high end G4 or G5, you can also use WebM for selected videos by visiting http://www.youtube.com/html5 and enabling HTML5 video. This will set a temporary cookie enabling browser-based video without Flash. You do not need a YouTube account for this feature, but you may need to periodically renew the cookie setting. Not all video is available in WebM.
For a more in-depth explanation of this policy and other workarounds, see PluginsNoLongerSupported.
## New features in this new stable version of TenFourFox ##
* All supported standard features of Firefox 11 through Firefox 17, including improved JavaScript performance, CoreGraphics accelerated canvas, faster screen updates, additional HTML5 and CSS 3 features, SPDY-enhanced encrypted networking, a smarter URL bar, integrated downloads and new web developer features.
## Fixed after the alpha and beta releases of TenFourFox 17 ##
* Canvas elements now properly update ([issue 180](https://code.google.com/p/tenfourfox/issues/detail?id=180), Mozilla [bug 794337](https://code.google.com/p/tenfourfox/issues/detail?id=94337)).
* Performance is improved on multiprocessor Macintoshes ([issue 191](https://code.google.com/p/tenfourfox/issues/detail?id=191)).
## Fixed in this version of TenFourFox ##
* Downloading files that were previously handled by plugins now works correctly ([issue 188](https://code.google.com/p/tenfourfox/issues/detail?id=188)). This affects all versions of 10.4Fx, but will not be backported to 10.0.x due to internal API differences.
* TenFourFox will ignore bitmap-only fonts which it cannot render ([issue 171](https://code.google.com/p/tenfourfox/issues/detail?id=171)). A fallback font will be selected instead. This affects all versions of 10.4Fx, but will not be backported to 10.0.x due to differences in font code.
* It is now also possible to blacklist Arial, Helvetica and/or Times (or any other combination) for users with corrupt or abnormal versions of these fonts ([issue 171](https://code.google.com/p/tenfourfox/issues/detail?id=171)). See [this Tenderapp ticket](http://tenfourfox.tenderapp.com/discussions/problems/2-italic-display) for information about when and how to use this blacklist. This affects all versions of 10.4Fx, but will not be backported to 10.0.x due to differences in font code.
* The No Thanks button in the update dialogue now works correctly ([issue 130](https://code.google.com/p/tenfourfox/issues/detail?id=130)). This affects 10 through 15. This fix is in 10.0.11.
* You can now search bookmarks again ([issue 177](https://code.google.com/p/tenfourfox/issues/detail?id=177)). This affects 13 through 15. This issue does not affect 10.0.x.
## Known issues specific to TenFourFox ##
* Remember: **Plugins are turned off by default, and code for them will fail to function entirely in version 18 and later.** See PluginsNoLongerSupported for an explanation and suggested workarounds. Please note that out-of-process plugins have never been supported.
* TenFourFox uses a lighter chrome for windows and dialogue boxes than prior versions or the official Mac Firefox. This is intentional.
* Bitmap-only fonts (usually Type 1 PostScript) cannot be used by the 10.4Fx font renderer and are discarded. A fallback font will be used in their place.
* 10.4Fx does not currently support WebGL, WebRTC or the webapp runtime, and scripts such as Arabic or Indic requiring glyph reordering or language-specific ligatures may not appear correctly. See TechnicalDifferences for the complete list of changes necessary for 10.4Fx. See [issue 5](https://code.google.com/p/tenfourfox/issues/detail?id=5) for notes specific to the font issue.
* The titlebar does not always properly match the menu gradient ([issue 16](https://code.google.com/p/tenfourfox/issues/detail?id=16)). This problem is also in the official release. Installing a Persona may fix this issue if you find it bothersome.
* Crash reporting is intentionally disabled to avoid polluting Mozilla's crash tracking system with our reports. Please use your system's crash logs if you are reporting a _reproducible_ crash, or (if you are able) provide a `gdb` backtrace.
* Although 10.4Fx will tell you when an update is available, you must download updates manually at this time.
You are welcome to report other bugs that you find. However, please **do not report Mozilla bugs to us.** If the bug or crash occurs in both the official Mozilla Firefox 17 _(3.6 doesn't count!)_ and in 10.4Fx, this is a Mozilla bug, and you should file it at [Bugzilla](http://bugzilla.mozilla.org/). **You must test your bug in both places -- bugs that are not confirmed to be part of 10.4Fx will be marked invalid** so that we can keep our task list focused. This is the [current list of known issues](http://code.google.com/p/tenfourfox/issues/list).

60
ReleaseNotes1701.md Normal file
View File

@ -0,0 +1,60 @@
_This document may be updated for late-breaking changes, so check back here if you are having difficulty._
## System requirements ##
TenFourFox (hereafter "10.4Fx") requires a G3 Power Macintosh, Mac OS X 10.4.11, 100MB of free disk space and 512MB of RAM. 1GB of RAM and a G4 or G5 processor is recommended. Video playback is likely to be poor on systems slower than 1.25GHz; a G5 is recommended. Mac OS X 10.5.8 is supported.
Intel Macintoshes are not supported. Although some users have reported success getting the G3 version of 10.4Fx to run under Rosetta, certain features may not work correctly or at all on Intel Macs, and you may need to completely disable JavaScript compilation for it to work with Rosetta (see [the FAQ](AAATheFAQ.md) for more information). Because Apple no longer supports Rosetta and 10.4Fx is not a Universal binary, it will not run under Lion 10.7 or any subsequent version of Mac OS X.
## Getting TenFourFox ##
Make sure you select the appropriate build for your Mac from the [download page](http://www.tenfourfox.com/). The G3 version will run on any supported Macintosh, but it will not take advantage of the additional features of G4 or G5 processors. The G4 and G5 versions will not run at all on a G3, and the G5 version will perform badly or crash on non-G5 Macintoshes.
If you are using a G4, you should try to choose the correct version for your processor generation (7400 or 7450 "G4e") as performance may be impaired if you run the wrong one. If you don't know which G4 processor you have, the instructions in WhichVersion will tell you how to find out.
## TenFourFox 17 is equivalent to Firefox 17 ##
TenFourFox uses modified Firefox source code, rewritten to remain compatible with Mac OS X v10.4 and the Power Macintosh. It also contains specific optimizations and special features for PowerPC processors. For this reason, it is not exactly the same as Firefox. However, it is intended to be as compatible with it as possible, including most add-ons and [most standard features](TechnicalDifferences.md). You can treat 10.4Fx 17 as equivalent with Firefox 17 in most circumstances, with specific exceptions noted below.
Note that add-ons which require an Intel Macintosh will not work with TenFourFox, even if they are otherwise compatible with Firefox 17, and add-ons that require 10.5 Leopard may not be compatible with TenFourFox running on Mac OS X 10.4 Tiger, even if they are compatible with PowerPC.
## This branch of TenFourFox is the stable version ##
Starting with Firefox 10, Mozilla began offering an extended support release version of Firefox ("Firefox **ESR**") intended for environments where users are unable to use rapid-release versions of Firefox due to policy or technical constraints. This ESR is the basis of the TenFourFox **stable** branch.
The current ESR release is based on Firefox 17. 10.4Fx 17.x is based on this extended support release and is intended for users who wish to remain with a stable browser core. The stable branch will continue to receive bugfixes and security updates, but will not receive new Firefox features (although it may receive certain 10.4Fx-specific features judged important for our legacy users).
**We recommend this version for most of our users.** If you wish to help test our continuing porting efforts, you can try the _unstable_ branch, which is based on the current release of Firefox. _The unstable branch does have bugs and is recommended only for advanced users._ For more information, see the [TenFourFox Development](http://tenfourfox.blogspot.com/) blog.
## TenFourFox no longer supports plugins or Flash ##
Plugins on PowerPC are of special concern because Mozilla is making updates to their plugin architecture which may require the plugins themselves to be updated, and there are certain difficult-to-correct bugs with them already on Tiger. Most importantly, QuickTime, Java and Adobe Flash for PowerPC are no longer maintained and have known security risks that can crash, perform malicious operations or leak data, and Flash 10.1 is rapidly becoming unsupported by many applications.
**For these and other reasons (for details, see PluginsNoLongerSupported), plugin support ships disabled.** Plugins will not operate by default, and bug reports will no longer be accepted. Sites will now act as if no plugins were installed at all. Plugin support will be completely decommissioned in version 18 due to incompatible browser changes.
For Internet video, we now recommend the use of TenFourFox's optional QuickTimeEnabler. This allows many videos to be handled in QuickTime Player directly.
You can also download videos for separate viewing using [Perian](http://www.perian.org/) and any of the available video download add-ons for Firefox.
For YouTube, you may also be able to use [MacTubes](http://macapps.sakura.ne.jp/mactubes/index_en.html). If you have a high end G4 or G5, you can also use WebM for selected videos by visiting http://www.youtube.com/html5 and enabling HTML5 video. This will set a temporary cookie enabling browser-based video without Flash. You do not need a YouTube account for this feature, but you may need to periodically renew the cookie setting. Not all video is available in WebM.
For a more in-depth explanation of this policy and other workarounds, see PluginsNoLongerSupported.
## Fixed in this version of TenFourFox ##
* All regression, stability and security fixes from Firefox ESR 17.0.1, including fixes for Bing Maps, private browsing and certain banking sites.
* Threading and interprocess operations now have reduced overhead ([issue 191](https://code.google.com/p/tenfourfox/issues/detail?id=191)), improving overall browser performance.
If you are new to version 17, please also see the [features and fixes in 17.0](ReleaseNotes170.md).
## Known issues specific to TenFourFox ##
* Remember: **Plugins are turned off by default, and code for them will fail to function entirely in version 18 and later.** See PluginsNoLongerSupported for an explanation and suggested workarounds. Please note that out-of-process plugins have never been supported.
* TenFourFox uses a lighter chrome for windows and dialogue boxes than prior versions or the official Mac Firefox. This is intentional.
* Bitmap-only fonts (usually Type 1 PostScript) cannot be used by the 10.4Fx font renderer and are discarded. A fallback font will be used in their place.
* 10.4Fx does not currently support WebGL, WebRTC or the webapp runtime, and scripts such as Arabic or Indic requiring glyph reordering or language-specific ligatures may not appear correctly. See TechnicalDifferences for the complete list of changes necessary for 10.4Fx. See [issue 5](https://code.google.com/p/tenfourfox/issues/detail?id=5) for notes specific to the font issue.
* The titlebar does not always properly match the menu gradient ([issue 16](https://code.google.com/p/tenfourfox/issues/detail?id=16)). This problem is also in the official release. Installing a Persona may fix this issue if you find it bothersome.
* Crash reporting is intentionally disabled to avoid polluting Mozilla's crash tracking system with our reports. Please use your system's crash logs if you are reporting a _reproducible_ crash, or (if you are able) provide a `gdb` backtrace.
* Although 10.4Fx will tell you when an update is available, you must download updates manually at this time.
You are welcome to report other bugs that you find. However, please **do not report Mozilla bugs to us.** If the bug or crash occurs in both the official Mozilla Firefox 17 _(3.6 doesn't count!)_ and in 10.4Fx, this is a Mozilla bug, and you should file it at [Bugzilla](http://bugzilla.mozilla.org/). **You must test your bug in both places -- bugs that are not confirmed to be part of 10.4Fx will be marked invalid** so that we can keep our task list focused. This is the [current list of known issues](http://code.google.com/p/tenfourfox/issues/list).

59
ReleaseNotes17010.md Normal file
View File

@ -0,0 +1,59 @@
_This document may be updated for late-breaking changes, so check back here if you are having difficulty._
## System requirements ##
TenFourFox (hereafter "10.4Fx") requires a G3 Power Macintosh, Mac OS X 10.4.11, 100MB of free disk space and 512MB of RAM. 1GB of RAM and a G4 or G5 processor is recommended. Video playback is likely to be poor on systems slower than 1.25GHz; a G5 is recommended. Mac OS X 10.5.8 is supported.
Intel Macintoshes are not supported. Although some users have reported success getting the G3 version of 10.4Fx to run under Rosetta, certain features may not work correctly or at all on Intel Macs, and you may need to completely disable JavaScript compilation for it to work with Rosetta (see [the FAQ](AAATheFAQ.md) for more information). Because Apple no longer supports Rosetta and 10.4Fx is not a Universal binary, it will not run under Lion 10.7 or any subsequent version of Mac OS X.
## Getting TenFourFox ##
Make sure you select the appropriate build for your Mac from the [download page](http://www.tenfourfox.com/). The G3 version will run on any supported Macintosh, but it will not take advantage of the additional features of G4 or G5 processors. The G4 and G5 versions will not run at all on a G3, and the G5 version will perform badly or crash on non-G5 Macintoshes.
If you are using a G4, you should try to choose the correct version for your processor generation (7400 or 7450 "G4e") as performance may be impaired if you run the wrong one. If you don't know which G4 processor you have, the instructions in WhichVersion will tell you how to find out.
## TenFourFox 17 is equivalent to Firefox 17 ##
TenFourFox uses modified Firefox source code, rewritten to remain compatible with Mac OS X v10.4 and the Power Macintosh. It also contains specific optimizations and special features for PowerPC processors. For this reason, it is not exactly the same as Firefox. However, it is intended to be as compatible with it as possible, including most add-ons and [most standard features](TechnicalDifferences.md). You can treat 10.4Fx 17 as equivalent with Firefox 17 in most circumstances, with specific exceptions noted below.
Note that add-ons which require an Intel Macintosh will not work with TenFourFox, even if they are otherwise compatible with Firefox 17, and add-ons that require 10.5 Leopard may not be compatible with TenFourFox running on Mac OS X 10.4 Tiger, even if they are compatible with PowerPC.
## This branch of TenFourFox is the stable version ##
Starting with Firefox 10, Mozilla began offering an extended support release version of Firefox ("Firefox **ESR**") intended for environments where users are unable to use rapid-release versions of Firefox due to policy or technical constraints. This ESR is the basis of the TenFourFox **stable** branch.
The current ESR release is based on Firefox 17. 10.4Fx 17.x is based on this extended support release and is intended for users who wish to remain with a stable browser core. The stable branch will continue to receive bugfixes and security updates, but will not receive new Firefox features (although it may receive certain 10.4Fx-specific features judged important for our legacy users).
**We recommend this version for most of our users.** If you wish to help test our continuing porting efforts, you can try the _unstable_ branch, which is based on the current release of Firefox. _The unstable branch does have bugs and is recommended only for advanced users._ For more information, see the [TenFourFox Development](http://tenfourfox.blogspot.com/) blog.
## TenFourFox no longer supports plugins or Flash ##
Plugins on PowerPC are of special concern because Mozilla is making updates to their plugin architecture which may require the plugins themselves to be updated, and there are certain difficult-to-correct bugs with them already on Tiger. Most importantly, QuickTime, Java and Adobe Flash for PowerPC are no longer maintained and have known security risks that can crash, perform malicious operations or leak data, and Flash 10.1 is rapidly becoming unsupported by many applications.
**For these and other reasons (for details, see PluginsNoLongerSupported), plugin support ships disabled.** Plugins will not operate by default, and bug reports will no longer be accepted. Sites will now act as if no plugins were installed at all. Plugin support will be completely decommissioned in version 18 due to incompatible browser changes.
For Internet video, we now recommend the use of TenFourFox's optional QuickTimeEnabler. This allows many videos to be handled in QuickTime Player directly.
You can also download videos for separate viewing using [Perian](http://www.perian.org/) and any of the available video download add-ons for Firefox.
For YouTube, you may also be able to use [MacTubes](http://macapps.sakura.ne.jp/mactubes/index_en.html). If you have a high end G4 or G5, you can also use WebM for selected videos by visiting http://www.youtube.com/html5 and enabling HTML5 video. This will set a temporary cookie enabling browser-based video without Flash. You do not need a YouTube account for this feature, but you may need to periodically renew the cookie setting. Not all video is available in WebM.
For a more in-depth explanation of this policy and other workarounds, see PluginsNoLongerSupported.
## Fixed in this version of TenFourFox ##
* All security and stability fixes from Firefox ESR 17.0.10.
## Known issues specific to TenFourFox ##
* Remember: **Plugins are turned off by default, and code for them will fail to function entirely in version 18 and later.** See PluginsNoLongerSupported for an explanation and suggested workarounds. Please note that out-of-process plugins have never been supported.
* TenFourFox uses a lighter chrome for windows and dialogue boxes than prior versions or the official Mac Firefox. This is intentional.
* Systems with large numbers of fonts installed may experience intermittent pauses.
* Some pages may perform better on 10.5 systems than 10.4 ([issue 193](https://code.google.com/p/tenfourfox/issues/detail?id=193)).
* Bitmap-only fonts (usually Type 1 PostScript) cannot be used by the 10.4Fx font renderer and are discarded. A fallback font will be used in their place.
* 10.4Fx does not currently support WebGL, WebRTC or the webapp runtime, and scripts such as Arabic or Indic requiring glyph reordering or language-specific ligatures may not appear correctly. See TechnicalDifferences for the complete list of changes necessary for 10.4Fx. See [issue 5](https://code.google.com/p/tenfourfox/issues/detail?id=5) for notes specific to the font issue.
* The titlebar does not always properly match the menu gradient ([issue 16](https://code.google.com/p/tenfourfox/issues/detail?id=16)). This problem is also in the official release. Installing a Persona may fix this issue if you find it bothersome.
* Crash reporting is intentionally disabled to avoid polluting Mozilla's crash tracking system with our reports. Please use your system's crash logs if you are reporting a _reproducible_ crash, or (if you are able) provide a `gdb` backtrace.
* Although 10.4Fx will tell you when an update is available, you must download updates manually at this time.
You are welcome to report other bugs that you find. However, please **do not report Mozilla bugs to us.** If the bug or crash occurs in both the official Mozilla Firefox 17 _(3.6 doesn't count!)_ and in 10.4Fx, this is a Mozilla bug, and you should file it at [Bugzilla](http://bugzilla.mozilla.org/). **You must test your bug in both places -- bugs that are not confirmed to be part of 10.4Fx will be marked invalid** so that we can keep our task list focused. This is the [current list of known issues](http://code.google.com/p/tenfourfox/issues/list).

63
ReleaseNotes17011.md Normal file
View File

@ -0,0 +1,63 @@
_This document may be updated for late-breaking changes, so check back here if you are having difficulty._
## System requirements ##
TenFourFox (hereafter "10.4Fx") requires a G3 Power Macintosh, Mac OS X 10.4.11, 100MB of free disk space and 512MB of RAM. 1GB of RAM and a G4 or G5 processor is recommended. Video playback is likely to be poor on systems slower than 1.25GHz; a G5 is recommended. Mac OS X 10.5.8 is supported.
Intel Macintoshes are not supported. Although some users have reported success getting the G3 version of 10.4Fx to run under Rosetta, certain features may not work correctly or at all on Intel Macs, and you may need to completely disable JavaScript compilation for it to work with Rosetta (see [the FAQ](AAATheFAQ.md) for more information). Because Apple no longer supports Rosetta and 10.4Fx is not a Universal binary, it will not run under Lion 10.7 or any subsequent version of Mac OS X.
## Getting TenFourFox ##
Make sure you select the appropriate build for your Mac from the [download page](http://www.tenfourfox.com/). The G3 version will run on any supported Macintosh, but it will not take advantage of the additional features of G4 or G5 processors. The G4 and G5 versions will not run at all on a G3, and the G5 version will perform badly or crash on non-G5 Macintoshes.
If you are using a G4, you should try to choose the correct version for your processor generation (7400 or 7450 "G4e") as performance may be impaired if you run the wrong one. If you don't know which G4 processor you have, the instructions in WhichVersion will tell you how to find out.
## TenFourFox 17 is equivalent to Firefox 17 ##
TenFourFox uses modified Firefox source code, rewritten to remain compatible with Mac OS X v10.4 and the Power Macintosh. It also contains specific optimizations and special features for PowerPC processors. For this reason, it is not exactly the same as Firefox. However, it is intended to be as compatible with it as possible, including most add-ons and [most standard features](TechnicalDifferences.md). You can treat 10.4Fx 17 as equivalent with Firefox 17 in most circumstances, with specific exceptions noted below.
Note that add-ons which require an Intel Macintosh will not work with TenFourFox, even if they are otherwise compatible with Firefox 17, and add-ons that require 10.5 Leopard may not be compatible with TenFourFox running on Mac OS X 10.4 Tiger, even if they are compatible with PowerPC.
## This branch of TenFourFox is the stable version ##
Starting with Firefox 10, Mozilla began offering an extended support release version of Firefox ("Firefox **ESR**") intended for environments where users are unable to use rapid-release versions of Firefox due to policy or technical constraints. This ESR is the basis of the TenFourFox **stable** branch.
The current ESR release is based on Firefox 17. 10.4Fx 17.x is based on this extended support release and is intended for users who wish to remain with a stable browser core. The stable branch will continue to receive bugfixes and security updates, but will not receive new Firefox features (although it may receive certain 10.4Fx-specific features judged important for our legacy users).
**We recommend this version for most of our users.** If you wish to help test our continuing porting efforts, you can try the _unstable_ branch, which is based on the current release of Firefox. _The unstable branch does have bugs and is recommended only for advanced users._ For more information, see the [TenFourFox Development](http://tenfourfox.blogspot.com/) blog.
## This is the final release of TenFourFox 17 ##
Future releases will be based on the new Firefox ESR, version 24. **There will be no further updates to 10.4Fx 17.**
## TenFourFox no longer supports plugins or Flash ##
Plugins on PowerPC are of special concern because Mozilla is making updates to their plugin architecture which may require the plugins themselves to be updated, and there are certain difficult-to-correct bugs with them already on Tiger. Most importantly, QuickTime, Java and Adobe Flash for PowerPC are no longer maintained and have known security risks that can crash, perform malicious operations or leak data, and Flash 10.1 is rapidly becoming unsupported by many applications.
**For these and other reasons (for details, see PluginsNoLongerSupported), plugin support ships disabled.** Plugins will not operate by default, and bug reports will no longer be accepted. Sites will now act as if no plugins were installed at all. Plugin support will be completely decommissioned in version 18 due to incompatible browser changes.
For Internet video, we now recommend the use of TenFourFox's optional QuickTimeEnabler. This allows many videos to be handled in QuickTime Player directly.
You can also download videos for separate viewing using [Perian](http://www.perian.org/) and any of the available video download add-ons for Firefox.
For YouTube, you may also be able to use [MacTubes](http://macapps.sakura.ne.jp/mactubes/index_en.html). If you have a high end G4 or G5, you can also use WebM for selected videos by visiting http://www.youtube.com/html5 and enabling HTML5 video. This will set a temporary cookie enabling browser-based video without Flash. You do not need a YouTube account for this feature, but you may need to periodically renew the cookie setting. Not all video is available in WebM.
For a more in-depth explanation of this policy and other workarounds, see PluginsNoLongerSupported.
## Fixed in this version of TenFourFox ##
* This version proactively repairs a security issue with secured connections (Mozilla bugs 934016 and 936951).
## Known issues specific to TenFourFox ##
* Remember: **Plugins are turned off by default, and code for them will fail to function entirely in version 18 and later.** See PluginsNoLongerSupported for an explanation and suggested workarounds. Please note that out-of-process plugins have never been supported.
* TenFourFox uses a lighter chrome for windows and dialogue boxes than prior versions or the official Mac Firefox. This is intentional.
* Systems with large numbers of fonts installed may experience intermittent pauses.
* Some pages may perform better on 10.5 systems than 10.4 ([issue 193](https://code.google.com/p/tenfourfox/issues/detail?id=193)).
* Bitmap-only fonts (usually Type 1 PostScript) cannot be used by the 10.4Fx font renderer and are discarded. A fallback font will be used in their place.
* 10.4Fx does not currently support WebGL, WebRTC or the webapp runtime, and scripts such as Arabic or Indic requiring glyph reordering or language-specific ligatures may not appear correctly. See TechnicalDifferences for the complete list of changes necessary for 10.4Fx. See [issue 5](https://code.google.com/p/tenfourfox/issues/detail?id=5) for notes specific to the font issue.
* The titlebar does not always properly match the menu gradient ([issue 16](https://code.google.com/p/tenfourfox/issues/detail?id=16)). This problem is also in the official release. Installing a Persona may fix this issue if you find it bothersome.
* Crash reporting is intentionally disabled to avoid polluting Mozilla's crash tracking system with our reports. Please use your system's crash logs if you are reporting a _reproducible_ crash, or (if you are able) provide a `gdb` backtrace.
* Although 10.4Fx will tell you when an update is available, you must download updates manually at this time.
You are welcome to report other bugs that you find. However, please **do not report Mozilla bugs to us.** If the bug or crash occurs in both the official Mozilla Firefox 17 _(3.6 doesn't count!)_ and in 10.4Fx, this is a Mozilla bug, and you should file it at [Bugzilla](http://bugzilla.mozilla.org/). **You must test your bug in both places -- bugs that are not confirmed to be part of 10.4Fx will be marked invalid** so that we can keep our task list focused. This is the [current list of known issues](http://code.google.com/p/tenfourfox/issues/list).

62
ReleaseNotes1702.md Normal file
View File

@ -0,0 +1,62 @@
_This document may be updated for late-breaking changes, so check back here if you are having difficulty._
## System requirements ##
TenFourFox (hereafter "10.4Fx") requires a G3 Power Macintosh, Mac OS X 10.4.11, 100MB of free disk space and 512MB of RAM. 1GB of RAM and a G4 or G5 processor is recommended. Video playback is likely to be poor on systems slower than 1.25GHz; a G5 is recommended. Mac OS X 10.5.8 is supported.
Intel Macintoshes are not supported. Although some users have reported success getting the G3 version of 10.4Fx to run under Rosetta, certain features may not work correctly or at all on Intel Macs, and you may need to completely disable JavaScript compilation for it to work with Rosetta (see [the FAQ](AAATheFAQ.md) for more information). Because Apple no longer supports Rosetta and 10.4Fx is not a Universal binary, it will not run under Lion 10.7 or any subsequent version of Mac OS X.
## Getting TenFourFox ##
Make sure you select the appropriate build for your Mac from the [download page](http://www.tenfourfox.com/). The G3 version will run on any supported Macintosh, but it will not take advantage of the additional features of G4 or G5 processors. The G4 and G5 versions will not run at all on a G3, and the G5 version will perform badly or crash on non-G5 Macintoshes.
If you are using a G4, you should try to choose the correct version for your processor generation (7400 or 7450 "G4e") as performance may be impaired if you run the wrong one. If you don't know which G4 processor you have, the instructions in WhichVersion will tell you how to find out.
## TenFourFox 17 is equivalent to Firefox 17 ##
TenFourFox uses modified Firefox source code, rewritten to remain compatible with Mac OS X v10.4 and the Power Macintosh. It also contains specific optimizations and special features for PowerPC processors. For this reason, it is not exactly the same as Firefox. However, it is intended to be as compatible with it as possible, including most add-ons and [most standard features](TechnicalDifferences.md). You can treat 10.4Fx 17 as equivalent with Firefox 17 in most circumstances, with specific exceptions noted below.
Note that add-ons which require an Intel Macintosh will not work with TenFourFox, even if they are otherwise compatible with Firefox 17, and add-ons that require 10.5 Leopard may not be compatible with TenFourFox running on Mac OS X 10.4 Tiger, even if they are compatible with PowerPC.
## This branch of TenFourFox is the stable version ##
Starting with Firefox 10, Mozilla began offering an extended support release version of Firefox ("Firefox **ESR**") intended for environments where users are unable to use rapid-release versions of Firefox due to policy or technical constraints. This ESR is the basis of the TenFourFox **stable** branch.
The current ESR release is based on Firefox 17. 10.4Fx 17.x is based on this extended support release and is intended for users who wish to remain with a stable browser core. The stable branch will continue to receive bugfixes and security updates, but will not receive new Firefox features (although it may receive certain 10.4Fx-specific features judged important for our legacy users).
**We recommend this version for most of our users.** If you wish to help test our continuing porting efforts, you can try the _unstable_ branch, which is based on the current release of Firefox. _The unstable branch does have bugs and is recommended only for advanced users._ For more information, see the [TenFourFox Development](http://tenfourfox.blogspot.com/) blog.
## TenFourFox no longer supports plugins or Flash ##
Plugins on PowerPC are of special concern because Mozilla is making updates to their plugin architecture which may require the plugins themselves to be updated, and there are certain difficult-to-correct bugs with them already on Tiger. Most importantly, QuickTime, Java and Adobe Flash for PowerPC are no longer maintained and have known security risks that can crash, perform malicious operations or leak data, and Flash 10.1 is rapidly becoming unsupported by many applications.
**For these and other reasons (for details, see PluginsNoLongerSupported), plugin support ships disabled.** Plugins will not operate by default, and bug reports will no longer be accepted. Sites will now act as if no plugins were installed at all. Plugin support will be completely decommissioned in version 18 due to incompatible browser changes.
For Internet video, we now recommend the use of TenFourFox's optional QuickTimeEnabler. This allows many videos to be handled in QuickTime Player directly.
You can also download videos for separate viewing using [Perian](http://www.perian.org/) and any of the available video download add-ons for Firefox.
For YouTube, you may also be able to use [MacTubes](http://macapps.sakura.ne.jp/mactubes/index_en.html). If you have a high end G4 or G5, you can also use WebM for selected videos by visiting http://www.youtube.com/html5 and enabling HTML5 video. This will set a temporary cookie enabling browser-based video without Flash. You do not need a YouTube account for this feature, but you may need to periodically renew the cookie setting. Not all video is available in WebM.
For a more in-depth explanation of this policy and other workarounds, see PluginsNoLongerSupported.
## Fixed in this version of TenFourFox ##
* All stability and security fixes from Firefox ESR 17.0.2.
* Font enumeration performance is now significantly faster ([issue 195](https://code.google.com/p/tenfourfox/issues/detail?id=195)).
* It is now possible to import Safari bookmarks again ([issue 194](https://code.google.com/p/tenfourfox/issues/detail?id=194), Mozilla [bug 801450](https://code.google.com/p/tenfourfox/issues/detail?id=01450)).
* Issues with malware URL validation are worked around ([issue 197](https://code.google.com/p/tenfourfox/issues/detail?id=197), Mozilla bugs 823665 and 823667).
If you are new to version 17, please also see the [features and fixes in 17.0](ReleaseNotes170.md) and [17.0.1](ReleaseNotes1701.md).
## Known issues specific to TenFourFox ##
* Remember: **Plugins are turned off by default, and code for them will fail to function entirely in version 18 and later.** See PluginsNoLongerSupported for an explanation and suggested workarounds. Please note that out-of-process plugins have never been supported.
* TenFourFox uses a lighter chrome for windows and dialogue boxes than prior versions or the official Mac Firefox. This is intentional.
* Bitmap-only fonts (usually Type 1 PostScript) cannot be used by the 10.4Fx font renderer and are discarded. A fallback font will be used in their place.
* 10.4Fx does not currently support WebGL, WebRTC or the webapp runtime, and scripts such as Arabic or Indic requiring glyph reordering or language-specific ligatures may not appear correctly. See TechnicalDifferences for the complete list of changes necessary for 10.4Fx. See [issue 5](https://code.google.com/p/tenfourfox/issues/detail?id=5) for notes specific to the font issue.
* The titlebar does not always properly match the menu gradient ([issue 16](https://code.google.com/p/tenfourfox/issues/detail?id=16)). This problem is also in the official release. Installing a Persona may fix this issue if you find it bothersome.
* Crash reporting is intentionally disabled to avoid polluting Mozilla's crash tracking system with our reports. Please use your system's crash logs if you are reporting a _reproducible_ crash, or (if you are able) provide a `gdb` backtrace.
* Although 10.4Fx will tell you when an update is available, you must download updates manually at this time.
You are welcome to report other bugs that you find. However, please **do not report Mozilla bugs to us.** If the bug or crash occurs in both the official Mozilla Firefox 17 _(3.6 doesn't count!)_ and in 10.4Fx, this is a Mozilla bug, and you should file it at [Bugzilla](http://bugzilla.mozilla.org/). **You must test your bug in both places -- bugs that are not confirmed to be part of 10.4Fx will be marked invalid** so that we can keep our task list focused. This is the [current list of known issues](http://code.google.com/p/tenfourfox/issues/list).

58
ReleaseNotes1703.md Normal file
View File

@ -0,0 +1,58 @@
_This document may be updated for late-breaking changes, so check back here if you are having difficulty._
## System requirements ##
TenFourFox (hereafter "10.4Fx") requires a G3 Power Macintosh, Mac OS X 10.4.11, 100MB of free disk space and 512MB of RAM. 1GB of RAM and a G4 or G5 processor is recommended. Video playback is likely to be poor on systems slower than 1.25GHz; a G5 is recommended. Mac OS X 10.5.8 is supported.
Intel Macintoshes are not supported. Although some users have reported success getting the G3 version of 10.4Fx to run under Rosetta, certain features may not work correctly or at all on Intel Macs, and you may need to completely disable JavaScript compilation for it to work with Rosetta (see [the FAQ](AAATheFAQ.md) for more information). Because Apple no longer supports Rosetta and 10.4Fx is not a Universal binary, it will not run under Lion 10.7 or any subsequent version of Mac OS X.
## Getting TenFourFox ##
Make sure you select the appropriate build for your Mac from the [download page](http://www.tenfourfox.com/). The G3 version will run on any supported Macintosh, but it will not take advantage of the additional features of G4 or G5 processors. The G4 and G5 versions will not run at all on a G3, and the G5 version will perform badly or crash on non-G5 Macintoshes.
If you are using a G4, you should try to choose the correct version for your processor generation (7400 or 7450 "G4e") as performance may be impaired if you run the wrong one. If you don't know which G4 processor you have, the instructions in WhichVersion will tell you how to find out.
## TenFourFox 17 is equivalent to Firefox 17 ##
TenFourFox uses modified Firefox source code, rewritten to remain compatible with Mac OS X v10.4 and the Power Macintosh. It also contains specific optimizations and special features for PowerPC processors. For this reason, it is not exactly the same as Firefox. However, it is intended to be as compatible with it as possible, including most add-ons and [most standard features](TechnicalDifferences.md). You can treat 10.4Fx 17 as equivalent with Firefox 17 in most circumstances, with specific exceptions noted below.
Note that add-ons which require an Intel Macintosh will not work with TenFourFox, even if they are otherwise compatible with Firefox 17, and add-ons that require 10.5 Leopard may not be compatible with TenFourFox running on Mac OS X 10.4 Tiger, even if they are compatible with PowerPC.
## This branch of TenFourFox is the stable version ##
Starting with Firefox 10, Mozilla began offering an extended support release version of Firefox ("Firefox **ESR**") intended for environments where users are unable to use rapid-release versions of Firefox due to policy or technical constraints. This ESR is the basis of the TenFourFox **stable** branch.
The current ESR release is based on Firefox 17. 10.4Fx 17.x is based on this extended support release and is intended for users who wish to remain with a stable browser core. The stable branch will continue to receive bugfixes and security updates, but will not receive new Firefox features (although it may receive certain 10.4Fx-specific features judged important for our legacy users).
**We recommend this version for most of our users.** If you wish to help test our continuing porting efforts, you can try the _unstable_ branch, which is based on the current release of Firefox. _The unstable branch does have bugs and is recommended only for advanced users._ For more information, see the [TenFourFox Development](http://tenfourfox.blogspot.com/) blog.
## TenFourFox no longer supports plugins or Flash ##
Plugins on PowerPC are of special concern because Mozilla is making updates to their plugin architecture which may require the plugins themselves to be updated, and there are certain difficult-to-correct bugs with them already on Tiger. Most importantly, QuickTime, Java and Adobe Flash for PowerPC are no longer maintained and have known security risks that can crash, perform malicious operations or leak data, and Flash 10.1 is rapidly becoming unsupported by many applications.
**For these and other reasons (for details, see PluginsNoLongerSupported), plugin support ships disabled.** Plugins will not operate by default, and bug reports will no longer be accepted. Sites will now act as if no plugins were installed at all. Plugin support will be completely decommissioned in version 18 due to incompatible browser changes.
For Internet video, we now recommend the use of TenFourFox's optional QuickTimeEnabler. This allows many videos to be handled in QuickTime Player directly.
You can also download videos for separate viewing using [Perian](http://www.perian.org/) and any of the available video download add-ons for Firefox.
For YouTube, you may also be able to use [MacTubes](http://macapps.sakura.ne.jp/mactubes/index_en.html). If you have a high end G4 or G5, you can also use WebM for selected videos by visiting http://www.youtube.com/html5 and enabling HTML5 video. This will set a temporary cookie enabling browser-based video without Flash. You do not need a YouTube account for this feature, but you may need to periodically renew the cookie setting. Not all video is available in WebM.
For a more in-depth explanation of this policy and other workarounds, see PluginsNoLongerSupported.
## Fixed in this version of TenFourFox ##
* All stability and security fixes from Firefox ESR 17.0.3.
* Multi-threading performance is improved further on multiprocessor Power Macintoshes ([issue 205](https://code.google.com/p/tenfourfox/issues/detail?id=205)).
## Known issues specific to TenFourFox ##
* Remember: **Plugins are turned off by default, and code for them will fail to function entirely in version 18 and later.** See PluginsNoLongerSupported for an explanation and suggested workarounds. Please note that out-of-process plugins have never been supported.
* TenFourFox uses a lighter chrome for windows and dialogue boxes than prior versions or the official Mac Firefox. This is intentional.
* Bitmap-only fonts (usually Type 1 PostScript) cannot be used by the 10.4Fx font renderer and are discarded. A fallback font will be used in their place.
* 10.4Fx does not currently support WebGL, WebRTC or the webapp runtime, and scripts such as Arabic or Indic requiring glyph reordering or language-specific ligatures may not appear correctly. See TechnicalDifferences for the complete list of changes necessary for 10.4Fx. See [issue 5](https://code.google.com/p/tenfourfox/issues/detail?id=5) for notes specific to the font issue.
* The titlebar does not always properly match the menu gradient ([issue 16](https://code.google.com/p/tenfourfox/issues/detail?id=16)). This problem is also in the official release. Installing a Persona may fix this issue if you find it bothersome.
* Crash reporting is intentionally disabled to avoid polluting Mozilla's crash tracking system with our reports. Please use your system's crash logs if you are reporting a _reproducible_ crash, or (if you are able) provide a `gdb` backtrace.
* Although 10.4Fx will tell you when an update is available, you must download updates manually at this time.
You are welcome to report other bugs that you find. However, please **do not report Mozilla bugs to us.** If the bug or crash occurs in both the official Mozilla Firefox 17 _(3.6 doesn't count!)_ and in 10.4Fx, this is a Mozilla bug, and you should file it at [Bugzilla](http://bugzilla.mozilla.org/). **You must test your bug in both places -- bugs that are not confirmed to be part of 10.4Fx will be marked invalid** so that we can keep our task list focused. This is the [current list of known issues](http://code.google.com/p/tenfourfox/issues/list).

58
ReleaseNotes1704.md Normal file
View File

@ -0,0 +1,58 @@
_This document may be updated for late-breaking changes, so check back here if you are having difficulty._
## System requirements ##
TenFourFox (hereafter "10.4Fx") requires a G3 Power Macintosh, Mac OS X 10.4.11, 100MB of free disk space and 512MB of RAM. 1GB of RAM and a G4 or G5 processor is recommended. Video playback is likely to be poor on systems slower than 1.25GHz; a G5 is recommended. Mac OS X 10.5.8 is supported.
Intel Macintoshes are not supported. Although some users have reported success getting the G3 version of 10.4Fx to run under Rosetta, certain features may not work correctly or at all on Intel Macs, and you may need to completely disable JavaScript compilation for it to work with Rosetta (see [the FAQ](AAATheFAQ.md) for more information). Because Apple no longer supports Rosetta and 10.4Fx is not a Universal binary, it will not run under Lion 10.7 or any subsequent version of Mac OS X.
## Getting TenFourFox ##
Make sure you select the appropriate build for your Mac from the [download page](http://www.tenfourfox.com/). The G3 version will run on any supported Macintosh, but it will not take advantage of the additional features of G4 or G5 processors. The G4 and G5 versions will not run at all on a G3, and the G5 version will perform badly or crash on non-G5 Macintoshes.
If you are using a G4, you should try to choose the correct version for your processor generation (7400 or 7450 "G4e") as performance may be impaired if you run the wrong one. If you don't know which G4 processor you have, the instructions in WhichVersion will tell you how to find out.
## TenFourFox 17 is equivalent to Firefox 17 ##
TenFourFox uses modified Firefox source code, rewritten to remain compatible with Mac OS X v10.4 and the Power Macintosh. It also contains specific optimizations and special features for PowerPC processors. For this reason, it is not exactly the same as Firefox. However, it is intended to be as compatible with it as possible, including most add-ons and [most standard features](TechnicalDifferences.md). You can treat 10.4Fx 17 as equivalent with Firefox 17 in most circumstances, with specific exceptions noted below.
Note that add-ons which require an Intel Macintosh will not work with TenFourFox, even if they are otherwise compatible with Firefox 17, and add-ons that require 10.5 Leopard may not be compatible with TenFourFox running on Mac OS X 10.4 Tiger, even if they are compatible with PowerPC.
## This branch of TenFourFox is the stable version ##
Starting with Firefox 10, Mozilla began offering an extended support release version of Firefox ("Firefox **ESR**") intended for environments where users are unable to use rapid-release versions of Firefox due to policy or technical constraints. This ESR is the basis of the TenFourFox **stable** branch.
The current ESR release is based on Firefox 17. 10.4Fx 17.x is based on this extended support release and is intended for users who wish to remain with a stable browser core. The stable branch will continue to receive bugfixes and security updates, but will not receive new Firefox features (although it may receive certain 10.4Fx-specific features judged important for our legacy users).
**We recommend this version for most of our users.** If you wish to help test our continuing porting efforts, you can try the _unstable_ branch, which is based on the current release of Firefox. _The unstable branch does have bugs and is recommended only for advanced users._ For more information, see the [TenFourFox Development](http://tenfourfox.blogspot.com/) blog.
## TenFourFox no longer supports plugins or Flash ##
Plugins on PowerPC are of special concern because Mozilla is making updates to their plugin architecture which may require the plugins themselves to be updated, and there are certain difficult-to-correct bugs with them already on Tiger. Most importantly, QuickTime, Java and Adobe Flash for PowerPC are no longer maintained and have known security risks that can crash, perform malicious operations or leak data, and Flash 10.1 is rapidly becoming unsupported by many applications.
**For these and other reasons (for details, see PluginsNoLongerSupported), plugin support ships disabled.** Plugins will not operate by default, and bug reports will no longer be accepted. Sites will now act as if no plugins were installed at all. Plugin support will be completely decommissioned in version 18 due to incompatible browser changes.
For Internet video, we now recommend the use of TenFourFox's optional QuickTimeEnabler. This allows many videos to be handled in QuickTime Player directly.
You can also download videos for separate viewing using [Perian](http://www.perian.org/) and any of the available video download add-ons for Firefox.
For YouTube, you may also be able to use [MacTubes](http://macapps.sakura.ne.jp/mactubes/index_en.html). If you have a high end G4 or G5, you can also use WebM for selected videos by visiting http://www.youtube.com/html5 and enabling HTML5 video. This will set a temporary cookie enabling browser-based video without Flash. You do not need a YouTube account for this feature, but you may need to periodically renew the cookie setting. Not all video is available in WebM.
For a more in-depth explanation of this policy and other workarounds, see PluginsNoLongerSupported.
## Fixed in this version of TenFourFox ##
* This release fixes a high-priority Mozilla security issue (Mozilla [bug 848644](https://code.google.com/p/tenfourfox/issues/detail?id=48644)) and includes all other 17ESR fixes to date.
* A potential crash is repaired in the JavaScript compiler ([issue 211](https://code.google.com/p/tenfourfox/issues/detail?id=211)).
## Known issues specific to TenFourFox ##
* Remember: **Plugins are turned off by default, and code for them will fail to function entirely in version 18 and later.** See PluginsNoLongerSupported for an explanation and suggested workarounds. Please note that out-of-process plugins have never been supported.
* TenFourFox uses a lighter chrome for windows and dialogue boxes than prior versions or the official Mac Firefox. This is intentional.
* Bitmap-only fonts (usually Type 1 PostScript) cannot be used by the 10.4Fx font renderer and are discarded. A fallback font will be used in their place.
* 10.4Fx does not currently support WebGL, WebRTC or the webapp runtime, and scripts such as Arabic or Indic requiring glyph reordering or language-specific ligatures may not appear correctly. See TechnicalDifferences for the complete list of changes necessary for 10.4Fx. See [issue 5](https://code.google.com/p/tenfourfox/issues/detail?id=5) for notes specific to the font issue.
* The titlebar does not always properly match the menu gradient ([issue 16](https://code.google.com/p/tenfourfox/issues/detail?id=16)). This problem is also in the official release. Installing a Persona may fix this issue if you find it bothersome.
* Crash reporting is intentionally disabled to avoid polluting Mozilla's crash tracking system with our reports. Please use your system's crash logs if you are reporting a _reproducible_ crash, or (if you are able) provide a `gdb` backtrace.
* Although 10.4Fx will tell you when an update is available, you must download updates manually at this time.
You are welcome to report other bugs that you find. However, please **do not report Mozilla bugs to us.** If the bug or crash occurs in both the official Mozilla Firefox 17 _(3.6 doesn't count!)_ and in 10.4Fx, this is a Mozilla bug, and you should file it at [Bugzilla](http://bugzilla.mozilla.org/). **You must test your bug in both places -- bugs that are not confirmed to be part of 10.4Fx will be marked invalid** so that we can keep our task list focused. This is the [current list of known issues](http://code.google.com/p/tenfourfox/issues/list).

58
ReleaseNotes1705.md Normal file
View File

@ -0,0 +1,58 @@
_This document may be updated for late-breaking changes, so check back here if you are having difficulty._
## System requirements ##
TenFourFox (hereafter "10.4Fx") requires a G3 Power Macintosh, Mac OS X 10.4.11, 100MB of free disk space and 512MB of RAM. 1GB of RAM and a G4 or G5 processor is recommended. Video playback is likely to be poor on systems slower than 1.25GHz; a G5 is recommended. Mac OS X 10.5.8 is supported.
Intel Macintoshes are not supported. Although some users have reported success getting the G3 version of 10.4Fx to run under Rosetta, certain features may not work correctly or at all on Intel Macs, and you may need to completely disable JavaScript compilation for it to work with Rosetta (see [the FAQ](AAATheFAQ.md) for more information). Because Apple no longer supports Rosetta and 10.4Fx is not a Universal binary, it will not run under Lion 10.7 or any subsequent version of Mac OS X.
## Getting TenFourFox ##
Make sure you select the appropriate build for your Mac from the [download page](http://www.tenfourfox.com/). The G3 version will run on any supported Macintosh, but it will not take advantage of the additional features of G4 or G5 processors. The G4 and G5 versions will not run at all on a G3, and the G5 version will perform badly or crash on non-G5 Macintoshes.
If you are using a G4, you should try to choose the correct version for your processor generation (7400 or 7450 "G4e") as performance may be impaired if you run the wrong one. If you don't know which G4 processor you have, the instructions in WhichVersion will tell you how to find out.
## TenFourFox 17 is equivalent to Firefox 17 ##
TenFourFox uses modified Firefox source code, rewritten to remain compatible with Mac OS X v10.4 and the Power Macintosh. It also contains specific optimizations and special features for PowerPC processors. For this reason, it is not exactly the same as Firefox. However, it is intended to be as compatible with it as possible, including most add-ons and [most standard features](TechnicalDifferences.md). You can treat 10.4Fx 17 as equivalent with Firefox 17 in most circumstances, with specific exceptions noted below.
Note that add-ons which require an Intel Macintosh will not work with TenFourFox, even if they are otherwise compatible with Firefox 17, and add-ons that require 10.5 Leopard may not be compatible with TenFourFox running on Mac OS X 10.4 Tiger, even if they are compatible with PowerPC.
## This branch of TenFourFox is the stable version ##
Starting with Firefox 10, Mozilla began offering an extended support release version of Firefox ("Firefox **ESR**") intended for environments where users are unable to use rapid-release versions of Firefox due to policy or technical constraints. This ESR is the basis of the TenFourFox **stable** branch.
The current ESR release is based on Firefox 17. 10.4Fx 17.x is based on this extended support release and is intended for users who wish to remain with a stable browser core. The stable branch will continue to receive bugfixes and security updates, but will not receive new Firefox features (although it may receive certain 10.4Fx-specific features judged important for our legacy users).
**We recommend this version for most of our users.** If you wish to help test our continuing porting efforts, you can try the _unstable_ branch, which is based on the current release of Firefox. _The unstable branch does have bugs and is recommended only for advanced users._ For more information, see the [TenFourFox Development](http://tenfourfox.blogspot.com/) blog.
## TenFourFox no longer supports plugins or Flash ##
Plugins on PowerPC are of special concern because Mozilla is making updates to their plugin architecture which may require the plugins themselves to be updated, and there are certain difficult-to-correct bugs with them already on Tiger. Most importantly, QuickTime, Java and Adobe Flash for PowerPC are no longer maintained and have known security risks that can crash, perform malicious operations or leak data, and Flash 10.1 is rapidly becoming unsupported by many applications.
**For these and other reasons (for details, see PluginsNoLongerSupported), plugin support ships disabled.** Plugins will not operate by default, and bug reports will no longer be accepted. Sites will now act as if no plugins were installed at all. Plugin support will be completely decommissioned in version 18 due to incompatible browser changes.
For Internet video, we now recommend the use of TenFourFox's optional QuickTimeEnabler. This allows many videos to be handled in QuickTime Player directly.
You can also download videos for separate viewing using [Perian](http://www.perian.org/) and any of the available video download add-ons for Firefox.
For YouTube, you may also be able to use [MacTubes](http://macapps.sakura.ne.jp/mactubes/index_en.html). If you have a high end G4 or G5, you can also use WebM for selected videos by visiting http://www.youtube.com/html5 and enabling HTML5 video. This will set a temporary cookie enabling browser-based video without Flash. You do not need a YouTube account for this feature, but you may need to periodically renew the cookie setting. Not all video is available in WebM.
For a more in-depth explanation of this policy and other workarounds, see PluginsNoLongerSupported.
## Fixed in this version of TenFourFox ##
* All security and stability fixes from Firefox ESR 17.0.5.
* Web applications using offline storage should now work properly again ([issue 213](https://code.google.com/p/tenfourfox/issues/detail?id=213)), fixing the regression introduced in 17.0. **You may need to clear stored databases to restore function, which will require you to download offline content again. You can reset stored databases either by completely resetting your profile, or going to Preferences > Advanced > Network and removing the databases at the bottom of the window pane.** You should only need to do this once. For information on resetting your profile, see [our support link](http://tenfourfox.tenderapp.com/kb/general/how-to-reset-your-profile).
## Known issues specific to TenFourFox ##
* Remember: **Plugins are turned off by default, and code for them will fail to function entirely in version 18 and later.** See PluginsNoLongerSupported for an explanation and suggested workarounds. Please note that out-of-process plugins have never been supported.
* TenFourFox uses a lighter chrome for windows and dialogue boxes than prior versions or the official Mac Firefox. This is intentional.
* Bitmap-only fonts (usually Type 1 PostScript) cannot be used by the 10.4Fx font renderer and are discarded. A fallback font will be used in their place.
* 10.4Fx does not currently support WebGL, WebRTC or the webapp runtime, and scripts such as Arabic or Indic requiring glyph reordering or language-specific ligatures may not appear correctly. See TechnicalDifferences for the complete list of changes necessary for 10.4Fx. See [issue 5](https://code.google.com/p/tenfourfox/issues/detail?id=5) for notes specific to the font issue.
* The titlebar does not always properly match the menu gradient ([issue 16](https://code.google.com/p/tenfourfox/issues/detail?id=16)). This problem is also in the official release. Installing a Persona may fix this issue if you find it bothersome.
* Crash reporting is intentionally disabled to avoid polluting Mozilla's crash tracking system with our reports. Please use your system's crash logs if you are reporting a _reproducible_ crash, or (if you are able) provide a `gdb` backtrace.
* Although 10.4Fx will tell you when an update is available, you must download updates manually at this time.
You are welcome to report other bugs that you find. However, please **do not report Mozilla bugs to us.** If the bug or crash occurs in both the official Mozilla Firefox 17 _(3.6 doesn't count!)_ and in 10.4Fx, this is a Mozilla bug, and you should file it at [Bugzilla](http://bugzilla.mozilla.org/). **You must test your bug in both places -- bugs that are not confirmed to be part of 10.4Fx will be marked invalid** so that we can keep our task list focused. This is the [current list of known issues](http://code.google.com/p/tenfourfox/issues/list).

58
ReleaseNotes1706.md Normal file
View File

@ -0,0 +1,58 @@
_This document may be updated for late-breaking changes, so check back here if you are having difficulty._
## System requirements ##
TenFourFox (hereafter "10.4Fx") requires a G3 Power Macintosh, Mac OS X 10.4.11, 100MB of free disk space and 512MB of RAM. 1GB of RAM and a G4 or G5 processor is recommended. Video playback is likely to be poor on systems slower than 1.25GHz; a G5 is recommended. Mac OS X 10.5.8 is supported.
Intel Macintoshes are not supported. Although some users have reported success getting the G3 version of 10.4Fx to run under Rosetta, certain features may not work correctly or at all on Intel Macs, and you may need to completely disable JavaScript compilation for it to work with Rosetta (see [the FAQ](AAATheFAQ.md) for more information). Because Apple no longer supports Rosetta and 10.4Fx is not a Universal binary, it will not run under Lion 10.7 or any subsequent version of Mac OS X.
## Getting TenFourFox ##
Make sure you select the appropriate build for your Mac from the [download page](http://www.tenfourfox.com/). The G3 version will run on any supported Macintosh, but it will not take advantage of the additional features of G4 or G5 processors. The G4 and G5 versions will not run at all on a G3, and the G5 version will perform badly or crash on non-G5 Macintoshes.
If you are using a G4, you should try to choose the correct version for your processor generation (7400 or 7450 "G4e") as performance may be impaired if you run the wrong one. If you don't know which G4 processor you have, the instructions in WhichVersion will tell you how to find out.
## TenFourFox 17 is equivalent to Firefox 17 ##
TenFourFox uses modified Firefox source code, rewritten to remain compatible with Mac OS X v10.4 and the Power Macintosh. It also contains specific optimizations and special features for PowerPC processors. For this reason, it is not exactly the same as Firefox. However, it is intended to be as compatible with it as possible, including most add-ons and [most standard features](TechnicalDifferences.md). You can treat 10.4Fx 17 as equivalent with Firefox 17 in most circumstances, with specific exceptions noted below.
Note that add-ons which require an Intel Macintosh will not work with TenFourFox, even if they are otherwise compatible with Firefox 17, and add-ons that require 10.5 Leopard may not be compatible with TenFourFox running on Mac OS X 10.4 Tiger, even if they are compatible with PowerPC.
## This branch of TenFourFox is the stable version ##
Starting with Firefox 10, Mozilla began offering an extended support release version of Firefox ("Firefox **ESR**") intended for environments where users are unable to use rapid-release versions of Firefox due to policy or technical constraints. This ESR is the basis of the TenFourFox **stable** branch.
The current ESR release is based on Firefox 17. 10.4Fx 17.x is based on this extended support release and is intended for users who wish to remain with a stable browser core. The stable branch will continue to receive bugfixes and security updates, but will not receive new Firefox features (although it may receive certain 10.4Fx-specific features judged important for our legacy users).
**We recommend this version for most of our users.** If you wish to help test our continuing porting efforts, you can try the _unstable_ branch, which is based on the current release of Firefox. _The unstable branch does have bugs and is recommended only for advanced users._ For more information, see the [TenFourFox Development](http://tenfourfox.blogspot.com/) blog.
## TenFourFox no longer supports plugins or Flash ##
Plugins on PowerPC are of special concern because Mozilla is making updates to their plugin architecture which may require the plugins themselves to be updated, and there are certain difficult-to-correct bugs with them already on Tiger. Most importantly, QuickTime, Java and Adobe Flash for PowerPC are no longer maintained and have known security risks that can crash, perform malicious operations or leak data, and Flash 10.1 is rapidly becoming unsupported by many applications.
**For these and other reasons (for details, see PluginsNoLongerSupported), plugin support ships disabled.** Plugins will not operate by default, and bug reports will no longer be accepted. Sites will now act as if no plugins were installed at all. Plugin support will be completely decommissioned in version 18 due to incompatible browser changes.
For Internet video, we now recommend the use of TenFourFox's optional QuickTimeEnabler. This allows many videos to be handled in QuickTime Player directly.
You can also download videos for separate viewing using [Perian](http://www.perian.org/) and any of the available video download add-ons for Firefox.
For YouTube, you may also be able to use [MacTubes](http://macapps.sakura.ne.jp/mactubes/index_en.html). If you have a high end G4 or G5, you can also use WebM for selected videos by visiting http://www.youtube.com/html5 and enabling HTML5 video. This will set a temporary cookie enabling browser-based video without Flash. You do not need a YouTube account for this feature, but you may need to periodically renew the cookie setting. Not all video is available in WebM.
For a more in-depth explanation of this policy and other workarounds, see PluginsNoLongerSupported.
## Fixed in this version of TenFourFox ##
* All security and stability fixes from Firefox ESR 17.0.6.
* Changing canvas paint modes in certain circumstances should no longer cause a crash ([issue 217](https://code.google.com/p/tenfourfox/issues/detail?id=217)).
## Known issues specific to TenFourFox ##
* Remember: **Plugins are turned off by default, and code for them will fail to function entirely in version 18 and later.** See PluginsNoLongerSupported for an explanation and suggested workarounds. Please note that out-of-process plugins have never been supported.
* TenFourFox uses a lighter chrome for windows and dialogue boxes than prior versions or the official Mac Firefox. This is intentional.
* Bitmap-only fonts (usually Type 1 PostScript) cannot be used by the 10.4Fx font renderer and are discarded. A fallback font will be used in their place.
* 10.4Fx does not currently support WebGL, WebRTC or the webapp runtime, and scripts such as Arabic or Indic requiring glyph reordering or language-specific ligatures may not appear correctly. See TechnicalDifferences for the complete list of changes necessary for 10.4Fx. See [issue 5](https://code.google.com/p/tenfourfox/issues/detail?id=5) for notes specific to the font issue.
* The titlebar does not always properly match the menu gradient ([issue 16](https://code.google.com/p/tenfourfox/issues/detail?id=16)). This problem is also in the official release. Installing a Persona may fix this issue if you find it bothersome.
* Crash reporting is intentionally disabled to avoid polluting Mozilla's crash tracking system with our reports. Please use your system's crash logs if you are reporting a _reproducible_ crash, or (if you are able) provide a `gdb` backtrace.
* Although 10.4Fx will tell you when an update is available, you must download updates manually at this time.
You are welcome to report other bugs that you find. However, please **do not report Mozilla bugs to us.** If the bug or crash occurs in both the official Mozilla Firefox 17 _(3.6 doesn't count!)_ and in 10.4Fx, this is a Mozilla bug, and you should file it at [Bugzilla](http://bugzilla.mozilla.org/). **You must test your bug in both places -- bugs that are not confirmed to be part of 10.4Fx will be marked invalid** so that we can keep our task list focused. This is the [current list of known issues](http://code.google.com/p/tenfourfox/issues/list).

59
ReleaseNotes1707.md Normal file
View File

@ -0,0 +1,59 @@
_This document may be updated for late-breaking changes, so check back here if you are having difficulty._
## System requirements ##
TenFourFox (hereafter "10.4Fx") requires a G3 Power Macintosh, Mac OS X 10.4.11, 100MB of free disk space and 512MB of RAM. 1GB of RAM and a G4 or G5 processor is recommended. Video playback is likely to be poor on systems slower than 1.25GHz; a G5 is recommended. Mac OS X 10.5.8 is supported.
Intel Macintoshes are not supported. Although some users have reported success getting the G3 version of 10.4Fx to run under Rosetta, certain features may not work correctly or at all on Intel Macs, and you may need to completely disable JavaScript compilation for it to work with Rosetta (see [the FAQ](AAATheFAQ.md) for more information). Because Apple no longer supports Rosetta and 10.4Fx is not a Universal binary, it will not run under Lion 10.7 or any subsequent version of Mac OS X.
## Getting TenFourFox ##
Make sure you select the appropriate build for your Mac from the [download page](http://www.tenfourfox.com/). The G3 version will run on any supported Macintosh, but it will not take advantage of the additional features of G4 or G5 processors. The G4 and G5 versions will not run at all on a G3, and the G5 version will perform badly or crash on non-G5 Macintoshes.
If you are using a G4, you should try to choose the correct version for your processor generation (7400 or 7450 "G4e") as performance may be impaired if you run the wrong one. If you don't know which G4 processor you have, the instructions in WhichVersion will tell you how to find out.
## TenFourFox 17 is equivalent to Firefox 17 ##
TenFourFox uses modified Firefox source code, rewritten to remain compatible with Mac OS X v10.4 and the Power Macintosh. It also contains specific optimizations and special features for PowerPC processors. For this reason, it is not exactly the same as Firefox. However, it is intended to be as compatible with it as possible, including most add-ons and [most standard features](TechnicalDifferences.md). You can treat 10.4Fx 17 as equivalent with Firefox 17 in most circumstances, with specific exceptions noted below.
Note that add-ons which require an Intel Macintosh will not work with TenFourFox, even if they are otherwise compatible with Firefox 17, and add-ons that require 10.5 Leopard may not be compatible with TenFourFox running on Mac OS X 10.4 Tiger, even if they are compatible with PowerPC.
## This branch of TenFourFox is the stable version ##
Starting with Firefox 10, Mozilla began offering an extended support release version of Firefox ("Firefox **ESR**") intended for environments where users are unable to use rapid-release versions of Firefox due to policy or technical constraints. This ESR is the basis of the TenFourFox **stable** branch.
The current ESR release is based on Firefox 17. 10.4Fx 17.x is based on this extended support release and is intended for users who wish to remain with a stable browser core. The stable branch will continue to receive bugfixes and security updates, but will not receive new Firefox features (although it may receive certain 10.4Fx-specific features judged important for our legacy users).
**We recommend this version for most of our users.** If you wish to help test our continuing porting efforts, you can try the _unstable_ branch, which is based on the current release of Firefox. _The unstable branch does have bugs and is recommended only for advanced users._ For more information, see the [TenFourFox Development](http://tenfourfox.blogspot.com/) blog.
## TenFourFox no longer supports plugins or Flash ##
Plugins on PowerPC are of special concern because Mozilla is making updates to their plugin architecture which may require the plugins themselves to be updated, and there are certain difficult-to-correct bugs with them already on Tiger. Most importantly, QuickTime, Java and Adobe Flash for PowerPC are no longer maintained and have known security risks that can crash, perform malicious operations or leak data, and Flash 10.1 is rapidly becoming unsupported by many applications.
**For these and other reasons (for details, see PluginsNoLongerSupported), plugin support ships disabled.** Plugins will not operate by default, and bug reports will no longer be accepted. Sites will now act as if no plugins were installed at all. Plugin support will be completely decommissioned in version 18 due to incompatible browser changes.
For Internet video, we now recommend the use of TenFourFox's optional QuickTimeEnabler. This allows many videos to be handled in QuickTime Player directly.
You can also download videos for separate viewing using [Perian](http://www.perian.org/) and any of the available video download add-ons for Firefox.
For YouTube, you may also be able to use [MacTubes](http://macapps.sakura.ne.jp/mactubes/index_en.html). If you have a high end G4 or G5, you can also use WebM for selected videos by visiting http://www.youtube.com/html5 and enabling HTML5 video. This will set a temporary cookie enabling browser-based video without Flash. You do not need a YouTube account for this feature, but you may need to periodically renew the cookie setting. Not all video is available in WebM.
For a more in-depth explanation of this policy and other workarounds, see PluginsNoLongerSupported.
## Fixed in this version of TenFourFox ##
* All security and stability fixes from Firefox ESR 17.0.7.
* Colour management is enabled for ICCv4 profiles, improving colour fidelity with colour-managed images ([issue 225](https://code.google.com/p/tenfourfox/issues/detail?id=225)).
## Known issues specific to TenFourFox ##
* Remember: **Plugins are turned off by default, and code for them will fail to function entirely in version 18 and later.** See PluginsNoLongerSupported for an explanation and suggested workarounds. Please note that out-of-process plugins have never been supported.
* TenFourFox uses a lighter chrome for windows and dialogue boxes than prior versions or the official Mac Firefox. This is intentional.
* Systems with large numbers of fonts installed may experience intermittent pauses.
* Bitmap-only fonts (usually Type 1 PostScript) cannot be used by the 10.4Fx font renderer and are discarded. A fallback font will be used in their place.
* 10.4Fx does not currently support WebGL, WebRTC or the webapp runtime, and scripts such as Arabic or Indic requiring glyph reordering or language-specific ligatures may not appear correctly. See TechnicalDifferences for the complete list of changes necessary for 10.4Fx. See [issue 5](https://code.google.com/p/tenfourfox/issues/detail?id=5) for notes specific to the font issue.
* The titlebar does not always properly match the menu gradient ([issue 16](https://code.google.com/p/tenfourfox/issues/detail?id=16)). This problem is also in the official release. Installing a Persona may fix this issue if you find it bothersome.
* Crash reporting is intentionally disabled to avoid polluting Mozilla's crash tracking system with our reports. Please use your system's crash logs if you are reporting a _reproducible_ crash, or (if you are able) provide a `gdb` backtrace.
* Although 10.4Fx will tell you when an update is available, you must download updates manually at this time.
You are welcome to report other bugs that you find. However, please **do not report Mozilla bugs to us.** If the bug or crash occurs in both the official Mozilla Firefox 17 _(3.6 doesn't count!)_ and in 10.4Fx, this is a Mozilla bug, and you should file it at [Bugzilla](http://bugzilla.mozilla.org/). **You must test your bug in both places -- bugs that are not confirmed to be part of 10.4Fx will be marked invalid** so that we can keep our task list focused. This is the [current list of known issues](http://code.google.com/p/tenfourfox/issues/list).

58
ReleaseNotes1708.md Normal file
View File

@ -0,0 +1,58 @@
_This document may be updated for late-breaking changes, so check back here if you are having difficulty._
## System requirements ##
TenFourFox (hereafter "10.4Fx") requires a G3 Power Macintosh, Mac OS X 10.4.11, 100MB of free disk space and 512MB of RAM. 1GB of RAM and a G4 or G5 processor is recommended. Video playback is likely to be poor on systems slower than 1.25GHz; a G5 is recommended. Mac OS X 10.5.8 is supported.
Intel Macintoshes are not supported. Although some users have reported success getting the G3 version of 10.4Fx to run under Rosetta, certain features may not work correctly or at all on Intel Macs, and you may need to completely disable JavaScript compilation for it to work with Rosetta (see [the FAQ](AAATheFAQ.md) for more information). Because Apple no longer supports Rosetta and 10.4Fx is not a Universal binary, it will not run under Lion 10.7 or any subsequent version of Mac OS X.
## Getting TenFourFox ##
Make sure you select the appropriate build for your Mac from the [download page](http://www.tenfourfox.com/). The G3 version will run on any supported Macintosh, but it will not take advantage of the additional features of G4 or G5 processors. The G4 and G5 versions will not run at all on a G3, and the G5 version will perform badly or crash on non-G5 Macintoshes.
If you are using a G4, you should try to choose the correct version for your processor generation (7400 or 7450 "G4e") as performance may be impaired if you run the wrong one. If you don't know which G4 processor you have, the instructions in WhichVersion will tell you how to find out.
## TenFourFox 17 is equivalent to Firefox 17 ##
TenFourFox uses modified Firefox source code, rewritten to remain compatible with Mac OS X v10.4 and the Power Macintosh. It also contains specific optimizations and special features for PowerPC processors. For this reason, it is not exactly the same as Firefox. However, it is intended to be as compatible with it as possible, including most add-ons and [most standard features](TechnicalDifferences.md). You can treat 10.4Fx 17 as equivalent with Firefox 17 in most circumstances, with specific exceptions noted below.
Note that add-ons which require an Intel Macintosh will not work with TenFourFox, even if they are otherwise compatible with Firefox 17, and add-ons that require 10.5 Leopard may not be compatible with TenFourFox running on Mac OS X 10.4 Tiger, even if they are compatible with PowerPC.
## This branch of TenFourFox is the stable version ##
Starting with Firefox 10, Mozilla began offering an extended support release version of Firefox ("Firefox **ESR**") intended for environments where users are unable to use rapid-release versions of Firefox due to policy or technical constraints. This ESR is the basis of the TenFourFox **stable** branch.
The current ESR release is based on Firefox 17. 10.4Fx 17.x is based on this extended support release and is intended for users who wish to remain with a stable browser core. The stable branch will continue to receive bugfixes and security updates, but will not receive new Firefox features (although it may receive certain 10.4Fx-specific features judged important for our legacy users).
**We recommend this version for most of our users.** If you wish to help test our continuing porting efforts, you can try the _unstable_ branch, which is based on the current release of Firefox. _The unstable branch does have bugs and is recommended only for advanced users._ For more information, see the [TenFourFox Development](http://tenfourfox.blogspot.com/) blog.
## TenFourFox no longer supports plugins or Flash ##
Plugins on PowerPC are of special concern because Mozilla is making updates to their plugin architecture which may require the plugins themselves to be updated, and there are certain difficult-to-correct bugs with them already on Tiger. Most importantly, QuickTime, Java and Adobe Flash for PowerPC are no longer maintained and have known security risks that can crash, perform malicious operations or leak data, and Flash 10.1 is rapidly becoming unsupported by many applications.
**For these and other reasons (for details, see PluginsNoLongerSupported), plugin support ships disabled.** Plugins will not operate by default, and bug reports will no longer be accepted. Sites will now act as if no plugins were installed at all. Plugin support will be completely decommissioned in version 18 due to incompatible browser changes.
For Internet video, we now recommend the use of TenFourFox's optional QuickTimeEnabler. This allows many videos to be handled in QuickTime Player directly.
You can also download videos for separate viewing using [Perian](http://www.perian.org/) and any of the available video download add-ons for Firefox.
For YouTube, you may also be able to use [MacTubes](http://macapps.sakura.ne.jp/mactubes/index_en.html). If you have a high end G4 or G5, you can also use WebM for selected videos by visiting http://www.youtube.com/html5 and enabling HTML5 video. This will set a temporary cookie enabling browser-based video without Flash. You do not need a YouTube account for this feature, but you may need to periodically renew the cookie setting. Not all video is available in WebM.
For a more in-depth explanation of this policy and other workarounds, see PluginsNoLongerSupported.
## Fixed in this version of TenFourFox ##
* All security and stability fixes from Firefox ESR 17.0.8.
## Known issues specific to TenFourFox ##
* Remember: **Plugins are turned off by default, and code for them will fail to function entirely in version 18 and later.** See PluginsNoLongerSupported for an explanation and suggested workarounds. Please note that out-of-process plugins have never been supported.
* TenFourFox uses a lighter chrome for windows and dialogue boxes than prior versions or the official Mac Firefox. This is intentional.
* Systems with large numbers of fonts installed may experience intermittent pauses.
* Bitmap-only fonts (usually Type 1 PostScript) cannot be used by the 10.4Fx font renderer and are discarded. A fallback font will be used in their place.
* 10.4Fx does not currently support WebGL, WebRTC or the webapp runtime, and scripts such as Arabic or Indic requiring glyph reordering or language-specific ligatures may not appear correctly. See TechnicalDifferences for the complete list of changes necessary for 10.4Fx. See [issue 5](https://code.google.com/p/tenfourfox/issues/detail?id=5) for notes specific to the font issue.
* The titlebar does not always properly match the menu gradient ([issue 16](https://code.google.com/p/tenfourfox/issues/detail?id=16)). This problem is also in the official release. Installing a Persona may fix this issue if you find it bothersome.
* Crash reporting is intentionally disabled to avoid polluting Mozilla's crash tracking system with our reports. Please use your system's crash logs if you are reporting a _reproducible_ crash, or (if you are able) provide a `gdb` backtrace.
* Although 10.4Fx will tell you when an update is available, you must download updates manually at this time.
You are welcome to report other bugs that you find. However, please **do not report Mozilla bugs to us.** If the bug or crash occurs in both the official Mozilla Firefox 17 _(3.6 doesn't count!)_ and in 10.4Fx, this is a Mozilla bug, and you should file it at [Bugzilla](http://bugzilla.mozilla.org/). **You must test your bug in both places -- bugs that are not confirmed to be part of 10.4Fx will be marked invalid** so that we can keep our task list focused. This is the [current list of known issues](http://code.google.com/p/tenfourfox/issues/list).

60
ReleaseNotes1709.md Normal file
View File

@ -0,0 +1,60 @@
_This document may be updated for late-breaking changes, so check back here if you are having difficulty._
## System requirements ##
TenFourFox (hereafter "10.4Fx") requires a G3 Power Macintosh, Mac OS X 10.4.11, 100MB of free disk space and 512MB of RAM. 1GB of RAM and a G4 or G5 processor is recommended. Video playback is likely to be poor on systems slower than 1.25GHz; a G5 is recommended. Mac OS X 10.5.8 is supported.
Intel Macintoshes are not supported. Although some users have reported success getting the G3 version of 10.4Fx to run under Rosetta, certain features may not work correctly or at all on Intel Macs, and you may need to completely disable JavaScript compilation for it to work with Rosetta (see [the FAQ](AAATheFAQ.md) for more information). Because Apple no longer supports Rosetta and 10.4Fx is not a Universal binary, it will not run under Lion 10.7 or any subsequent version of Mac OS X.
## Getting TenFourFox ##
Make sure you select the appropriate build for your Mac from the [download page](http://www.tenfourfox.com/). The G3 version will run on any supported Macintosh, but it will not take advantage of the additional features of G4 or G5 processors. The G4 and G5 versions will not run at all on a G3, and the G5 version will perform badly or crash on non-G5 Macintoshes.
If you are using a G4, you should try to choose the correct version for your processor generation (7400 or 7450 "G4e") as performance may be impaired if you run the wrong one. If you don't know which G4 processor you have, the instructions in WhichVersion will tell you how to find out.
## TenFourFox 17 is equivalent to Firefox 17 ##
TenFourFox uses modified Firefox source code, rewritten to remain compatible with Mac OS X v10.4 and the Power Macintosh. It also contains specific optimizations and special features for PowerPC processors. For this reason, it is not exactly the same as Firefox. However, it is intended to be as compatible with it as possible, including most add-ons and [most standard features](TechnicalDifferences.md). You can treat 10.4Fx 17 as equivalent with Firefox 17 in most circumstances, with specific exceptions noted below.
Note that add-ons which require an Intel Macintosh will not work with TenFourFox, even if they are otherwise compatible with Firefox 17, and add-ons that require 10.5 Leopard may not be compatible with TenFourFox running on Mac OS X 10.4 Tiger, even if they are compatible with PowerPC.
## This branch of TenFourFox is the stable version ##
Starting with Firefox 10, Mozilla began offering an extended support release version of Firefox ("Firefox **ESR**") intended for environments where users are unable to use rapid-release versions of Firefox due to policy or technical constraints. This ESR is the basis of the TenFourFox **stable** branch.
The current ESR release is based on Firefox 17. 10.4Fx 17.x is based on this extended support release and is intended for users who wish to remain with a stable browser core. The stable branch will continue to receive bugfixes and security updates, but will not receive new Firefox features (although it may receive certain 10.4Fx-specific features judged important for our legacy users).
**We recommend this version for most of our users.** If you wish to help test our continuing porting efforts, you can try the _unstable_ branch, which is based on the current release of Firefox. _The unstable branch does have bugs and is recommended only for advanced users._ For more information, see the [TenFourFox Development](http://tenfourfox.blogspot.com/) blog.
## TenFourFox no longer supports plugins or Flash ##
Plugins on PowerPC are of special concern because Mozilla is making updates to their plugin architecture which may require the plugins themselves to be updated, and there are certain difficult-to-correct bugs with them already on Tiger. Most importantly, QuickTime, Java and Adobe Flash for PowerPC are no longer maintained and have known security risks that can crash, perform malicious operations or leak data, and Flash 10.1 is rapidly becoming unsupported by many applications.
**For these and other reasons (for details, see PluginsNoLongerSupported), plugin support ships disabled.** Plugins will not operate by default, and bug reports will no longer be accepted. Sites will now act as if no plugins were installed at all. Plugin support will be completely decommissioned in version 18 due to incompatible browser changes.
For Internet video, we now recommend the use of TenFourFox's optional QuickTimeEnabler. This allows many videos to be handled in QuickTime Player directly.
You can also download videos for separate viewing using [Perian](http://www.perian.org/) and any of the available video download add-ons for Firefox.
For YouTube, you may also be able to use [MacTubes](http://macapps.sakura.ne.jp/mactubes/index_en.html). If you have a high end G4 or G5, you can also use WebM for selected videos by visiting http://www.youtube.com/html5 and enabling HTML5 video. This will set a temporary cookie enabling browser-based video without Flash. You do not need a YouTube account for this feature, but you may need to periodically renew the cookie setting. Not all video is available in WebM.
For a more in-depth explanation of this policy and other workarounds, see PluginsNoLongerSupported.
## Fixed in this version of TenFourFox ##
* A JavaScript just-in-time compiler bug is fixed, repairing certain sites such as Yandex Mail ([issue 200](https://code.google.com/p/tenfourfox/issues/detail?id=200), [issue 239](https://code.google.com/p/tenfourfox/issues/detail?id=239), Mozilla [bug 907169](https://code.google.com/p/tenfourfox/issues/detail?id=07169)). Thanks to the Tenfourbird project and t\_mrc-ct for the patch.
* All security and stability fixes from Firefox ESR 17.0.9.
## Known issues specific to TenFourFox ##
* Remember: **Plugins are turned off by default, and code for them will fail to function entirely in version 18 and later.** See PluginsNoLongerSupported for an explanation and suggested workarounds. Please note that out-of-process plugins have never been supported.
* TenFourFox uses a lighter chrome for windows and dialogue boxes than prior versions or the official Mac Firefox. This is intentional.
* Systems with large numbers of fonts installed may experience intermittent pauses.
* Some pages may perform better on 10.5 systems than 10.4 ([issue 193](https://code.google.com/p/tenfourfox/issues/detail?id=193)).
* Bitmap-only fonts (usually Type 1 PostScript) cannot be used by the 10.4Fx font renderer and are discarded. A fallback font will be used in their place.
* 10.4Fx does not currently support WebGL, WebRTC or the webapp runtime, and scripts such as Arabic or Indic requiring glyph reordering or language-specific ligatures may not appear correctly. See TechnicalDifferences for the complete list of changes necessary for 10.4Fx. See [issue 5](https://code.google.com/p/tenfourfox/issues/detail?id=5) for notes specific to the font issue.
* The titlebar does not always properly match the menu gradient ([issue 16](https://code.google.com/p/tenfourfox/issues/detail?id=16)). This problem is also in the official release. Installing a Persona may fix this issue if you find it bothersome.
* Crash reporting is intentionally disabled to avoid polluting Mozilla's crash tracking system with our reports. Please use your system's crash logs if you are reporting a _reproducible_ crash, or (if you are able) provide a `gdb` backtrace.
* Although 10.4Fx will tell you when an update is available, you must download updates manually at this time.
You are welcome to report other bugs that you find. However, please **do not report Mozilla bugs to us.** If the bug or crash occurs in both the official Mozilla Firefox 17 _(3.6 doesn't count!)_ and in 10.4Fx, this is a Mozilla bug, and you should file it at [Bugzilla](http://bugzilla.mozilla.org/). **You must test your bug in both places -- bugs that are not confirmed to be part of 10.4Fx will be marked invalid** so that we can keep our task list focused. This is the [current list of known issues](http://code.google.com/p/tenfourfox/issues/list).

66
ReleaseNotes17Alpha2.md Normal file
View File

@ -0,0 +1,66 @@
_This document may be updated for late-breaking changes, so check back here if you are having difficulty._
## System requirements ##
TenFourFox (hereafter "10.4Fx") requires a G3 Power Macintosh, Mac OS X 10.4.11, 100MB of free disk space and 512MB of RAM. 1GB of RAM and a G4 or G5 processor is recommended. Video playback is likely to be poor on systems slower than 1.25GHz; a G5 is recommended. Mac OS X 10.5.8 is supported.
Intel Macintoshes are not supported, but the G3 build is known to run under Rosetta in 10.4.11, 10.5.8 and 10.6.8. Because Apple no longer supports Rosetta and 10.4Fx is not a Universal binary, it will not run under Lion 10.7 or any future version of Mac OS X.
## Getting TenFourFox ##
Make sure you select the appropriate build for your Mac from the [download page](http://www.tenfourfox.com/). The G3 version will run on any supported Macintosh, but it will not take advantage of the additional features of G4 or G5 processors. The G4 and G5 versions will not run at all on a G3, and the G5 version will perform badly or crash on non-G5 Macintoshes.
If you are using a G4, you should try to choose the correct version for your processor generation (7400 or 7450 "G4e") as performance may be impaired if you run the wrong one. If you don't know which G4 processor you have, the instructions in WhichVersion will tell you how to find out.
## TenFourFox 17 Alpha is equivalent to Firefox 17 Aurora ##
TenFourFox uses modified Firefox source code, rewritten to remain compatible with Mac OS X v10.4 and the Power Macintosh. It also contains specific optimizations and special features for PowerPC processors. For this reason, it is not exactly the same as Firefox. However, it is intended to be as compatible with it as possible, including most add-ons and [most standard features](TechnicalDifferences.md). You can treat 10.4Fx 17 as equivalent with Firefox 17 in most circumstances, with specific exceptions noted below.
Note that add-ons which require an Intel Macintosh will not work with TenFourFox, even if they are otherwise compatible with Firefox 17, and add-ons that require 10.5 Leopard may not be compatible with TenFourFox running on Mac OS X 10.4 Tiger, even if they are compatible with PowerPC.
## This branch of TenFourFox _will be_ the new stable version ##
Starting with Firefox 10, Mozilla is now offering an extended support release version of Firefox ("Firefox **ESR**") intended for environments where users are unable to use rapid-release versions of Firefox due to policy or technical constraints. This ESR is the basis of the TenFourFox **stable** branch. The _stable_ branch will continue to receive bugfixes and security updates, but will not receive new Firefox features (although it may receive certain 10.4Fx-specific features judged important for our legacy users).
The next Firefox ESR will be Firefox 17. **This is a preview early release of this new version which will become the next stable version of TenFourFox.** Please test it for the benefit of our other users so that we can identify bugs and serious issues early. Your testing helps make the browser better.
Please note: this is a preview release and _it has known bugs._ **If you need a release-quality version of TenFourFox, please use the 10.0.x stable version instead until this preview version matures.** You can download 10.0.x from [our main page](http://www.tenfourfox.com/).
## TenFourFox no longer supports plugins or Flash ##
Plugins on PowerPC are of special concern because Mozilla is making updates to their plugin architecture which may require the plugins themselves to be updated, and there are certain difficult-to-correct bugs with them already on Tiger. Most importantly, QuickTime, Java and Adobe Flash for PowerPC are no longer maintained and have known security risks that can crash, perform malicious operations or leak data, and Flash 10.1 is rapidly becoming unsupported by many applications.
**As of TenFourFox 6.0, for these and other reasons (for details, see PluginsNoLongerSupported), plugin support ships disabled.** Plugins will not operate by default, and bug reports will no longer be accepted. Sites will now act as if no plugins were installed at all.
For Internet video, we now recommend the use of TenFourFox's optional QuickTimeEnabler. This allows many videos to be handled in QuickTime Player directly.
You can also download videos for separate viewing using [Perian](http://www.perian.org/) and any of the available video download add-ons for Firefox.
For YouTube, you may also be able to use [MacTubes](http://macapps.sakura.ne.jp/mactubes/index_en.html). If you have a high end G4 or G5, you can also use WebM for selected videos by visiting http://www.youtube.com/html5 and enabling HTML5 video. This will set a temporary cookie enabling browser-based video without Flash. You do not need a YouTube account for this feature, but you may need to periodically renew the cookie setting. Not all video is available in WebM.
For a more in-depth explanation of this policy and other workarounds, see PluginsNoLongerSupported.
## New features in this new stable version of TenFourFox ##
* All supported standard features of Firefox 11 through Firefox 17, including improved JavaScript performance, CoreGraphics accelerated canvas, faster screen updates, additional HTML5 and CSS 3 features, SPDY-enhanced encrypted networking, a smarter URL bar, integrated downloads and new web developer features.
## Known problems in this version of TenFourFox ##
* Canvas elements sometimes do not properly update ([issue 180](https://code.google.com/p/tenfourfox/issues/detail?id=180), Mozilla [bug 794337](https://code.google.com/p/tenfourfox/issues/detail?id=94337)).
## Fixed in this version of TenFourFox ##
* It is now possible to blacklist Arial, Helvetica and/or Times (or any other combination) for users with corrupt or abnormal versions of these fonts ([issue 171](https://code.google.com/p/tenfourfox/issues/detail?id=171)). See [this Tenderapp ticket](http://tenfourfox.tenderapp.com/discussions/problems/2-italic-display) for information about when and how to use this blacklist. This affects all versions of 10.4Fx, but will not be backported to 10.0.x due to differences in font code.
* The No Thanks button in the update dialogue now works correctly ([issue 130](https://code.google.com/p/tenfourfox/issues/detail?id=130)). This affects 10 through 15. This fix will be backported to 10.0.8.
* You can now search bookmarks again ([issue 177](https://code.google.com/p/tenfourfox/issues/detail?id=177)). This affects 13 through 15. This issue does not affect 10.0.x.
## Known issues specific to TenFourFox ##
* Remember: **Plugins are turned off by default, and code for them will fail to function entirely in a subsequent version.** See PluginsNoLongerSupported for an explanation and suggested workarounds. Please note that out-of-process plugins have never been supported.
* As of TenFourFox 8, TenFourFox uses a lighter chrome for windows and dialogue boxes than prior versions or the official Mac Firefox. This is intentional.
* 10.4Fx does not currently support WebGL, WebRTC or the webapp runtime, and scripts such as Arabic or Indic requiring glyph reordering or language-specific ligatures may not appear correctly. See TechnicalDifferences for the complete list of changes necessary for 10.4Fx. See [issue 5](https://code.google.com/p/tenfourfox/issues/detail?id=5) for notes specific to the font issue.
* The titlebar does not always properly match the menu gradient ([issue 16](https://code.google.com/p/tenfourfox/issues/detail?id=16)). This problem is also in the official release. Installing a Persona may fix this issue if you find it bothersome.
* Crash reporting is intentionally disabled to avoid polluting Mozilla's crash tracking system with our reports. Please use your system's crash logs if you are reporting a _reproducible_ crash, or (if you are able) provide a `gdb` backtrace.
* Although 10.4Fx will tell you when an update is available, you must download updates manually at this time.
You are welcome to report other bugs that you find. However, please **do not report Mozilla bugs to us.** If the bug or crash occurs in both the official Mozilla Firefox 17 _(3.6 doesn't count!)_ and in 10.4Fx, this is a Mozilla bug, and you should file it at [Bugzilla](http://bugzilla.mozilla.org/). **You must test your bug in both places -- bugs that are not confirmed to be part of 10.4Fx will be marked invalid** so that we can keep our task list focused. This is the [current list of known issues](http://code.google.com/p/tenfourfox/issues/list).

60
ReleaseNotes190.md Normal file
View File

@ -0,0 +1,60 @@
_This document may be updated for late-breaking changes, so check back here if you are having difficulty._
## System requirements ##
TenFourFox (hereafter "10.4Fx") requires a G3 Power Macintosh, Mac OS X 10.4.11, 100MB of free disk space and 512MB of RAM. 1GB of RAM and a G4 or G5 processor is recommended. Video playback is likely to be poor on systems slower than 1.25GHz; a G5 is recommended. Mac OS X 10.5.8 is supported.
Intel Macintoshes are not supported. Although some users have reported success getting the G3 version of 10.4Fx to run under Rosetta, certain features may not work correctly or at all on Intel Macs, and you may need to completely disable JavaScript compilation for it to work with Rosetta (see [the FAQ](AAATheFAQ.md) for more information). Because Apple no longer supports Rosetta and 10.4Fx is not a Universal binary, it will not run under Lion 10.7 or any subsequent version of Mac OS X.
## Getting TenFourFox ##
Make sure you select the appropriate build for your Mac from the [download page](http://www.tenfourfox.com/). The G3 version will run on any supported Macintosh, but it will not take advantage of the additional features of G4 or G5 processors. The G4 and G5 versions will not run at all on a G3, and the G5 version will perform badly or crash on non-G5 Macintoshes.
If you are using a G4, you should try to choose the correct version for your processor generation (7400 or 7450 "G4e") as performance may be impaired if you run the wrong one. If you don't know which G4 processor you have, the instructions in WhichVersion will tell you how to find out.
## TenFourFox 19 is equivalent to Firefox 19 ##
TenFourFox uses modified Firefox source code, rewritten to remain compatible with Mac OS X v10.4 and the Power Macintosh. It also contains specific optimizations and special features for PowerPC processors. For this reason, it is not exactly the same as Firefox. However, it is intended to be as compatible with it as possible, including most add-ons and [most standard features](TechnicalDifferences.md). You can treat 10.4Fx 19 as equivalent with Firefox 19 in most circumstances, with specific exceptions noted below.
Note that add-ons which require an Intel Macintosh will not work with TenFourFox, even if they are otherwise compatible with Firefox 19, and add-ons that require 10.5 Leopard may not be compatible with TenFourFox running on Mac OS X 10.4 Tiger, even if they are compatible with PowerPC.
## This branch of TenFourFox is the _unstable_ version ##
Starting with Firefox 10 and now Firefox 17, Mozilla is now offering an extended support release version of Firefox ("Firefox **ESR**") intended for environments where users are unable to use rapid-release versions of Firefox due to policy or technical constraints. 10.4Fx 17.x is based on this extended support release and is intended for users who wish to remain with a stable browser core. The _stable_ branch will continue to receive bugfixes and security updates, but will not receive new Firefox features (although it may receive certain 10.4Fx-specific features judged important for our legacy users).
However, for more proficient users who want to try more up-to-date features and help us test new builds of 10.4Fx based on current releases of Firefox, we make available the _unstable_ branch, which is this release. **While the unstable branch is generally suitable for day-to-day use, it does have bugs and is recommended only for advanced users.** Although major bugs will be repaired as promptly as possible, minor and even some moderate severity bugs might not be fixed on a particular timetable. The highest priority is to keep the port viable, which may mean diverting our limited time away from non-critical issues. **If you need a release-quality version of TenFourFox, please use the stable version instead.** You can download the stable version from [our main page](http://www.tenfourfox.com/).
## Plugins and Flash _do not work_ in TenFourFox ##
Plugins on PowerPC are of special concern because Mozilla is making updates to their plugin architecture which may require the plugins themselves to be updated, and there are certain difficult-to-correct bugs with them already on Tiger. Most importantly, QuickTime, Java and Adobe Flash for PowerPC are no longer maintained and have known security risks that can crash, perform malicious operations or leak data, and Flash 10.1 is rapidly becoming unsupported by many applications.
**Plugins no longer function at all as of 10.4Fx 19.0.** Due to irreversible internal browser changes, there is no way to reenable them. Pages that use plugins will show a warning box instead.
For Internet video, we now recommend the use of TenFourFox's optional QuickTimeEnabler. This allows many videos to be handled in QuickTime Player directly.
You can also download videos for separate viewing using [Perian](http://www.perian.org/) and any of the available video download add-ons for Firefox.
For YouTube, you may also be able to use [MacTubes](http://macapps.sakura.ne.jp/mactubes/index_en.html). If you have a high end G4 or G5, you can also use WebM for selected videos by visiting http://www.youtube.com/html5 and enabling HTML5 video. This will set a temporary cookie enabling browser-based video without Flash. You do not need a YouTube account for this feature, but you may need to periodically renew the cookie setting. Not all video is available in WebM.
For a more in-depth explanation of this policy and other workarounds, see PluginsNoLongerSupported.
## New features in this version of TenFourFox ##
* All new standard features of Firefox 19 where supported, including enhanced display architecture and additional CSS features.
* New internal architecture built with `gcc` 4.6.3 ([issue 52](https://code.google.com/p/tenfourfox/issues/detail?id=52)).
* AltiVec-enhanced blurring and shadowing ([issue 189](https://code.google.com/p/tenfourfox/issues/detail?id=189)).
* Improved threading performance on multi-processor Power Macs ([issue 205](https://code.google.com/p/tenfourfox/issues/detail?id=205)). This is also part of 17.0.3.
* Font enumeration performance is improved ([issue 195](https://code.google.com/p/tenfourfox/issues/detail?id=195)). This is also part of 17.0.2.
## Known issues specific to TenFourFox ##
* Remember: **Plugins do not function in TenFourFox.** See PluginsNoLongerSupported for an explanation and suggested workarounds.
* TenFourFox uses a lighter chrome for windows and dialogue boxes than prior versions or the official Mac Firefox. This is intentional.
* Bitmap-only fonts (usually Type 1 PostScript) cannot be used by the 10.4Fx font renderer and are discarded. A fallback font will be used in their place.
* Due to poor performance on Power Macs, the `PDF.js` PDF viewer is not enabled by default. (It can be turned on from `about:config`.)
* 10.4Fx does not currently support WebGL, WebRTC or the webapp runtime, and scripts such as Arabic or Indic requiring glyph reordering or language-specific ligatures may not appear correctly. See TechnicalDifferences for the complete list of changes necessary for 10.4Fx. See [issue 5](https://code.google.com/p/tenfourfox/issues/detail?id=5) for notes specific to the font issue.
* The titlebar does not always properly match the menu gradient ([issue 16](https://code.google.com/p/tenfourfox/issues/detail?id=16)). This problem is also in the official release. Installing a Persona may fix this issue if you find it bothersome.
* Crash reporting is intentionally disabled to avoid polluting Mozilla's crash tracking system with our reports. Please use your system's crash logs if you are reporting a _reproducible_ crash, or (if you are able) provide a `gdb` backtrace.
* Although 10.4Fx will tell you when an update is available, you must download updates manually at this time.
You are welcome to report other bugs that you find. However, please **do not report Mozilla bugs to us.** If the bug or crash occurs in both the official Mozilla Firefox 19 _(3.6 doesn't count!)_ and in 10.4Fx, this is a Mozilla bug, and you should file it at [Bugzilla](http://bugzilla.mozilla.org/). **You must test your bug in both places -- bugs that are not confirmed to be part of 10.4Fx will be marked invalid** so that we can keep our task list focused. This is the [current list of known issues](http://code.google.com/p/tenfourfox/issues/list).

60
ReleaseNotes1902.md Normal file
View File

@ -0,0 +1,60 @@
_This document may be updated for late-breaking changes, so check back here if you are having difficulty._
## System requirements ##
TenFourFox (hereafter "10.4Fx") requires a G3 Power Macintosh, Mac OS X 10.4.11, 100MB of free disk space and 512MB of RAM. 1GB of RAM and a G4 or G5 processor is recommended. Video playback is likely to be poor on systems slower than 1.25GHz; a G5 is recommended. Mac OS X 10.5.8 is supported.
Intel Macintoshes are not supported. Although some users have reported success getting the G3 version of 10.4Fx to run under Rosetta, certain features may not work correctly or at all on Intel Macs, and you may need to completely disable JavaScript compilation for it to work with Rosetta (see [the FAQ](AAATheFAQ.md) for more information). Because Apple no longer supports Rosetta and 10.4Fx is not a Universal binary, it will not run under Lion 10.7 or any subsequent version of Mac OS X.
## Getting TenFourFox ##
Make sure you select the appropriate build for your Mac from the [download page](http://www.tenfourfox.com/). The G3 version will run on any supported Macintosh, but it will not take advantage of the additional features of G4 or G5 processors. The G4 and G5 versions will not run at all on a G3, and the G5 version will perform badly or crash on non-G5 Macintoshes.
If you are using a G4, you should try to choose the correct version for your processor generation (7400 or 7450 "G4e") as performance may be impaired if you run the wrong one. If you don't know which G4 processor you have, the instructions in WhichVersion will tell you how to find out.
## TenFourFox 19 is equivalent to Firefox 19 ##
TenFourFox uses modified Firefox source code, rewritten to remain compatible with Mac OS X v10.4 and the Power Macintosh. It also contains specific optimizations and special features for PowerPC processors. For this reason, it is not exactly the same as Firefox. However, it is intended to be as compatible with it as possible, including most add-ons and [most standard features](TechnicalDifferences.md). You can treat 10.4Fx 19 as equivalent with Firefox 19 in most circumstances, with specific exceptions noted below.
Note that add-ons which require an Intel Macintosh will not work with TenFourFox, even if they are otherwise compatible with Firefox 19, and add-ons that require 10.5 Leopard may not be compatible with TenFourFox running on Mac OS X 10.4 Tiger, even if they are compatible with PowerPC.
## This branch of TenFourFox is the _unstable_ version ##
Starting with Firefox 10 and now Firefox 17, Mozilla is now offering an extended support release version of Firefox ("Firefox **ESR**") intended for environments where users are unable to use rapid-release versions of Firefox due to policy or technical constraints. 10.4Fx 17.x is based on this extended support release and is intended for users who wish to remain with a stable browser core. The _stable_ branch will continue to receive bugfixes and security updates, but will not receive new Firefox features (although it may receive certain 10.4Fx-specific features judged important for our legacy users).
However, for more proficient users who want to try more up-to-date features and help us test new builds of 10.4Fx based on current releases of Firefox, we make available the _unstable_ branch, which is this release. **While the unstable branch is generally suitable for day-to-day use, it does have bugs and is recommended only for advanced users.** Although major bugs will be repaired as promptly as possible, minor and even some moderate severity bugs might not be fixed on a particular timetable. The highest priority is to keep the port viable, which may mean diverting our limited time away from non-critical issues. **If you need a release-quality version of TenFourFox, please use the stable version instead.** You can download the stable version from [our main page](http://www.tenfourfox.com/).
## Plugins and Flash _do not work_ in TenFourFox ##
Plugins on PowerPC are of special concern because Mozilla is making updates to their plugin architecture which may require the plugins themselves to be updated, and there are certain difficult-to-correct bugs with them already on Tiger. Most importantly, QuickTime, Java and Adobe Flash for PowerPC are no longer maintained and have known security risks that can crash, perform malicious operations or leak data, and Flash 10.1 is rapidly becoming unsupported by many applications.
**Plugins no longer function at all as of 10.4Fx 19.0.** Due to irreversible internal browser changes, there is no way to reenable them. Pages that use plugins will show a warning box instead.
For Internet video, we now recommend the use of TenFourFox's optional QuickTimeEnabler. This allows many videos to be handled in QuickTime Player directly.
You can also download videos for separate viewing using [Perian](http://www.perian.org/) and any of the available video download add-ons for Firefox.
For YouTube, you may also be able to use [MacTubes](http://macapps.sakura.ne.jp/mactubes/index_en.html). If you have a high end G4 or G5, you can also use WebM for selected videos by visiting http://www.youtube.com/html5 and enabling HTML5 video. This will set a temporary cookie enabling browser-based video without Flash. You do not need a YouTube account for this feature, but you may need to periodically renew the cookie setting. Not all video is available in WebM.
For a more in-depth explanation of this policy and other workarounds, see PluginsNoLongerSupported.
## Fixed in this version of TenFourFox ##
* This release fixes a high-priority Mozilla security issue (Mozilla [bug 848644](https://code.google.com/p/tenfourfox/issues/detail?id=48644)).
* A potential crash is repaired in the JavaScript compiler ([issue 211](https://code.google.com/p/tenfourfox/issues/detail?id=211)).
* Restoring bookmarks from Safari should work again ([issue 194](https://code.google.com/p/tenfourfox/issues/detail?id=194)).
**Please note that there was no 19.0.1 release; that version was reserved for mobile Firefox only.**
## Known issues specific to TenFourFox ##
* Remember: **Plugins do not function in TenFourFox.** See PluginsNoLongerSupported for an explanation and suggested workarounds.
* TenFourFox uses a lighter chrome for windows and dialogue boxes than prior versions or the official Mac Firefox. This is intentional.
* Bitmap-only fonts (usually Type 1 PostScript) cannot be used by the 10.4Fx font renderer and are discarded. A fallback font will be used in their place.
* Due to poor performance on Power Macs, the `PDF.js` PDF viewer is not enabled by default. (It can be turned on from `about:config`.)
* 10.4Fx does not currently support WebGL, WebRTC or the webapp runtime, and scripts such as Arabic or Indic requiring glyph reordering or language-specific ligatures may not appear correctly. See TechnicalDifferences for the complete list of changes necessary for 10.4Fx. See [issue 5](https://code.google.com/p/tenfourfox/issues/detail?id=5) for notes specific to the font issue.
* The titlebar does not always properly match the menu gradient ([issue 16](https://code.google.com/p/tenfourfox/issues/detail?id=16)). This problem is also in the official release. Installing a Persona may fix this issue if you find it bothersome.
* Crash reporting is intentionally disabled to avoid polluting Mozilla's crash tracking system with our reports. Please use your system's crash logs if you are reporting a _reproducible_ crash, or (if you are able) provide a `gdb` backtrace.
* Although 10.4Fx will tell you when an update is available, you must download updates manually at this time.
You are welcome to report other bugs that you find. However, please **do not report Mozilla bugs to us.** If the bug or crash occurs in both the official Mozilla Firefox 19 _(3.6 doesn't count!)_ and in 10.4Fx, this is a Mozilla bug, and you should file it at [Bugzilla](http://bugzilla.mozilla.org/). **You must test your bug in both places -- bugs that are not confirmed to be part of 10.4Fx will be marked invalid** so that we can keep our task list focused. This is the [current list of known issues](http://code.google.com/p/tenfourfox/issues/list).

66
ReleaseNotes200.md Normal file
View File

@ -0,0 +1,66 @@
_This document may be updated for late-breaking changes, so check back here if you are having difficulty._
## System requirements ##
TenFourFox (hereafter "10.4Fx") requires a G3 Power Macintosh, Mac OS X 10.4.11, 100MB of free disk space and 512MB of RAM. 1GB of RAM and a G4 or G5 processor is recommended. Video playback is likely to be poor on systems slower than 1.25GHz; a G5 is recommended. Mac OS X 10.5.8 is supported.
Intel Macintoshes are not supported. Although some users have reported success getting the G3 version of 10.4Fx to run under Rosetta, certain features may not work correctly or at all on Intel Macs, and you may need to completely disable JavaScript compilation for it to work with Rosetta (see [the FAQ](AAATheFAQ.md) for more information). Because Apple no longer supports Rosetta and 10.4Fx is not a Universal binary, it will not run under Lion 10.7 or any subsequent version of Mac OS X.
## Getting TenFourFox ##
Make sure you select the appropriate build for your Mac from the [download page](http://www.tenfourfox.com/). The G3 version will run on any supported Macintosh, but it will not take advantage of the additional features of G4 or G5 processors. The G4 and G5 versions will not run at all on a G3, and the G5 version will perform badly or crash on non-G5 Macintoshes.
If you are using a G4, you should try to choose the correct version for your processor generation (7400 or 7450 "G4e") as performance may be impaired if you run the wrong one. If you don't know which G4 processor you have, the instructions in WhichVersion will tell you how to find out.
## TenFourFox 20 is equivalent to Firefox 20 ##
TenFourFox uses modified Firefox source code, rewritten to remain compatible with Mac OS X v10.4 and the Power Macintosh. It also contains specific optimizations and special features for PowerPC processors. For this reason, it is not exactly the same as Firefox. However, it is intended to be as compatible with it as possible, including most add-ons and [most standard features](TechnicalDifferences.md). You can treat 10.4Fx 20 as equivalent with Firefox 20 in most circumstances, with specific exceptions noted below.
Note that add-ons which require an Intel Macintosh will not work with TenFourFox, even if they are otherwise compatible with Firefox, and add-ons that require 10.5 Leopard may not be compatible with TenFourFox running on Mac OS X 10.4 Tiger, even if they are compatible with PowerPC.
## This branch of TenFourFox is the _unstable_ version ##
Starting with Firefox 10 and now Firefox 17, Mozilla is now offering an extended support release version of Firefox ("Firefox **ESR**") intended for environments where users are unable to use rapid-release versions of Firefox due to policy or technical constraints. 10.4Fx 17.x is based on this extended support release and is intended for users who wish to remain with a stable browser core. The _stable_ branch will continue to receive bugfixes and security updates, but will not receive new Firefox features (although it may receive certain 10.4Fx-specific features judged important for our legacy users).
However, for more proficient users who want to try more up-to-date features and help us test new builds of 10.4Fx based on current releases of Firefox, we make available the _unstable_ branch, which is this release. **While the unstable branch is generally suitable for day-to-day use, it does have bugs and is recommended only for advanced users.** Although major bugs will be repaired as promptly as possible, minor and even some moderate severity bugs might not be fixed on a particular timetable. The highest priority is to keep the port viable, which may mean diverting our limited time away from non-critical issues. **If you need a release-quality version of TenFourFox, please use the stable version instead.** You can download the stable version from [our main page](http://www.tenfourfox.com/).
## Plugins and Flash _do not work_ in TenFourFox ##
Plugins on PowerPC are of special concern because Mozilla is making updates to their plugin architecture which may require the plugins themselves to be updated, and there are certain difficult-to-correct bugs with them already on Tiger. Most importantly, QuickTime, Java and Adobe Flash for PowerPC are no longer maintained and have known security risks that can crash, perform malicious operations or leak data, and Flash 10.1 is rapidly becoming unsupported by many applications.
**Plugins no longer function at all as of 10.4Fx 19.0.** Due to irreversible internal browser changes, there is no way to reenable them. Pages that use plugins will show a warning box instead.
For Internet video, we now recommend the use of TenFourFox's optional QuickTimeEnabler. This allows many videos to be handled in QuickTime Player directly.
You can also download videos for separate viewing using [Perian](http://www.perian.org/) and any of the available video download add-ons for Firefox.
For YouTube, you may also be able to use [MacTubes](http://macapps.sakura.ne.jp/mactubes/index_en.html). If you have a high end G4 or G5, you can also use WebM for selected videos by visiting http://www.youtube.com/html5 and enabling HTML5 video. This will set a temporary cookie enabling browser-based video without Flash. You do not need a YouTube account for this feature, but you may need to periodically renew the cookie setting. Not all video is available in WebM.
For a more in-depth explanation of this policy and other workarounds, see PluginsNoLongerSupported.
## New features in this version of TenFourFox ##
* All new supported standard features of Firefox 20, including further graphics performance improvements and redesigned downloads interface.
* TenFourFox now supports WebRTC and `getUserMedia` on 10.4 systems ([issue 214](https://code.google.com/p/tenfourfox/issues/detail?id=214)) for most IIDC-compliant FireWire video cameras, built-in iSight and analogue audio, and many QuickTime-compatible capture devices. For a list of compatible video and audio devices, see VideoDeviceSupport.
## Fixed in this version of TenFourFox ##
* Web applications using offline storage should now work properly again ([issue 213](https://code.google.com/p/tenfourfox/issues/detail?id=213)), fixing the regression introduced in 17.0. **You may need to clear stored databases to restore function, which will require you to download offline content again. You can reset stored databases either by completely resetting your profile, or going to Preferences > Advanced > Network and removing the databases at the bottom of the window pane.** You should only need to do this once. For information on resetting your profile, see [our support link](http://tenfourfox.tenderapp.com/kb/general/how-to-reset-your-profile).
## Known issues in this version of TenFourFox ##
* Canvas compositing is not yet supported ([issue 216](https://code.google.com/p/tenfourfox/issues/detail?id=216)).
* Certain JavaScript operations are not well optimized due to front-end changes ([issue 215](https://code.google.com/p/tenfourfox/issues/detail?id=215)). This regression was first introduced in 19.0.
## Known issues specific to TenFourFox ##
* Remember: **Plugins do not function in TenFourFox.** See PluginsNoLongerSupported for an explanation and suggested workarounds.
* TenFourFox uses a lighter chrome for windows and dialogue boxes than prior versions or the official Mac Firefox. This is intentional.
* Bitmap-only fonts (usually Type 1 PostScript) cannot be used by the 10.4Fx font renderer and are discarded. A fallback font will be used in their place.
* Due to poor performance on Power Macs, the `PDF.js` PDF viewer is not enabled by default. (It can be turned on from `about:config`.)
* 10.4Fx does not currently support WebGL or the webapp runtime, and scripts such as Arabic or Indic requiring glyph reordering or language-specific ligatures may not appear correctly. See TechnicalDifferences for the complete list of changes necessary for 10.4Fx. See [issue 5](https://code.google.com/p/tenfourfox/issues/detail?id=5) for notes specific to the font issue.
* The titlebar does not always properly match the menu gradient ([issue 16](https://code.google.com/p/tenfourfox/issues/detail?id=16)). This problem is also in the official release. Installing a Persona may fix this issue if you find it bothersome.
* Crash reporting is intentionally disabled to avoid polluting Mozilla's crash tracking system with our reports. Please use your system's crash logs if you are reporting a _reproducible_ crash, or (if you are able) provide a `gdb` backtrace.
* Although 10.4Fx will tell you when an update is available, you must download updates manually at this time.
You are welcome to report other bugs that you find. However, please **do not report Mozilla bugs to us.** If the bug or crash occurs in both the official Mozilla Firefox 20 _(3.6 doesn't count!)_ and in 10.4Fx, this is a Mozilla bug, and you should file it at [Bugzilla](http://bugzilla.mozilla.org/). **You must test your bug in both places -- bugs that are not confirmed to be part of 10.4Fx will be marked invalid** so that we can keep our task list focused. This is the [current list of known issues](http://code.google.com/p/tenfourfox/issues/list).

62
ReleaseNotes210.md Normal file
View File

@ -0,0 +1,62 @@
_This document may be updated for late-breaking changes, so check back here if you are having difficulty._
## System requirements ##
TenFourFox (hereafter "10.4Fx") requires a G3 Power Macintosh, Mac OS X 10.4.11, 100MB of free disk space and 512MB of RAM. 1GB of RAM and a G4 or G5 processor is recommended. Video playback is likely to be poor on systems slower than 1.25GHz; a G5 is recommended. Mac OS X 10.5.8 is supported.
Intel Macintoshes are not supported. Although some users have reported success getting the G3 version of 10.4Fx to run under Rosetta, certain features may not work correctly or at all on Intel Macs, and you may need to completely disable JavaScript compilation for it to work with Rosetta (see [the FAQ](AAATheFAQ.md) for more information). Because Apple no longer supports Rosetta and 10.4Fx is not a Universal binary, it will not run under Lion 10.7 or any subsequent version of Mac OS X.
## Getting TenFourFox ##
Make sure you select the appropriate build for your Mac from the [download page](http://www.tenfourfox.com/). The G3 version will run on any supported Macintosh, but it will not take advantage of the additional features of G4 or G5 processors. The G4 and G5 versions will not run at all on a G3, and the G5 version will perform badly or crash on non-G5 Macintoshes.
If you are using a G4, you should try to choose the correct version for your processor generation (7400 or 7450 "G4e") as performance may be impaired if you run the wrong one. If you don't know which G4 processor you have, the instructions in WhichVersion will tell you how to find out.
## TenFourFox 21 is equivalent to Firefox 21 ##
TenFourFox uses modified Firefox source code, rewritten to remain compatible with Mac OS X v10.4 and the Power Macintosh. It also contains specific optimizations and special features for PowerPC processors. For this reason, it is not exactly the same as Firefox. However, it is intended to be as compatible with it as possible, including most add-ons and [most standard features](TechnicalDifferences.md). You can treat 10.4Fx 21 as equivalent with Firefox 21 in most circumstances, with specific exceptions noted below.
Note that add-ons which require an Intel Macintosh will not work with TenFourFox, even if they are otherwise compatible with Firefox, and add-ons that require 10.5 Leopard may not be compatible with TenFourFox running on Mac OS X 10.4 Tiger, even if they are compatible with PowerPC.
## This branch of TenFourFox is the _unstable_ version ##
Starting with Firefox 10 and now Firefox 17, Mozilla is now offering an extended support release version of Firefox ("Firefox **ESR**") intended for environments where users are unable to use rapid-release versions of Firefox due to policy or technical constraints. 10.4Fx 17.x is based on this extended support release and is intended for users who wish to remain with a stable browser core. The _stable_ branch will continue to receive bugfixes and security updates, but will not receive new Firefox features (although it may receive certain 10.4Fx-specific features judged important for our legacy users).
However, for more proficient users who want to try more up-to-date features and help us test new builds of 10.4Fx based on current releases of Firefox, we make available the _unstable_ branch, which is this release. **While the unstable branch is generally suitable for day-to-day use, it does have bugs and is recommended only for advanced users.** Although major bugs will be repaired as promptly as possible, minor and even some moderate severity bugs might not be fixed on a particular timetable. The highest priority is to keep the port viable, which may mean diverting our limited time away from non-critical issues. **If you need a release-quality version of TenFourFox, please use the stable version instead.** You can download the stable version from [our main page](http://www.tenfourfox.com/).
## Plugins and Flash _do not work_ in TenFourFox ##
Plugins on PowerPC are of special concern because Mozilla is making updates to their plugin architecture which may require the plugins themselves to be updated, and there are certain difficult-to-correct bugs with them already on Tiger. Most importantly, QuickTime, Java and Adobe Flash for PowerPC are no longer maintained and have known security risks that can crash, perform malicious operations or leak data, and Flash 10.1 is rapidly becoming unsupported by many applications.
**Plugins no longer function at all as of 10.4Fx 19.0.** Due to irreversible internal browser changes, there is no way to reenable them. Pages that use plugins will show a warning box instead.
For Internet video, we now recommend the use of TenFourFox's optional QuickTimeEnabler. This allows many videos to be handled in QuickTime Player directly.
You can also download videos for separate viewing using [Perian](http://www.perian.org/) and any of the available video download add-ons for Firefox.
For YouTube, you may also be able to use [MacTubes](http://macapps.sakura.ne.jp/mactubes/index_en.html). If you have a high end G4 or G5, you can also use WebM for selected videos by visiting http://www.youtube.com/html5 and enabling HTML5 video. This will set a temporary cookie enabling browser-based video without Flash. You do not need a YouTube account for this feature, but you may need to periodically renew the cookie setting. Not all video is available in WebM.
For a more in-depth explanation of this policy and other workarounds, see PluginsNoLongerSupported.
## New features in this version of TenFourFox ##
* All new supported standard features of Firefox 21, including Do Not Track enhancements, style sheet scoping and additional HTML5 features.
## Fixed in this version of TenFourFox ##
* Canvas compositing, introduced in Firefox 20, is now supported ([issue 216](https://code.google.com/p/tenfourfox/issues/detail?id=216)).
* Crashes with changing canvas paint mode under certain situations are now fixed ([issue 217](https://code.google.com/p/tenfourfox/issues/detail?id=217)). This fix is also in 17.0.6.
## Known issues specific to TenFourFox ##
* Remember: **Plugins do not function in TenFourFox.** See PluginsNoLongerSupported for an explanation and suggested workarounds.
* Not all cameras work with the internal User Media/WebRTC support. For tested devices (working and non-working), see VideoDeviceSupport.
* TenFourFox uses a lighter chrome for windows and dialogue boxes than prior versions or the official Mac Firefox. This is intentional.
* Bitmap-only fonts (usually Type 1 PostScript) cannot be used by the 10.4Fx font renderer and are discarded. A fallback font will be used in their place.
* Due to poor performance on Power Macs, the `PDF.js` PDF viewer is not enabled by default. (It can be turned on from `about:config`.)
* 10.4Fx does not currently support WebGL or the webapp runtime, and scripts such as Arabic or Indic requiring glyph reordering or language-specific ligatures may not appear correctly. See TechnicalDifferences for the complete list of changes necessary for 10.4Fx. See [issue 5](https://code.google.com/p/tenfourfox/issues/detail?id=5) for notes specific to the font issue.
* The titlebar does not always properly match the menu gradient ([issue 16](https://code.google.com/p/tenfourfox/issues/detail?id=16)). This problem is also in the official release. Installing a Persona may fix this issue if you find it bothersome.
* Crash reporting is intentionally disabled to avoid polluting Mozilla's crash tracking system with our reports. Please use your system's crash logs if you are reporting a _reproducible_ crash, or (if you are able) provide a `gdb` backtrace.
* Although 10.4Fx will tell you when an update is available, you must download updates manually at this time.
You are welcome to report other bugs that you find. However, please **do not report Mozilla bugs to us.** If the bug or crash occurs in both the official Mozilla Firefox 21 _(3.6 doesn't count!)_ and in 10.4Fx, this is a Mozilla bug, and you should file it at [Bugzilla](http://bugzilla.mozilla.org/). **You must test your bug in both places -- bugs that are not confirmed to be part of 10.4Fx will be marked invalid** so that we can keep our task list focused. This is the [current list of known issues](http://code.google.com/p/tenfourfox/issues/list).

63
ReleaseNotes220.md Normal file
View File

@ -0,0 +1,63 @@
_This document may be updated for late-breaking changes, so check back here if you are having difficulty._
## System requirements ##
TenFourFox (hereafter "10.4Fx") requires a G3 Power Macintosh, Mac OS X 10.4.11, 100MB of free disk space and 512MB of RAM. 1GB of RAM and a G4 or G5 processor is recommended. Video playback is likely to be poor on systems slower than 1.25GHz; a G5 is recommended. Mac OS X 10.5.8 is supported.
Intel Macintoshes are not supported. Although some users have reported success getting the G3 version of 10.4Fx to run under Rosetta, certain features may not work correctly or at all on Intel Macs, and you may need to completely disable JavaScript compilation for it to work with Rosetta (see [the FAQ](AAATheFAQ.md) for more information). Because Apple no longer supports Rosetta and 10.4Fx is not a Universal binary, it will not run under Lion 10.7 or any subsequent version of Mac OS X.
## Getting TenFourFox ##
Make sure you select the appropriate build for your Mac from the [download page](http://www.tenfourfox.com/). The G3 version will run on any supported Macintosh, but it will not take advantage of the additional features of G4 or G5 processors. The G4 and G5 versions will not run at all on a G3, and the G5 version will perform badly or crash on non-G5 Macintoshes.
If you are using a G4, you should try to choose the correct version for your processor generation (7400 or 7450 "G4e") as performance may be impaired if you run the wrong one. If you don't know which G4 processor you have, the instructions in WhichVersion will tell you how to find out.
## TenFourFox 22 is equivalent to Firefox 22 ##
TenFourFox uses modified Firefox source code, rewritten to remain compatible with Mac OS X v10.4 and the Power Macintosh. It also contains specific optimizations and special features for PowerPC processors. For this reason, it is not exactly the same as Firefox. However, it is intended to be as compatible with it as possible, including most add-ons and [most standard features](TechnicalDifferences.md). You can treat 10.4Fx 22 as equivalent with Firefox 22 in most circumstances, with specific exceptions noted below.
Note that add-ons which require an Intel Macintosh will not work with TenFourFox, even if they are otherwise compatible with Firefox, and add-ons that require 10.5 Leopard may not be compatible with TenFourFox running on Mac OS X 10.4 Tiger, even if they are compatible with PowerPC.
## This branch of TenFourFox is the _unstable_ version ##
Starting with Firefox 10 and now Firefox 17, Mozilla is now offering an extended support release version of Firefox ("Firefox **ESR**") intended for environments where users are unable to use rapid-release versions of Firefox due to policy or technical constraints. 10.4Fx 17.x is based on this extended support release and is intended for users who wish to remain with a stable browser core. The _stable_ branch will continue to receive bugfixes and security updates, but will not receive new Firefox features (although it may receive certain 10.4Fx-specific features judged important for our legacy users).
However, for more proficient users who want to try more up-to-date features and help us test new builds of 10.4Fx based on current releases of Firefox, we make available the _unstable_ branch, which is this release. **While the unstable branch is generally suitable for day-to-day use, it does have bugs and is recommended only for advanced users.** Although major bugs will be repaired as promptly as possible, minor and even some moderate severity bugs might not be fixed on a particular timetable. The highest priority is to keep the port viable, which may mean diverting our limited time away from non-critical issues. **If you need a release-quality version of TenFourFox, please use the stable version instead.** You can download the stable version from [our main page](http://www.tenfourfox.com/).
## Plugins and Flash _do not work_ in TenFourFox ##
Plugins on PowerPC are of special concern because Mozilla is making updates to their plugin architecture which may require the plugins themselves to be updated, and there are certain difficult-to-correct bugs with them already on Tiger. Most importantly, QuickTime, Java and Adobe Flash for PowerPC are no longer maintained and have known security risks that can crash, perform malicious operations or leak data, and Flash 10.1 is rapidly becoming unsupported by many applications.
**Plugins no longer function at all as of 10.4Fx 19.0.** Due to irreversible internal browser changes, there is no way to reenable them. Pages that use plugins will show a warning box instead.
For Internet video, we now recommend the use of TenFourFox's optional QuickTimeEnabler. This allows many videos to be handled in QuickTime Player directly.
You can also download videos for separate viewing using [Perian](http://www.perian.org/) and any of the available video download add-ons for Firefox.
For YouTube, you may also be able to use [MacTubes](http://macapps.sakura.ne.jp/mactubes/index_en.html). If you have a high end G4 or G5, you can also use WebM for selected videos by visiting http://www.youtube.com/html5 and enabling HTML5 video. This will set a temporary cookie enabling browser-based video without Flash. You do not need a YouTube account for this feature, but you may need to periodically renew the cookie setting. Not all video is available in WebM.
For a more in-depth explanation of this policy and other workarounds, see PluginsNoLongerSupported.
## New features in this version of TenFourFox ##
* All new supported standard features of Firefox 22, including XUL notifications (replacing Growl), additional CSS3 and HTML5 features, Dock download progress bar support, and improved image rendering performance.
## Fixed in this version of TenFourFox ##
* Colour management is enabled for ICCv4 profiles, improving colour fidelity with colour-managed images ([issue 225](https://code.google.com/p/tenfourfox/issues/detail?id=225)). This change is also in 17.0.7.
## Known issues specific to TenFourFox ##
* Remember: **Plugins do not function in TenFourFox.** See PluginsNoLongerSupported for an explanation and suggested workarounds.
* Not all cameras work with the internal User Media/WebRTC support. For tested devices (working and non-working), see VideoDeviceSupport.
* TenFourFox uses a lighter chrome for windows and dialogue boxes than prior versions or the official Mac Firefox. This is intentional.
* Systems with large numbers of fonts installed may experience intermittent pauses.
* Some pages may perform better on 10.5 systems than 10.4 ([issue 193](https://code.google.com/p/tenfourfox/issues/detail?id=193)).
* Bitmap-only fonts (usually Type 1 PostScript) cannot be used by the 10.4Fx font renderer and are discarded. A fallback font will be used in their place.
* Due to poor performance on Power Macs, the `PDF.js` PDF viewer is not enabled by default. (It can be turned on from `about:config`.)
* 10.4Fx does not currently support WebGL or the webapp runtime, and scripts such as Arabic or Indic requiring glyph reordering or language-specific ligatures may not appear correctly. See TechnicalDifferences for the complete list of changes necessary for 10.4Fx. See [issue 5](https://code.google.com/p/tenfourfox/issues/detail?id=5) for notes specific to the font issue.
* The titlebar does not always properly match the menu gradient ([issue 16](https://code.google.com/p/tenfourfox/issues/detail?id=16)). This problem is also in the official release. Installing a Persona may fix this issue if you find it bothersome.
* Crash reporting is intentionally disabled to avoid polluting Mozilla's crash tracking system with our reports. Please use your system's crash logs if you are reporting a _reproducible_ crash, or (if you are able) provide a `gdb` backtrace.
* Although 10.4Fx will tell you when an update is available, you must download updates manually at this time.
You are welcome to report other bugs that you find. However, please **do not report Mozilla bugs to us.** If the bug or crash occurs in both the official Mozilla Firefox 22 _(3.6 doesn't count!)_ and in 10.4Fx, this is a Mozilla bug, and you should file it at [Bugzilla](http://bugzilla.mozilla.org/). **You must test your bug in both places -- bugs that are not confirmed to be part of 10.4Fx will be marked invalid** so that we can keep our task list focused. This is the [current list of known issues](http://code.google.com/p/tenfourfox/issues/list).

66
ReleaseNotes2201.md Normal file
View File

@ -0,0 +1,66 @@
_This document may be updated for late-breaking changes, so check back here if you are having difficulty._
## System requirements ##
TenFourFox (hereafter "10.4Fx") requires a G3 Power Macintosh, Mac OS X 10.4.11, 100MB of free disk space and 512MB of RAM. 1GB of RAM and a G4 or G5 processor is recommended. Video playback is likely to be poor on systems slower than 1.25GHz; a G5 is recommended. Mac OS X 10.5.8 is supported.
Intel Macintoshes are not supported. Although some users have reported success getting the G3 version of 10.4Fx to run under Rosetta, certain features may not work correctly or at all on Intel Macs, and you may need to completely disable JavaScript compilation for it to work with Rosetta (see [the FAQ](AAATheFAQ.md) for more information). Because Apple no longer supports Rosetta and 10.4Fx is not a Universal binary, it will not run under Lion 10.7 or any subsequent version of Mac OS X.
## Getting TenFourFox ##
Make sure you select the appropriate build for your Mac from the [download page](http://www.tenfourfox.com/). The G3 version will run on any supported Macintosh, but it will not take advantage of the additional features of G4 or G5 processors. The G4 and G5 versions will not run at all on a G3, and the G5 version will perform badly or crash on non-G5 Macintoshes.
If you are using a G4, you should try to choose the correct version for your processor generation (7400 or 7450 "G4e") as performance may be impaired if you run the wrong one. If you don't know which G4 processor you have, the instructions in WhichVersion will tell you how to find out.
## TenFourFox 22 is equivalent to Firefox 22 ##
TenFourFox uses modified Firefox source code, rewritten to remain compatible with Mac OS X v10.4 and the Power Macintosh. It also contains specific optimizations and special features for PowerPC processors. For this reason, it is not exactly the same as Firefox. However, it is intended to be as compatible with it as possible, including most add-ons and [most standard features](TechnicalDifferences.md). You can treat 10.4Fx 22 as equivalent with Firefox 22 in most circumstances, with specific exceptions noted below.
Note that add-ons which require an Intel Macintosh will not work with TenFourFox, even if they are otherwise compatible with Firefox, and add-ons that require 10.5 Leopard may not be compatible with TenFourFox running on Mac OS X 10.4 Tiger, even if they are compatible with PowerPC.
**Version 22.0.1 does not correspond to an official release of Firefox. This version is a security and performance update specific to TenFourFox.**
## This branch of TenFourFox is the _unstable_ version ##
Starting with Firefox 10 and now Firefox 17, Mozilla is now offering an extended support release version of Firefox ("Firefox **ESR**") intended for environments where users are unable to use rapid-release versions of Firefox due to policy or technical constraints. 10.4Fx 17.x is based on this extended support release and is intended for users who wish to remain with a stable browser core. The _stable_ branch will continue to receive bugfixes and security updates, but will not receive new Firefox features (although it may receive certain 10.4Fx-specific features judged important for our legacy users).
However, for more proficient users who want to try more up-to-date features and help us test new builds of 10.4Fx based on current releases of Firefox, we make available the _unstable_ branch, which is this release. **While the unstable branch is generally suitable for day-to-day use, it does have bugs and is recommended only for advanced users.** Although major bugs will be repaired as promptly as possible, minor and even some moderate severity bugs might not be fixed on a particular timetable. The highest priority is to keep the port viable, which may mean diverting our limited time away from non-critical issues. **If you need a release-quality version of TenFourFox, please use the stable version instead.** You can download the stable version from [our main page](http://www.tenfourfox.com/).
## Plugins and Flash _do not work_ in TenFourFox ##
Plugins on PowerPC are of special concern because Mozilla is making updates to their plugin architecture which may require the plugins themselves to be updated, and there are certain difficult-to-correct bugs with them already on Tiger. Most importantly, QuickTime, Java and Adobe Flash for PowerPC are no longer maintained and have known security risks that can crash, perform malicious operations or leak data, and Flash 10.1 is rapidly becoming unsupported by many applications.
**Plugins no longer function at all as of 10.4Fx 19.0.** Due to irreversible internal browser changes, there is no way to reenable them. Pages that use plugins will show a warning box instead.
For Internet video, we now recommend the use of TenFourFox's optional QuickTimeEnabler. This allows many videos to be handled in QuickTime Player directly.
You can also download videos for separate viewing using [Perian](http://www.perian.org/) and any of the available video download add-ons for Firefox.
For YouTube, you may also be able to use [MacTubes](http://macapps.sakura.ne.jp/mactubes/index_en.html). If you have a high end G4 or G5, you can also use WebM for selected videos by visiting http://www.youtube.com/html5 and enabling HTML5 video. This will set a temporary cookie enabling browser-based video without Flash. You do not need a YouTube account for this feature, but you may need to periodically renew the cookie setting. Not all video is available in WebM.
For a more in-depth explanation of this policy and other workarounds, see PluginsNoLongerSupported.
## Fixed in this version of TenFourFox ##
* Security parity with Firefox 23. If you are using the 22.1 test release, please "downgrade" to 22.0.1 for these security fixes.
* Improved opacity and gradient display performance ([issue 190](https://code.google.com/p/tenfourfox/issues/detail?id=190)).
* Multicore detection is disabled to reduce thread deadlock ([issue 231](https://code.google.com/p/tenfourfox/issues/detail?id=231)).
* Repaired a leak with font references ([issue 232](https://code.google.com/p/tenfourfox/issues/detail?id=232)). This issue does not affect 17.0.x.
* The unstable branch no longer excessively checks for updates ([issue 233](https://code.google.com/p/tenfourfox/issues/detail?id=233)).
* Garbage collection occurs at a smaller threshold to reduce periodic slowdowns ([issue 234](https://code.google.com/p/tenfourfox/issues/detail?id=234)).
## Known issues specific to TenFourFox ##
* Remember: **Plugins do not function in TenFourFox.** See PluginsNoLongerSupported for an explanation and suggested workarounds.
* Not all cameras work with the internal User Media/WebRTC support. For tested devices (working and non-working), see VideoDeviceSupport.
* TenFourFox uses a lighter chrome for windows and dialogue boxes than prior versions or the official Mac Firefox. This is intentional.
* Systems with large numbers of fonts installed may experience intermittent pauses.
* Some pages may perform better on 10.5 systems than 10.4 ([issue 193](https://code.google.com/p/tenfourfox/issues/detail?id=193)).
* Bitmap-only fonts (usually Type 1 PostScript) cannot be used by the 10.4Fx font renderer and are discarded. A fallback font will be used in their place.
* Due to poor performance on Power Macs, the `PDF.js` PDF viewer is not enabled by default. (It can be turned on from `about:config`.)
* 10.4Fx does not currently support WebGL or the webapp runtime, and scripts such as Arabic or Indic requiring glyph reordering or language-specific ligatures may not appear correctly. See TechnicalDifferences for the complete list of changes necessary for 10.4Fx. See [issue 5](https://code.google.com/p/tenfourfox/issues/detail?id=5) for notes specific to the font issue.
* The titlebar does not always properly match the menu gradient ([issue 16](https://code.google.com/p/tenfourfox/issues/detail?id=16)). This problem is also in the official release. Installing a Persona may fix this issue if you find it bothersome.
* Crash reporting is intentionally disabled to avoid polluting Mozilla's crash tracking system with our reports. Please use your system's crash logs if you are reporting a _reproducible_ crash, or (if you are able) provide a `gdb` backtrace.
* Although 10.4Fx will tell you when an update is available, you must download updates manually at this time.
You are welcome to report other bugs that you find. However, please **do not report Mozilla bugs to us.** If the bug or crash occurs in both the official Mozilla Firefox 22 _(3.6 doesn't count!)_ and in 10.4Fx, this is a Mozilla bug, and you should file it at [Bugzilla](http://bugzilla.mozilla.org/). **You must test your bug in both places -- bugs that are not confirmed to be part of 10.4Fx will be marked invalid** so that we can keep our task list focused. This is the [current list of known issues](http://code.google.com/p/tenfourfox/issues/list).

63
ReleaseNotes2202.md Normal file
View File

@ -0,0 +1,63 @@
_This document may be updated for late-breaking changes, so check back here if you are having difficulty._
## System requirements ##
TenFourFox (hereafter "10.4Fx") requires a G3 Power Macintosh, Mac OS X 10.4.11, 100MB of free disk space and 512MB of RAM. 1GB of RAM and a G4 or G5 processor is recommended. Video playback is likely to be poor on systems slower than 1.25GHz; a G5 is recommended. Mac OS X 10.5.8 is supported.
Intel Macintoshes are not supported. Although some users have reported success getting the G3 version of 10.4Fx to run under Rosetta, certain features may not work correctly or at all on Intel Macs, and you may need to completely disable JavaScript compilation for it to work with Rosetta (see [the FAQ](AAATheFAQ.md) for more information). Because Apple no longer supports Rosetta and 10.4Fx is not a Universal binary, it will not run under Lion 10.7 or any subsequent version of Mac OS X.
## Getting TenFourFox ##
Make sure you select the appropriate build for your Mac from the [download page](http://www.tenfourfox.com/). The G3 version will run on any supported Macintosh, but it will not take advantage of the additional features of G4 or G5 processors. The G4 and G5 versions will not run at all on a G3, and the G5 version will perform badly or crash on non-G5 Macintoshes.
If you are using a G4, you should try to choose the correct version for your processor generation (7400 or 7450 "G4e") as performance may be impaired if you run the wrong one. If you don't know which G4 processor you have, the instructions in WhichVersion will tell you how to find out.
## TenFourFox 22 is equivalent to Firefox 22 ##
TenFourFox uses modified Firefox source code, rewritten to remain compatible with Mac OS X v10.4 and the Power Macintosh. It also contains specific optimizations and special features for PowerPC processors. For this reason, it is not exactly the same as Firefox. However, it is intended to be as compatible with it as possible, including most add-ons and [most standard features](TechnicalDifferences.md). You can treat 10.4Fx 22 as equivalent with Firefox 22 in most circumstances, with specific exceptions noted below.
Note that add-ons which require an Intel Macintosh will not work with TenFourFox, even if they are otherwise compatible with Firefox, and add-ons that require 10.5 Leopard may not be compatible with TenFourFox running on Mac OS X 10.4 Tiger, even if they are compatible with PowerPC.
**Version 22.0.2 does not correspond to an official release of Firefox. This version is a security update specific to TenFourFox.**
## This branch of TenFourFox is the _unstable_ version ##
Starting with Firefox 10 and now Firefox 17, Mozilla is now offering an extended support release version of Firefox ("Firefox **ESR**") intended for environments where users are unable to use rapid-release versions of Firefox due to policy or technical constraints. 10.4Fx 17.x is based on this extended support release and is intended for users who wish to remain with a stable browser core. The _stable_ branch will continue to receive bugfixes and security updates, but will not receive new Firefox features (although it may receive certain 10.4Fx-specific features judged important for our legacy users).
However, for more proficient users who want to try more up-to-date features and help us test new builds of 10.4Fx based on current releases of Firefox, we make available the _unstable_ branch, which is this release. **While the unstable branch is generally suitable for day-to-day use, it does have bugs and is recommended only for advanced users.** Although major bugs will be repaired as promptly as possible, minor and even some moderate severity bugs might not be fixed on a particular timetable. The highest priority is to keep the port viable, which may mean diverting our limited time away from non-critical issues. **If you need a release-quality version of TenFourFox, please use the stable version instead.** You can download the stable version from [our main page](http://www.tenfourfox.com/).
## Plugins and Flash _do not work_ in TenFourFox ##
Plugins on PowerPC are of special concern because Mozilla is making updates to their plugin architecture which may require the plugins themselves to be updated, and there are certain difficult-to-correct bugs with them already on Tiger. Most importantly, QuickTime, Java and Adobe Flash for PowerPC are no longer maintained and have known security risks that can crash, perform malicious operations or leak data, and Flash 10.1 is rapidly becoming unsupported by many applications.
**Plugins no longer function at all as of 10.4Fx 19.0.** Due to irreversible internal browser changes, there is no way to reenable them. Pages that use plugins will show a warning box instead.
For Internet video, we now recommend the use of TenFourFox's optional QuickTimeEnabler. This allows many videos to be handled in QuickTime Player directly.
You can also download videos for separate viewing using [Perian](http://www.perian.org/) and any of the available video download add-ons for Firefox.
For YouTube, you may also be able to use [MacTubes](http://macapps.sakura.ne.jp/mactubes/index_en.html). If you have a high end G4 or G5, you can also use WebM for selected videos by visiting http://www.youtube.com/html5 and enabling HTML5 video. This will set a temporary cookie enabling browser-based video without Flash. You do not need a YouTube account for this feature, but you may need to periodically renew the cookie setting. Not all video is available in WebM.
For a more in-depth explanation of this policy and other workarounds, see PluginsNoLongerSupported.
## Fixed in this version of TenFourFox ##
* Security parity with Firefox 24.
* Endian bug fix for the JavaScript JIT ([issue 239](https://code.google.com/p/tenfourfox/issues/detail?id=239)).
* DOM script timeout is empirically further extended ([issue 227](https://code.google.com/p/tenfourfox/issues/detail?id=227)).
## Known issues specific to TenFourFox ##
* Remember: **Plugins do not function in TenFourFox.** See PluginsNoLongerSupported for an explanation and suggested workarounds.
* Not all cameras work with the internal User Media/WebRTC support. For tested devices (working and non-working), see VideoDeviceSupport.
* TenFourFox uses a lighter chrome for windows and dialogue boxes than prior versions or the official Mac Firefox. This is intentional.
* Systems with large numbers of fonts installed may experience intermittent pauses.
* Some pages may perform better on 10.5 systems than 10.4 ([issue 193](https://code.google.com/p/tenfourfox/issues/detail?id=193)).
* Bitmap-only fonts (usually Type 1 PostScript) cannot be used by the 10.4Fx font renderer and are discarded. A fallback font will be used in their place.
* Due to poor performance on Power Macs, the `PDF.js` PDF viewer is not enabled by default. (It can be turned on from `about:config`.)
* 10.4Fx does not currently support WebGL or the webapp runtime, and scripts such as Arabic or Indic requiring glyph reordering or language-specific ligatures may not appear correctly. See TechnicalDifferences for the complete list of changes necessary for 10.4Fx. See [issue 5](https://code.google.com/p/tenfourfox/issues/detail?id=5) for notes specific to the font issue.
* The titlebar does not always properly match the menu gradient ([issue 16](https://code.google.com/p/tenfourfox/issues/detail?id=16)). This problem is also in the official release. Installing a Persona may fix this issue if you find it bothersome.
* Crash reporting is intentionally disabled to avoid polluting Mozilla's crash tracking system with our reports. Please use your system's crash logs if you are reporting a _reproducible_ crash, or (if you are able) provide a `gdb` backtrace.
* Although 10.4Fx will tell you when an update is available, you must download updates manually at this time.
You are welcome to report other bugs that you find. However, please **do not report Mozilla bugs to us.** If the bug or crash occurs in both the official Mozilla Firefox 22 _(3.6 doesn't count!)_ and in 10.4Fx, this is a Mozilla bug, and you should file it at [Bugzilla](http://bugzilla.mozilla.org/). **You must test your bug in both places -- bugs that are not confirmed to be part of 10.4Fx will be marked invalid** so that we can keep our task list focused. This is the [current list of known issues](http://code.google.com/p/tenfourfox/issues/list).

67
ReleaseNotes240.md Normal file
View File

@ -0,0 +1,67 @@
**This document is under construction and is for the beta release of TenFourFox 24.0.**
_This document may be updated for late-breaking changes, so check back here if you are having difficulty._
## System requirements ##
TenFourFox (hereafter "10.4Fx") requires a G3 Power Macintosh, Mac OS X 10.4.11, 100MB of free disk space and 512MB of RAM. 1GB of RAM and a G4 or G5 processor is recommended. Video playback is likely to be poor on systems slower than 1.25GHz; a G5 is recommended. Mac OS X 10.5.8 is supported.
Intel Macintoshes are not supported. Although some users have reported success getting the G3 version of 10.4Fx to run under Rosetta, certain features may not work correctly or at all on Intel Macs, and you may need to completely disable JavaScript compilation for it to work with Rosetta (see [the FAQ](AAATheFAQ.md) for more information). Because Apple no longer supports Rosetta and 10.4Fx is not a Universal binary, it will not run under Lion 10.7 or any subsequent version of Mac OS X.
## Getting TenFourFox ##
Make sure you select the appropriate build for your Mac from the [download page](http://www.tenfourfox.com/). The G3 version will run on any supported Macintosh, but it will not take advantage of the additional features of G4 or G5 processors. The G4 and G5 versions will not run at all on a G3, and the G5 version will perform badly or crash on non-G5 Macintoshes.
If you are using a G4, you should try to choose the correct version for your processor generation (7400 or 7450 "G4e") as performance may be impaired if you run the wrong one. If you don't know which G4 processor you have, the instructions in WhichVersion will tell you how to find out.
## TenFourFox 24 is equivalent to Firefox 24 ##
TenFourFox uses modified Firefox source code, rewritten to remain compatible with Mac OS X v10.4 and the Power Macintosh. It also contains specific optimizations and special features for PowerPC processors. For this reason, it is not exactly the same as Firefox. However, it is intended to be as compatible with it as possible, including most add-ons and [most standard features](TechnicalDifferences.md). You can treat 10.4Fx 24 as equivalent with Firefox 24 in most circumstances, with specific exceptions noted below.
Note that add-ons which require an Intel Macintosh will not work with TenFourFox, even if they are otherwise compatible with Firefox 24, and add-ons that require 10.5 Leopard may not be compatible with TenFourFox running on Mac OS X 10.4 Tiger, even if they are compatible with PowerPC.
## This branch of TenFourFox is the stable version ##
Starting with Firefox 10, Mozilla began offering an extended support release version of Firefox ("Firefox **ESR**") intended for environments where users are unable to use rapid-release versions of Firefox due to policy or technical constraints. This ESR is the basis of the TenFourFox **stable** branch.
The current ESR release is based on Firefox 24. 10.4Fx 24.x is based on this extended support release and is intended for users who wish to remain with a stable browser core. The stable branch will continue to receive bugfixes and security updates, but will not receive new Firefox features (although it may receive certain 10.4Fx-specific features judged important for our legacy users).
**We recommend this version for most of our users.** If you wish to help test our continuing porting efforts, you can try the _unstable_ branch, which is based on the current release of Firefox. _The unstable branch does have bugs and is recommended only for advanced users._ For more information, see the [TenFourFox Development](http://tenfourfox.blogspot.com/) blog.
## TenFourFox no longer supports plugins or Flash ##
Plugins on PowerPC are of special concern because Mozilla is making updates to their plugin architecture which may require the plugins themselves to be updated, and there are certain difficult-to-correct bugs with them already on Tiger. Most importantly, QuickTime, Java and Adobe Flash for PowerPC are no longer maintained and have known security risks that can crash, perform malicious operations or leak data, and Flash 10.1 is rapidly becoming unsupported by many applications.
**For these and other reasons (for details, see PluginsNoLongerSupported), TenFourFox does not run plugins and they cannot be enabled.** Bug reports will no longer be accepted. Sites will now act as if no plugins were installed at all. Earlier versions that allowed an undocumented plugin support mode are no longer supported.
For Internet video, we now recommend the use of TenFourFox's optional QuickTimeEnabler. This allows many videos to be handled in QuickTime Player directly.
You can also download videos for separate viewing using [Perian](http://www.perian.org/) and any of the available video download add-ons for Firefox.
For YouTube, you may also be able to use [MacTubes](http://macapps.sakura.ne.jp/mactubes/index_en.html). If you have a high end G4 or G5, you can also use WebM for selected videos by visiting http://www.youtube.com/html5 and enabling HTML5 video. This will set a temporary cookie enabling browser-based video without Flash. You do not need a YouTube account for this feature, but you may need to periodically renew the cookie setting. Not all video is available in WebM.
For a more in-depth explanation of this policy and other workarounds, see PluginsNoLongerSupported.
## New in this version of TenFourFox ##
* All new standard features of Firefox 24.0, including a baseline low-latency JavaScript compiler (optimized for PowerPC), improvements to CSS and HTML5, support for webcams and microphones on compliant websites, improvements to graphic performance and a new unified library interface for downloads and bookmarks.
## Known issues in this version of TenFourFox ##
* The "traffic light" buttons can be obscured by Personas ([issue 247](https://code.google.com/p/tenfourfox/issues/detail?id=247)), though they still work.
## Known issues specific to TenFourFox ##
* Remember: **Plugins do not work in TenFourFox and can no longer be enabled.** See PluginsNoLongerSupported for an explanation and suggested workarounds. Please note that out-of-process plugins have never been supported.
* TenFourFox uses a lighter chrome for windows and dialogue boxes than prior versions or the official Mac Firefox. This is intentional.
* Systems with large numbers of fonts installed may experience intermittent pauses.
* Some pages may perform better on 10.5 systems than 10.4 ([issue 193](https://code.google.com/p/tenfourfox/issues/detail?id=193)).
* The performance characteristics for the JavaScript compiler used in 24.0 and up are different from those of 17.0.
* Bitmap-only fonts (usually Type 1 PostScript) cannot be used by the 10.4Fx font renderer and are discarded. A fallback font will be used in their place.
* Not all webcams are supported; in addition, multiple webcams may not all appear depending on how they are connected ([issue 221](https://code.google.com/p/tenfourfox/issues/detail?id=221)). For a list of supported webcam devices, see VideoDeviceSupport.
* 10.4Fx does not currently support WebGL, WebRTC or the webapp runtime, and scripts such as Arabic or Indic requiring glyph reordering or language-specific ligatures may not appear correctly. See TechnicalDifferences for the complete list of changes necessary for 10.4Fx. See [issue 5](https://code.google.com/p/tenfourfox/issues/detail?id=5) for notes specific to the font issue.
* The titlebar does not always properly match the menu gradient ([issue 16](https://code.google.com/p/tenfourfox/issues/detail?id=16)). This problem is also in the official release. Installing a Persona may fix this issue if you find it bothersome.
* Crash reporting is intentionally disabled to avoid polluting Mozilla's crash tracking system with our reports. Please use your system's crash logs if you are reporting a _reproducible_ crash, or (if you are able) provide a `gdb` backtrace.
* Although 10.4Fx will tell you when an update is available, you must download updates manually at this time.
You are welcome to report other bugs that you find. However, please **do not report Mozilla bugs to us.** If the bug or crash occurs in both the official Mozilla Firefox 24 _(3.6 doesn't count!)_ and in 10.4Fx, this is a Mozilla bug, and you should file it at [Bugzilla](http://bugzilla.mozilla.org/). **You must test your bug in both places -- bugs that are not confirmed to be part of 10.4Fx will be marked invalid** so that we can keep our task list focused. This is the [current list of known issues](http://code.google.com/p/tenfourfox/issues/list).

70
ReleaseNotes2410.md Normal file
View File

@ -0,0 +1,70 @@
**This document is for the final beta release of TenFourFox 24.**
_This document may be updated for late-breaking changes, so check back here if you are having difficulty._
## System requirements ##
TenFourFox (hereafter "10.4Fx") requires a G3 Power Macintosh, Mac OS X 10.4.11, 100MB of free disk space and 512MB of RAM. 1GB of RAM and a G4 or G5 processor is recommended. Video playback is likely to be poor on systems slower than 1.25GHz; a G5 is recommended. Mac OS X 10.5.8 is supported.
Intel Macintoshes are not supported. Although some users have reported success getting the G3 version of 10.4Fx to run under Rosetta, certain features may not work correctly or at all on Intel Macs, and you may need to completely disable JavaScript compilation for it to work with Rosetta (see [the FAQ](AAATheFAQ.md) for more information). Because Apple no longer supports Rosetta and 10.4Fx is not a Universal binary, it will not run under Lion 10.7 or any subsequent version of Mac OS X.
## Getting TenFourFox ##
Make sure you select the appropriate build for your Mac from the [download page](http://www.tenfourfox.com/). The G3 version will run on any supported Macintosh, but it will not take advantage of the additional features of G4 or G5 processors. The G4 and G5 versions will not run at all on a G3, and the G5 version will perform badly or crash on non-G5 Macintoshes.
**Starting with 24.1.0, all downloads will be hosted on SourceForge due to Google Code's download restrictions.** We strongly recommend getting the most recent version directly from [the main TenFourFox website](http://www.tenfourfox.com/), but you can also browse files in the [TenFourFox SourceForge repository](https://sourceforge.net/projects/tenfourfox/files/) if you prefer.
If you are using a G4, you should try to choose the correct version for your processor generation (7400 or 7450 "G4e") as performance may be impaired if you run the wrong one. If you don't know which G4 processor you have, the instructions in WhichVersion will tell you how to find out.
## TenFourFox 24 is equivalent to Firefox 24 ##
TenFourFox uses modified Firefox source code, rewritten to remain compatible with Mac OS X v10.4 and the Power Macintosh. It also contains specific optimizations and special features for PowerPC processors. For this reason, it is not exactly the same as Firefox. However, it is intended to be as compatible with it as possible, including most add-ons and [most standard features](TechnicalDifferences.md). You can treat 10.4Fx 24 as equivalent with Firefox 24 in most circumstances, with specific exceptions noted below.
Note that add-ons which require an Intel Macintosh will not work with TenFourFox, even if they are otherwise compatible with Firefox 24, and add-ons that require 10.5 Leopard may not be compatible with TenFourFox running on Mac OS X 10.4 Tiger, even if they are compatible with PowerPC.
## This branch of TenFourFox is the stable version ##
Starting with Firefox 10, Mozilla began offering an extended support release version of Firefox ("Firefox **ESR**") intended for environments where users are unable to use rapid-release versions of Firefox due to policy or technical constraints. This ESR is the basis of the TenFourFox **stable** branch.
The current ESR release is based on Firefox 24. 10.4Fx 24.x is based on this extended support release and is intended for users who wish to remain with a stable browser core. The stable branch will continue to receive bugfixes and security updates, but will not receive new Firefox features (although it may receive certain 10.4Fx-specific features judged important for our legacy users).
**We recommend this version for most of our users.** If you wish to help test our continuing porting efforts, you can try the _unstable_ branch, which is based on the current release of Firefox. _The unstable branch does have bugs and is recommended only for advanced users._ For more information, see the [TenFourFox Development](http://tenfourfox.blogspot.com/) blog.
## TenFourFox no longer supports plugins or Flash ##
Plugins on PowerPC are of special concern because Mozilla is making updates to their plugin architecture which may require the plugins themselves to be updated, and there are certain difficult-to-correct bugs with them already on Tiger. Most importantly, QuickTime, Java and Adobe Flash for PowerPC are no longer maintained and have known security risks that can crash, perform malicious operations or leak data, and Flash 10.1 is rapidly becoming unsupported by many applications.
**For these and other reasons (for details, see PluginsNoLongerSupported), TenFourFox does not run plugins and they cannot be enabled.** Bug reports will no longer be accepted. Sites will now act as if no plugins were installed at all. Earlier versions that allowed an undocumented plugin support mode are no longer supported.
For Internet video, we now recommend the use of TenFourFox's optional QuickTimeEnabler. This allows many videos to be handled in QuickTime Player directly.
You can also download videos for separate viewing using [Perian](http://www.perian.org/) and any of the available video download add-ons for Firefox.
For YouTube, you may also be able to use [MacTubes](http://macapps.sakura.ne.jp/mactubes/index_en.html). If you have a high end G4 or G5, you can also use WebM for selected videos by visiting http://www.youtube.com/html5 and enabling HTML5 video. This will set a temporary cookie enabling browser-based video without Flash. You do not need a YouTube account for this feature, but you may need to periodically renew the cookie setting. Not all video is available in WebM.
For a more in-depth explanation of this policy and other workarounds, see PluginsNoLongerSupported.
## New in this version of TenFourFox ##
* All supported new standard features of Firefox 24, including a baseline low-latency JavaScript compiler (optimized for PowerPC), improvements to CSS and HTML5, support for webcams and microphones on compliant websites, improvements to graphic performance and a new unified library interface for downloads and bookmarks.
## Fixed in this version of TenFourFox ##
* An operating system defect with heavy keyboard usage causing the menubar to be unresponsive has been worked around ([issue 248](https://code.google.com/p/tenfourfox/issues/detail?id=248)). This issue affects all previous versions of 10.4Fx.
## Known issues specific to TenFourFox ##
* Remember: **Plugins do not work in TenFourFox and can no longer be enabled.** See PluginsNoLongerSupported for an explanation and suggested workarounds. Please note that out-of-process plugins have never been supported.
* TenFourFox uses a lighter chrome for windows and dialogue boxes than prior versions or the official Mac Firefox. This is intentional.
* Systems with large numbers of fonts installed may experience intermittent pauses.
* Some pages may perform better on 10.5 systems than 10.4 ([issue 193](https://code.google.com/p/tenfourfox/issues/detail?id=193)).
* The performance characteristics for the JavaScript compiler used in 24.0 and up are different from those of 17.0.
* Bitmap-only fonts (usually Type 1 PostScript) cannot be used by the 10.4Fx font renderer and are discarded. A fallback font will be used in their place.
* Personas may hide the "traffic light" window buttons, but they are still present and will work if hovered over or clicked on ([issue 247](https://code.google.com/p/tenfourfox/issues/detail?id=247)).
* Not all webcams are supported; in addition, multiple webcams may not all appear depending on how they are connected ([issue 221](https://code.google.com/p/tenfourfox/issues/detail?id=221)). For a list of supported webcam devices, see VideoDeviceSupport.
* 10.4Fx does not currently support WebGL, WebRTC or the webapp runtime, and scripts such as Arabic or Indic requiring glyph reordering or language-specific ligatures may not appear correctly. See TechnicalDifferences for the complete list of changes necessary for 10.4Fx. See [issue 5](https://code.google.com/p/tenfourfox/issues/detail?id=5) for notes specific to the font issue.
* The titlebar does not always properly match the menu gradient ([issue 16](https://code.google.com/p/tenfourfox/issues/detail?id=16)). This problem is also in the official release. Installing a Persona may fix this issue if you find it bothersome.
* Crash reporting is intentionally disabled to avoid polluting Mozilla's crash tracking system with our reports. Please use your system's crash logs if you are reporting a _reproducible_ crash, or (if you are able) provide a `gdb` backtrace.
* Although 10.4Fx will tell you when an update is available, you must download updates manually at this time.
You are welcome to report other bugs that you find. However, please **do not report Mozilla bugs to us.** If the bug or crash occurs in both the official Mozilla Firefox 24 _(3.6 doesn't count!)_ and in 10.4Fx, this is a Mozilla bug, and you should file it at [Bugzilla](http://bugzilla.mozilla.org/). **You must test your bug in both places -- bugs that are not confirmed to be part of 10.4Fx will be marked invalid** so that we can keep our task list focused. This is the [current list of known issues](http://code.google.com/p/tenfourfox/issues/list).

70
ReleaseNotes2420.md Normal file
View File

@ -0,0 +1,70 @@
_This document may be updated for late-breaking changes, so check back here if you are having difficulty._
## System requirements ##
TenFourFox (hereafter "10.4Fx") requires a G3 Power Macintosh, Mac OS X 10.4.11, 100MB of free disk space and 512MB of RAM. 1GB of RAM and a G4 or G5 processor is recommended. Video playback is likely to be poor on systems slower than 1.25GHz; a G5 is recommended. Mac OS X 10.5.8 is supported.
Intel Macintoshes are not supported. Although some users have reported success getting the G3 version of 10.4Fx to run under Rosetta, certain features may not work correctly or at all on Intel Macs, and you may need to completely disable JavaScript compilation for it to work with Rosetta (see [the FAQ](AAATheFAQ.md) for more information). Because Apple no longer supports Rosetta and 10.4Fx is not a Universal binary, it will not run under Lion 10.7 or any subsequent version of Mac OS X.
## Getting TenFourFox ##
Make sure you select the appropriate build for your Mac from the [download page](http://www.tenfourfox.com/). The G3 version will run on any supported Macintosh, but it will not take advantage of the additional features of G4 or G5 processors. The G4 and G5 versions will not run at all on a G3, and the G5 version will perform badly or crash on non-G5 Macintoshes.
**Starting with 24.1.0, all downloads will be hosted on SourceForge due to Google Code's download restrictions.** We strongly recommend getting the most recent version directly from [the main TenFourFox website](http://www.tenfourfox.com/), but you can also browse files in the [TenFourFox SourceForge repository](https://sourceforge.net/projects/tenfourfox/files/) if you prefer.
If you are using a G4, you should try to choose the correct version for your processor generation (7400 or 7450 "G4e") as performance may be impaired if you run the wrong one. If you don't know which G4 processor you have, the instructions in WhichVersion will tell you how to find out.
## TenFourFox 24 is equivalent to Firefox 24 ##
TenFourFox uses modified Firefox source code, rewritten to remain compatible with Mac OS X v10.4 and the Power Macintosh. It also contains specific optimizations and special features for PowerPC processors. For this reason, it is not exactly the same as Firefox. However, it is intended to be as compatible with it as possible, including most add-ons and [most standard features](TechnicalDifferences.md). You can treat 10.4Fx 24 as equivalent with Firefox 24 in most circumstances, with specific exceptions noted below.
Note that add-ons which require an Intel Macintosh will not work with TenFourFox, even if they are otherwise compatible with Firefox 24, and add-ons that require 10.5 Leopard may not be compatible with TenFourFox running on Mac OS X 10.4 Tiger, even if they are compatible with PowerPC.
## This branch of TenFourFox is the stable version ##
Starting with Firefox 10, Mozilla began offering an extended support release version of Firefox ("Firefox **ESR**") intended for environments where users are unable to use rapid-release versions of Firefox due to policy or technical constraints. This ESR is the basis of the TenFourFox **stable** branch.
The current ESR release is based on Firefox 24. 10.4Fx 24.x is based on this extended support release and is intended for users who wish to remain with a stable browser core. The stable branch will continue to receive bugfixes and security updates, but will not receive new Firefox features (although it may receive certain 10.4Fx-specific features judged important for our legacy users).
**We recommend this version for most of our users.** If you wish to help test our continuing porting efforts, you can try the _unstable_ branch, which is based on the current release of Firefox. _The unstable branch does have bugs and is recommended only for advanced users._ For more information, see the [TenFourFox Development](http://tenfourfox.blogspot.com/) blog.
## TenFourFox no longer supports plugins or Flash ##
Plugins on PowerPC are of special concern because Mozilla is making updates to their plugin architecture which may require the plugins themselves to be updated, and there are certain difficult-to-correct bugs with them already on Tiger. Most importantly, QuickTime, Java and Adobe Flash for PowerPC are no longer maintained and have known security risks that can crash, perform malicious operations or leak data, and Flash 10.1 is rapidly becoming unsupported by many applications.
**For these and other reasons (for details, see PluginsNoLongerSupported), TenFourFox does not run plugins and they cannot be enabled.** Bug reports will no longer be accepted. Sites will now act as if no plugins were installed at all. Earlier versions that allowed an undocumented plugin support mode are no longer supported.
For Internet video, we now recommend the use of TenFourFox's optional QuickTimeEnabler. This allows many videos to be handled in QuickTime Player directly.
You can also download videos for separate viewing using [Perian](http://www.perian.org/) and any of the available video download add-ons for Firefox.
For YouTube, you may also be able to use [MacTubes](http://macapps.sakura.ne.jp/mactubes/index_en.html). If you have a high end G4 or G5, you can also use WebM for selected videos by visiting http://www.youtube.com/html5 and enabling HTML5 video. This will set a temporary cookie enabling browser-based video without Flash. You do not need a YouTube account for this feature, but you may need to periodically renew the cookie setting. Not all video is available in WebM.
For a more in-depth explanation of this policy and other workarounds, see PluginsNoLongerSupported.
## New in this version of TenFourFox ##
* All supported new standard features of Firefox 24, including a baseline low-latency JavaScript compiler (optimized for PowerPC), improvements to CSS and HTML5, support for webcams and microphones on compliant websites, improvements to graphic performance, and a new unified library interface for downloads and bookmarks.
## Fixed in this version of TenFourFox ##
* An operating system defect with heavy keyboard usage causing the menubar to be unresponsive has been worked around ([issue 248](https://code.google.com/p/tenfourfox/issues/detail?id=248)). This issue affects all previous versions of 10.4Fx.
* Garbage collection priority is increased ([issue 253](https://code.google.com/p/tenfourfox/issues/detail?id=253)), improving memory usage and reducing intermittent pauses. This issue affects 10.4Fx 16 and subsequent versions.
* The background and box shadow for top-level video and image documents is simplified ([issue 254](https://code.google.com/p/tenfourfox/issues/detail?id=254)), improving rendering performance. This issue affects 10.4Fx 19 and subsequent versions.
## Known issues specific to TenFourFox ##
* Remember: **Plugins do not work in TenFourFox and can no longer be enabled.** See PluginsNoLongerSupported for an explanation and suggested workarounds. Please note that out-of-process plugins have never been supported.
* TenFourFox uses a lighter chrome for windows and dialogue boxes than prior versions or the official Mac Firefox. This is intentional.
* Systems with large numbers of fonts installed may experience intermittent pauses.
* Some pages may perform better on 10.5 systems than 10.4 ([issue 193](https://code.google.com/p/tenfourfox/issues/detail?id=193)).
* The performance characteristics for the JavaScript compiler used in 24.0 and up are different from those of 17.0.
* Bitmap-only fonts (usually Type 1 PostScript) cannot be used by the 10.4Fx font renderer and are discarded. A fallback font will be used in their place.
* Personas and certain custom skins may hide the "traffic light" window buttons, but they are still present and will work if hovered over or clicked on ([issue 247](https://code.google.com/p/tenfourfox/issues/detail?id=247)).
* Not all webcams are supported; in addition, multiple webcams may not all appear depending on how they are connected ([issue 221](https://code.google.com/p/tenfourfox/issues/detail?id=221)). For a list of supported webcam devices, see VideoDeviceSupport.
* 10.4Fx does not currently support WebGL, WebRTC or the webapp runtime, and scripts such as Arabic or Indic requiring glyph reordering or language-specific ligatures may not appear correctly. See TechnicalDifferences for the complete list of changes necessary for 10.4Fx. See [issue 5](https://code.google.com/p/tenfourfox/issues/detail?id=5) for notes specific to the font issue.
* The titlebar does not always properly match the menu gradient ([issue 16](https://code.google.com/p/tenfourfox/issues/detail?id=16)). This problem is also in the official release. Installing a Persona may fix this issue if you find it bothersome.
* Crash reporting is intentionally disabled to avoid polluting Mozilla's crash tracking system with our reports. Please use your system's crash logs if you are reporting a _reproducible_ crash, or (if you are able) provide a `gdb` backtrace.
* Although 10.4Fx will tell you when an update is available, you must download updates manually at this time.
You are welcome to report other bugs that you find. However, please **do not report Mozilla bugs to us.** If the bug or crash occurs in both the official Mozilla Firefox 24 _(3.6 doesn't count!)_ and in 10.4Fx, this is a Mozilla bug, and you should file it at [Bugzilla](http://bugzilla.mozilla.org/). **You must test your bug in both places -- bugs that are not confirmed to be part of 10.4Fx will be marked invalid** so that we can keep our task list focused. This is the [current list of known issues](http://code.google.com/p/tenfourfox/issues/list).

69
ReleaseNotes2430.md Normal file
View File

@ -0,0 +1,69 @@
_This document may be updated for late-breaking changes, so check back here if you are having difficulty._
## System requirements ##
TenFourFox (hereafter "10.4Fx") requires a G3 Power Macintosh, Mac OS X 10.4.11, 100MB of free disk space and 512MB of RAM. 1GB of RAM and a G4 or G5 processor is recommended. Video playback is likely to be poor on systems slower than 1.25GHz; a G5 is recommended. Mac OS X 10.5.8 is supported.
Intel Macintoshes are not supported. Although some users have reported success getting the G3 version of 10.4Fx to run under Rosetta, certain features may not work correctly or at all on Intel Macs, and you may need to completely disable JavaScript compilation for it to work with Rosetta (see [the FAQ](AAATheFAQ.md) for more information). Because Apple no longer supports Rosetta and 10.4Fx is not a Universal binary, it will not run under Lion 10.7 or any subsequent version of Mac OS X.
## Getting TenFourFox ##
Make sure you select the appropriate build for your Mac from the [download page](http://www.tenfourfox.com/). The G3 version will run on any supported Macintosh, but it will not take advantage of the additional features of G4 or G5 processors. The G4 and G5 versions will not run at all on a G3, and the G5 version will perform badly or crash on non-G5 Macintoshes.
**Starting with 24.1.0, all downloads will be hosted on SourceForge due to Google Code's download restrictions.** We strongly recommend getting the most recent version directly from [the main TenFourFox website](http://www.tenfourfox.com/), but you can also browse files in the [TenFourFox SourceForge repository](https://sourceforge.net/projects/tenfourfox/files/) if you prefer.
If you are using a G4, you should try to choose the correct version for your processor generation (7400 or 7450 "G4e") as performance may be impaired if you run the wrong one. If you don't know which G4 processor you have, the instructions in WhichVersion will tell you how to find out.
## TenFourFox 24 is equivalent to Firefox 24 ##
TenFourFox uses modified Firefox source code, rewritten to remain compatible with Mac OS X v10.4 and the Power Macintosh. It also contains specific optimizations and special features for PowerPC processors. For this reason, it is not exactly the same as Firefox. However, it is intended to be as compatible with it as possible, including most add-ons and [most standard features](TechnicalDifferences.md). You can treat 10.4Fx 24 as equivalent with Firefox 24 in most circumstances, with specific exceptions noted below.
Note that add-ons which require an Intel Macintosh will not work with TenFourFox, even if they are otherwise compatible with Firefox 24, and add-ons that require 10.5 Leopard may not be compatible with TenFourFox running on Mac OS X 10.4 Tiger, even if they are compatible with PowerPC.
## This branch of TenFourFox is the stable version ##
Starting with Firefox 10, Mozilla began offering an extended support release version of Firefox ("Firefox **ESR**") intended for environments where users are unable to use rapid-release versions of Firefox due to policy or technical constraints. This ESR is the basis of the TenFourFox **stable** branch.
The current ESR release is based on Firefox 24. 10.4Fx 24.x is based on this extended support release and is intended for users who wish to remain with a stable browser core. The stable branch will continue to receive bugfixes and security updates, but will not receive new Firefox features (although it may receive certain 10.4Fx-specific features judged important for our legacy users).
**We recommend this version for most of our users.** If you wish to help test our continuing porting efforts, you can try the _unstable_ branch, which is based on the current release of Firefox. _The unstable branch does have bugs and is recommended only for advanced users._ For more information, see the [TenFourFox Development](http://tenfourfox.blogspot.com/) blog.
## TenFourFox no longer supports plugins or Flash ##
Plugins on PowerPC are of special concern because Mozilla is making updates to their plugin architecture which may require the plugins themselves to be updated, and there are certain difficult-to-correct bugs with them already on Tiger. Most importantly, QuickTime, Java and Adobe Flash for PowerPC are no longer maintained and have known security risks that can crash, perform malicious operations or leak data, and Flash 10.1 is rapidly becoming unsupported by many applications.
**For these and other reasons (for details, see PluginsNoLongerSupported), TenFourFox does not run plugins and they cannot be enabled.** Bug reports will no longer be accepted. Sites will now act as if no plugins were installed at all. Earlier versions that allowed an undocumented plugin support mode are no longer supported.
For Internet video, we now recommend the use of TenFourFox's optional QuickTimeEnabler. This allows many videos to be handled in QuickTime Player directly.
You can also download videos for separate viewing using [Perian](http://www.perian.org/) and any of the available video download add-ons for Firefox.
For YouTube, you may also be able to use [MacTubes](http://macapps.sakura.ne.jp/mactubes/index_en.html). If you have a high end G4 or G5, you can also use WebM for selected videos by visiting http://www.youtube.com/html5 and enabling HTML5 video. This will set a temporary cookie enabling browser-based video without Flash. You do not need a YouTube account for this feature, but you may need to periodically renew the cookie setting. Not all video is available in WebM.
For a more in-depth explanation of this policy and other workarounds, see PluginsNoLongerSupported.
## Fixed in this version of TenFourFox ##
* All security and stability fixes from Firefox ESR 24.3.0. This includes a fix for corrupted or slow profiles stored on networked home directories (Mozilla [bug 918612](https://code.google.com/p/tenfourfox/issues/detail?id=18612)).
* The browser string has been rearranged to improve sites detecting 10.4Fx "correctly" as Firefox ([issue 257](https://code.google.com/p/tenfourfox/issues/detail?id=257)).
* Update checking frequency has been tuned to daily ([issue 257](https://code.google.com/p/tenfourfox/issues/detail?id=257)).
* Spurious start up messages are reduced ([issue 257](https://code.google.com/p/tenfourfox/issues/detail?id=257)).
If you are new to TenFourFox 24, you may also want to read the [release notes for 24.2.0](http://code.google.com/p/tenfourfox/w/ReleaseNotes2420) for new and fixed issues in the previous version.
## Known issues specific to TenFourFox ##
* Remember: **Plugins do not work in TenFourFox and can no longer be enabled.** See PluginsNoLongerSupported for an explanation and suggested workarounds. Please note that out-of-process plugins have never been supported.
* TenFourFox uses a lighter chrome for windows and dialogue boxes than prior versions or the official Mac Firefox. This is intentional.
* Systems with large numbers of fonts installed may experience intermittent pauses.
* Some pages may perform better on 10.5 systems than 10.4 ([issue 193](https://code.google.com/p/tenfourfox/issues/detail?id=193)).
* The performance characteristics for the JavaScript compiler used in 24.0 and up are different from those of 17.0.
* Bitmap-only fonts (usually Type 1 PostScript) cannot be used by the 10.4Fx font renderer and are discarded. A fallback font will be used in their place.
* Personas and certain custom skins may hide the "traffic light" window buttons, but they are still present and will work if hovered over or clicked on ([issue 247](https://code.google.com/p/tenfourfox/issues/detail?id=247)).
* Not all webcams are supported; in addition, multiple webcams may not all appear depending on how they are connected ([issue 221](https://code.google.com/p/tenfourfox/issues/detail?id=221)). For a list of supported webcam devices, see VideoDeviceSupport.
* 10.4Fx does not currently support WebGL, WebRTC or the webapp runtime, and scripts such as Arabic or Indic requiring glyph reordering or language-specific ligatures may not appear correctly. See TechnicalDifferences for the complete list of changes necessary for 10.4Fx. See [issue 5](https://code.google.com/p/tenfourfox/issues/detail?id=5) for notes specific to the font issue.
* The titlebar does not always properly match the menu gradient ([issue 16](https://code.google.com/p/tenfourfox/issues/detail?id=16)). This problem is also in the official release. Installing a Persona may fix this issue if you find it bothersome.
* Crash reporting is intentionally disabled to avoid polluting Mozilla's crash tracking system with our reports. Please use your system's crash logs if you are reporting a _reproducible_ crash, or (if you are able) provide a `gdb` backtrace.
* Although 10.4Fx will tell you when an update is available, you must download updates manually at this time.
You are welcome to report other bugs that you find. However, please **do not report Mozilla bugs to us.** If the bug or crash occurs in both the official Mozilla Firefox 24 _(3.6 doesn't count!)_ and in 10.4Fx, this is a Mozilla bug, and you should file it at [Bugzilla](http://bugzilla.mozilla.org/). **You must test your bug in both places -- bugs that are not confirmed to be part of 10.4Fx will be marked invalid** so that we can keep our task list focused. This is the [current list of known issues](http://code.google.com/p/tenfourfox/issues/list).

70
ReleaseNotes2440.md Normal file
View File

@ -0,0 +1,70 @@
_This document may be updated for late-breaking changes, so check back here if you are having difficulty._
## System requirements ##
TenFourFox (hereafter "10.4Fx") requires a G3 Power Macintosh, Mac OS X 10.4.11, 100MB of free disk space and 512MB of RAM. 1GB of RAM and a G4 or G5 processor is recommended. Video playback is likely to be poor on systems slower than 1.25GHz; a G5 is recommended. Mac OS X 10.5.8 is supported.
Intel Macintoshes are not supported. Although some users have reported success getting the G3 version of 10.4Fx to run under Rosetta, certain features may not work correctly or at all on Intel Macs, and you may need to completely disable JavaScript compilation for it to work with Rosetta (see [the FAQ](AAATheFAQ.md) for more information). Because Apple no longer supports Rosetta and 10.4Fx is not a Universal binary, it will not run under Lion 10.7 or any subsequent version of Mac OS X.
## Getting TenFourFox ##
Make sure you select the appropriate build for your Mac from the [download page](http://www.tenfourfox.com/). The G3 version will run on any supported Macintosh, but it will not take advantage of the additional features of G4 or G5 processors. The G4 and G5 versions will not run at all on a G3, and the G5 version will perform badly or crash on non-G5 Macintoshes.
**Starting with 24.1.0, all downloads will be hosted on SourceForge due to Google Code's download restrictions.** We strongly recommend getting the most recent version directly from [the main TenFourFox website](http://www.tenfourfox.com/), but you can also browse files in the [TenFourFox SourceForge repository](https://sourceforge.net/projects/tenfourfox/files/) if you prefer.
If you are using a G4, you should try to choose the correct version for your processor generation (7400 or 7450 "G4e") as performance may be impaired if you run the wrong one. If you don't know which G4 processor you have, the instructions in WhichVersion will tell you how to find out.
## TenFourFox 24 is equivalent to Firefox 24 ##
TenFourFox uses modified Firefox source code, rewritten to remain compatible with Mac OS X v10.4 and the Power Macintosh. It also contains specific optimizations and special features for PowerPC processors. For this reason, it is not exactly the same as Firefox. However, it is intended to be as compatible with it as possible, including most add-ons and [most standard features](TechnicalDifferences.md). You can treat 10.4Fx 24 as equivalent with Firefox 24 in most circumstances, with specific exceptions noted below.
Note that add-ons which require an Intel Macintosh will not work with TenFourFox, even if they are otherwise compatible with Firefox 24, and add-ons that require 10.5 Leopard may not be compatible with TenFourFox running on Mac OS X 10.4 Tiger, even if they are compatible with PowerPC.
## This branch of TenFourFox is the stable version ##
Starting with Firefox 10, Mozilla began offering an extended support release version of Firefox ("Firefox **ESR**") intended for environments where users are unable to use rapid-release versions of Firefox due to policy or technical constraints. This ESR is the basis of the TenFourFox **stable** branch.
The current ESR release is based on Firefox 24. 10.4Fx 24.x is based on this extended support release and is intended for users who wish to remain with a stable browser core. The stable branch will continue to receive bugfixes and security updates, but will not receive new Firefox features (although it may receive certain 10.4Fx-specific features judged important for our legacy users).
**We recommend this version for most of our users.** If you wish to help test our continuing porting efforts, you can try the _unstable_ branch, which is based on the current release of Firefox. _The unstable branch does have bugs and is recommended only for advanced users._ For more information, see the [TenFourFox Development](http://tenfourfox.blogspot.com/) blog.
## TenFourFox no longer supports plugins or Flash ##
Plugins on PowerPC are of special concern because Mozilla is making updates to their plugin architecture which may require the plugins themselves to be updated, and there are certain difficult-to-correct bugs with them already on Tiger. Most importantly, QuickTime, Java and Adobe Flash for PowerPC are no longer maintained and have known security risks that can crash, perform malicious operations or leak data, and Flash 10.1 is rapidly becoming unsupported by many applications.
**For these and other reasons (for details, see PluginsNoLongerSupported), TenFourFox does not run plugins and they cannot be enabled.** Bug reports will no longer be accepted. Sites will now act as if no plugins were installed at all. Earlier versions that allowed an undocumented plugin support mode are no longer supported.
For Internet video, we now recommend the use of TenFourFox's optional QuickTimeEnabler. This allows many videos to be handled in QuickTime Player directly.
You can also download videos for separate viewing using [Perian](http://www.perian.org/) and any of the available video download add-ons for Firefox.
For YouTube, you may also be able to use [MacTubes](http://macapps.sakura.ne.jp/mactubes/index_en.html). If you have a high end G4 or G5, you can also use WebM for selected videos by visiting http://www.youtube.com/html5 and enabling HTML5 video. This will set a temporary cookie enabling browser-based video without Flash. You do not need a YouTube account for this feature, but you may need to periodically renew the cookie setting. Not all video is available in WebM.
For a more in-depth explanation of this policy and other workarounds, see PluginsNoLongerSupported.
## Fixed in this version of TenFourFox ##
* All security and stability fixes from Firefox ESR 24.4.0.
* Due to other incompatibilities introduced by the patch for [issue 257](https://code.google.com/p/tenfourfox/issues/detail?id=257), including issues with Yahoo! Mail, the user agent change has been backed out and the old TenFourFox user agent string restored ([issue 259](https://code.google.com/p/tenfourfox/issues/detail?id=259)). (Virtually all of the available Firefox user agent changers will work with 10.4Fx if you still require changing it. Most users will not.)
* An issue where certain sites could hide the pointer completely, even over the browser chrome, has been mitigated ([issue 260](https://code.google.com/p/tenfourfox/issues/detail?id=260)).
* Certain web fonts that can crash 10.5 users are now blacklisted ([issue 261](https://code.google.com/p/tenfourfox/issues/detail?id=261)).
* A potential memory leak in font handling code has been fixed ([issue 264](https://code.google.com/p/tenfourfox/issues/detail?id=264)).
If you are new to TenFourFox 24, you may also want to read the [release notes for 24.3.0](http://code.google.com/p/tenfourfox/w/ReleaseNotes2430) for new and fixed issues in the previous version(s).
## Known issues specific to TenFourFox ##
* Remember: **Plugins do not work in TenFourFox and can no longer be enabled.** See PluginsNoLongerSupported for an explanation and suggested workarounds. Please note that out-of-process plugins have never been supported.
* TenFourFox uses a lighter chrome for windows and dialogue boxes than prior versions or the official Mac Firefox. This is intentional.
* Systems with large numbers of fonts installed may experience intermittent pauses.
* Some pages may perform better on 10.5 systems than 10.4 ([issue 193](https://code.google.com/p/tenfourfox/issues/detail?id=193)).
* The performance characteristics for the JavaScript compiler used in 24.0 and up are different from those of 17.0.
* Bitmap-only fonts (usually Type 1 PostScript) cannot be used by the 10.4Fx font renderer and are discarded. A fallback font will be used in their place.
* Personas and certain custom skins may hide the "traffic light" window buttons, but they are still present and will work if hovered over or clicked on ([issue 247](https://code.google.com/p/tenfourfox/issues/detail?id=247)).
* Not all webcams are supported; in addition, multiple webcams may not all appear depending on how they are connected ([issue 221](https://code.google.com/p/tenfourfox/issues/detail?id=221)). For a list of supported webcam devices, see VideoDeviceSupport.
* 10.4Fx does not currently support WebGL, WebRTC or the webapp runtime, and scripts such as Arabic or Indic requiring glyph reordering or language-specific ligatures may not appear correctly. See TechnicalDifferences for the complete list of changes necessary for 10.4Fx. See [issue 5](https://code.google.com/p/tenfourfox/issues/detail?id=5) for notes specific to the font issue.
* The titlebar does not always properly match the menu gradient ([issue 16](https://code.google.com/p/tenfourfox/issues/detail?id=16)). This problem is also in the official release. Installing a Persona may fix this issue if you find it bothersome.
* Crash reporting is intentionally disabled to avoid polluting Mozilla's crash tracking system with our reports. Please use your system's crash logs if you are reporting a _reproducible_ crash, or (if you are able) provide a `gdb` backtrace.
* Although 10.4Fx will tell you when an update is available, you must download updates manually at this time.
You are welcome to report other bugs that you find. However, please **do not report Mozilla bugs to us.** If the bug or crash occurs in both the official Mozilla Firefox 24 _(3.6 doesn't count!)_ and in 10.4Fx, this is a Mozilla bug, and you should file it at [Bugzilla](http://bugzilla.mozilla.org/). **You must test your bug in both places -- bugs that are not confirmed to be part of 10.4Fx will be marked invalid** so that we can keep our task list focused. This is the [current list of known issues](http://code.google.com/p/tenfourfox/issues/list).

65
ReleaseNotes2450.md Normal file
View File

@ -0,0 +1,65 @@
_This document may be updated for late-breaking changes, so check back here if you are having difficulty._
## System requirements ##
TenFourFox (hereafter "10.4Fx") requires a G3 Power Macintosh, Mac OS X 10.4.11, 100MB of free disk space and 512MB of RAM. 1GB of RAM and a G4 or G5 processor is recommended. Video playback is likely to be poor on systems slower than 1.25GHz; a G5 is recommended. Mac OS X 10.5.8 is supported.
Intel Macintoshes are not supported. Although some users have reported success getting the G3 version of 10.4Fx to run under Rosetta, certain features may not work correctly or at all on Intel Macs, and you may need to completely disable JavaScript compilation for it to work with Rosetta (see [the FAQ](AAATheFAQ.md) for more information). Because Apple no longer supports Rosetta and 10.4Fx is not a Universal binary, it will not run under Lion 10.7 or any subsequent version of Mac OS X.
## Getting TenFourFox ##
Make sure you select the appropriate build for your Mac from the [download page](http://www.tenfourfox.com/). The G3 version will run on any supported Macintosh, but it will not take advantage of the additional features of G4 or G5 processors. The G4 and G5 versions will not run at all on a G3, and the G5 version will perform badly or crash on non-G5 Macintoshes.
**Starting with 24.1.0, all downloads will be hosted on SourceForge due to Google Code's download restrictions.** We strongly recommend getting the most recent version directly from [the main TenFourFox website](http://www.tenfourfox.com/), but you can also browse files in the [TenFourFox SourceForge repository](https://sourceforge.net/projects/tenfourfox/files/) if you prefer.
If you are using a G4, you should try to choose the correct version for your processor generation (7400 or 7450 "G4e") as performance may be impaired if you run the wrong one. If you don't know which G4 processor you have, the instructions in WhichVersion will tell you how to find out.
## TenFourFox 24 is equivalent to Firefox 24 ##
TenFourFox uses modified Firefox source code, rewritten to remain compatible with Mac OS X v10.4 and the Power Macintosh. It also contains specific optimizations and special features for PowerPC processors. For this reason, it is not exactly the same as Firefox. However, it is intended to be as compatible with it as possible, including most add-ons and [most standard features](TechnicalDifferences.md). You can treat 10.4Fx 24 as equivalent with Firefox 24 in most circumstances, with specific exceptions noted below.
Note that add-ons which require an Intel Macintosh will not work with TenFourFox, even if they are otherwise compatible with Firefox 24, and add-ons that require 10.5 Leopard may not be compatible with TenFourFox running on Mac OS X 10.4 Tiger, even if they are compatible with PowerPC.
## This branch of TenFourFox is the stable version ##
Starting with Firefox 10, Mozilla began offering an extended support release version of Firefox ("Firefox **ESR**") intended for environments where users are unable to use rapid-release versions of Firefox due to policy or technical constraints. This ESR is the basis of the TenFourFox **stable** branch.
The current ESR release is based on Firefox 24. 10.4Fx 24.x is based on this extended support release and is intended for users who wish to remain with a stable browser core. The stable branch will continue to receive bugfixes and security updates, but will not receive new Firefox features (although it may receive certain 10.4Fx-specific features judged important for our legacy users).
**We recommend this version for most of our users.** If you wish to help test our continuing porting efforts, you can try the _unstable_ branch, which is based on the current release of Firefox. _The unstable branch does have bugs and is recommended only for advanced users._ For more information, see the [TenFourFox Development](http://tenfourfox.blogspot.com/) blog.
## TenFourFox no longer supports plugins or Flash ##
Plugins on PowerPC are of special concern because Mozilla is making updates to their plugin architecture which may require the plugins themselves to be updated, and there are certain difficult-to-correct bugs with them already on Tiger. Most importantly, QuickTime, Java and Adobe Flash for PowerPC are no longer maintained and have known security risks that can crash, perform malicious operations or leak data, and Flash 10.1 is rapidly becoming unsupported by many applications.
**For these and other reasons (for details, see PluginsNoLongerSupported), TenFourFox does not run plugins and they cannot be enabled.** Bug reports will no longer be accepted. Sites will now act as if no plugins were installed at all. Earlier versions that allowed an undocumented plugin support mode are no longer supported.
For Internet video, we now recommend the use of TenFourFox's optional QuickTimeEnabler. This allows many videos to be handled in QuickTime Player directly.
You can also download videos for separate viewing using [Perian](http://www.perian.org/) and any of the available video download add-ons for Firefox.
For YouTube, you may also be able to use [MacTubes](http://macapps.sakura.ne.jp/mactubes/index_en.html). If you have a high end G4 or G5, you can also use WebM for selected videos by visiting http://www.youtube.com/html5 and enabling HTML5 video. This will set a temporary cookie enabling browser-based video without Flash. You do not need a YouTube account for this feature, but you may need to periodically renew the cookie setting. Not all video is available in WebM.
For a more in-depth explanation of this policy and other workarounds, see PluginsNoLongerSupported.
## Fixed in this version of TenFourFox ##
* All security and stability fixes from Firefox ESR 24.5.0.
* An issue where the font blacklist could crash the browser has been repaired ([issue 265](https://code.google.com/p/tenfourfox/issues/detail?id=265)).
## Known issues specific to TenFourFox ##
* Remember: **Plugins do not work in TenFourFox and can no longer be enabled.** See PluginsNoLongerSupported for an explanation and suggested workarounds. Please note that out-of-process plugins have never been supported.
* TenFourFox uses a lighter chrome for windows and dialogue boxes than prior versions or the official Mac Firefox. This is intentional.
* Systems with large numbers of fonts installed may experience intermittent pauses.
* Some pages may perform better on 10.5 systems than 10.4 ([issue 193](https://code.google.com/p/tenfourfox/issues/detail?id=193)).
* The performance characteristics for the JavaScript compiler used in 24.0 and up are different from those of 17.0.
* Bitmap-only fonts (usually Type 1 PostScript) cannot be used by the 10.4Fx font renderer and are discarded. A fallback font will be used in their place.
* Personas and certain custom skins may hide the "traffic light" window buttons, but they are still present and will work if hovered over or clicked on ([issue 247](https://code.google.com/p/tenfourfox/issues/detail?id=247)).
* Not all webcams are supported; in addition, multiple webcams may not all appear depending on how they are connected ([issue 221](https://code.google.com/p/tenfourfox/issues/detail?id=221)). For a list of supported webcam devices, see VideoDeviceSupport.
* 10.4Fx does not currently support WebGL, WebRTC or the webapp runtime, and scripts such as Arabic or Indic requiring glyph reordering or language-specific ligatures may not appear correctly. See TechnicalDifferences for the complete list of changes necessary for 10.4Fx. See [issue 5](https://code.google.com/p/tenfourfox/issues/detail?id=5) for notes specific to the font issue.
* The titlebar does not always properly match the menu gradient ([issue 16](https://code.google.com/p/tenfourfox/issues/detail?id=16)). This problem is also in the official release. Installing a Persona may fix this issue if you find it bothersome.
* Crash reporting is intentionally disabled to avoid polluting Mozilla's crash tracking system with our reports. Please use your system's crash logs if you are reporting a _reproducible_ crash, or (if you are able) provide a `gdb` backtrace.
* Although 10.4Fx will tell you when an update is available, you must download updates manually at this time.
You are welcome to report other bugs that you find. However, please **do not report Mozilla bugs to us.** If the bug or crash occurs in both the official Mozilla Firefox 24 _(3.6 doesn't count!)_ and in 10.4Fx, this is a Mozilla bug, and you should file it at [Bugzilla](http://bugzilla.mozilla.org/). **You must test your bug in both places -- bugs that are not confirmed to be part of 10.4Fx will be marked invalid** so that we can keep our task list focused. This is the [current list of known issues](http://code.google.com/p/tenfourfox/issues/list).

64
ReleaseNotes2460.md Normal file
View File

@ -0,0 +1,64 @@
_This document may be updated for late-breaking changes, so check back here if you are having difficulty._
## System requirements ##
TenFourFox (hereafter "10.4Fx") requires a G3 Power Macintosh, Mac OS X 10.4.11, 100MB of free disk space and 512MB of RAM. 1GB of RAM and a G4 or G5 processor is recommended. Video playback is likely to be poor on systems slower than 1.25GHz; a G5 is recommended. Mac OS X 10.5.8 is supported.
Intel Macintoshes are not supported. Although some users have reported success getting the G3 version of 10.4Fx to run under Rosetta, certain features may not work correctly or at all on Intel Macs, and you may need to completely disable JavaScript compilation for it to work with Rosetta (see [the FAQ](AAATheFAQ.md) for more information). Because Apple no longer supports Rosetta and 10.4Fx is not a Universal binary, it will not run under Lion 10.7 or any subsequent version of Mac OS X.
## Getting TenFourFox ##
Make sure you select the appropriate build for your Mac from the [download page](http://www.tenfourfox.com/). The G3 version will run on any supported Macintosh, but it will not take advantage of the additional features of G4 or G5 processors. The G4 and G5 versions will not run at all on a G3, and the G5 version will perform badly or crash on non-G5 Macintoshes.
**Starting with 24.1.0, all downloads are hosted on SourceForge due to Google Code's download restrictions.** We strongly recommend getting the most recent version directly from [the main TenFourFox website](http://www.tenfourfox.com/), but you can also browse files in the [TenFourFox SourceForge repository](https://sourceforge.net/projects/tenfourfox/files/) if you prefer.
If you are using a G4, you should try to choose the correct version for your processor generation (7400 or 7450 "G4e") as performance may be impaired if you run the wrong one. If you don't know which G4 processor you have, the instructions in WhichVersion will tell you how to find out.
## TenFourFox 24 is equivalent to Firefox 24 ##
TenFourFox uses modified Firefox source code, rewritten to remain compatible with Mac OS X v10.4 and the Power Macintosh. It also contains specific optimizations and special features for PowerPC processors. For this reason, it is not exactly the same as Firefox. However, it is intended to be as compatible with it as possible, including most add-ons and [most standard features](TechnicalDifferences.md). You can treat 10.4Fx 24 as equivalent with Firefox 24 in most circumstances, with specific exceptions noted below.
Note that add-ons which require an Intel Macintosh will not work with TenFourFox, even if they are otherwise compatible with Firefox 24, and add-ons that require 10.5 Leopard may not be compatible with TenFourFox running on Mac OS X 10.4 Tiger, even if they are compatible with PowerPC.
## This branch of TenFourFox is the stable version ##
Starting with Firefox 10, Mozilla began offering an extended support release version of Firefox ("Firefox **ESR**") intended for environments where users are unable to use rapid-release versions of Firefox due to policy or technical constraints. This ESR is the basis of the TenFourFox **stable** branch.
The current ESR release is based on Firefox 24. 10.4Fx 24.x is based on this extended support release and is intended for users who wish to remain with a stable browser core. The stable branch will continue to receive bugfixes and security updates, but will not receive new Firefox features (although it may receive certain 10.4Fx-specific features judged important for our legacy users).
**We recommend this version for most of our users.** If you wish to help test our continuing porting efforts, you can try the _unstable_ branch, which is based on the current release of Firefox. _The unstable branch does have bugs and is recommended only for advanced users._ For more information, see the [TenFourFox Development](http://tenfourfox.blogspot.com/) blog.
## TenFourFox no longer supports plugins or Flash ##
Plugins on PowerPC are of special concern because Mozilla is making updates to their plugin architecture which may require the plugins themselves to be updated, and there are certain difficult-to-correct bugs with them already on Tiger. Most importantly, QuickTime, Java and Adobe Flash for PowerPC are no longer maintained and have known security risks that can crash, perform malicious operations or leak data, and Flash 10.1 is rapidly becoming unsupported by many applications.
**For these and other reasons (for details, see PluginsNoLongerSupported), TenFourFox does not run plugins and they cannot be enabled.** Bug reports will no longer be accepted. Sites will now act as if no plugins were installed at all. Earlier versions that allowed an undocumented plugin support mode are no longer supported.
For Internet video, we now recommend the use of TenFourFox's optional QuickTimeEnabler. This allows many videos to be handled in QuickTime Player directly.
You can also download videos for separate viewing using [Perian](http://www.perian.org/) and any of the available video download add-ons for Firefox.
For YouTube, you may also be able to use [MacTubes](http://macapps.sakura.ne.jp/mactubes/index_en.html). If you have a high end G4 or G5, you can also use WebM for selected videos by visiting http://www.youtube.com/html5 and enabling HTML5 video. This will set a temporary cookie enabling browser-based video without Flash. You do not need a YouTube account for this feature, but you may need to periodically renew the cookie setting. Not all video is available in WebM.
For a more in-depth explanation of this policy and other workarounds, see PluginsNoLongerSupported.
## Fixed in this version of TenFourFox ##
* All security and stability fixes from Firefox ESR 24.6.0.
## Known issues specific to TenFourFox ##
* Remember: **Plugins do not work in TenFourFox and can no longer be enabled.** See PluginsNoLongerSupported for an explanation and suggested workarounds. Please note that out-of-process plugins have never been supported.
* TenFourFox uses a lighter chrome for windows and dialogue boxes than prior versions or the official Mac Firefox. This is intentional.
* Systems with large numbers of fonts installed may experience intermittent pauses.
* Some pages may perform better on 10.5 systems than 10.4 ([issue 193](https://code.google.com/p/tenfourfox/issues/detail?id=193)).
* The performance characteristics for the JavaScript compiler used in 24.0 and up are different from those of 17.0.
* Bitmap-only fonts (usually Type 1 PostScript) cannot be used by the 10.4Fx font renderer and are discarded. A fallback font will be used in their place.
* Personas and certain custom skins may hide the "traffic light" window buttons, but they are still present and will work if hovered over or clicked on ([issue 247](https://code.google.com/p/tenfourfox/issues/detail?id=247)).
* Not all webcams are supported; in addition, multiple webcams may not all appear depending on how they are connected ([issue 221](https://code.google.com/p/tenfourfox/issues/detail?id=221)). For a list of supported webcam devices, see VideoDeviceSupport.
* 10.4Fx does not currently support WebGL, WebRTC or the webapp runtime, and scripts such as Arabic or Indic requiring glyph reordering or language-specific ligatures may not appear correctly. See TechnicalDifferences for the complete list of changes necessary for 10.4Fx. See [issue 5](https://code.google.com/p/tenfourfox/issues/detail?id=5) for notes specific to the font issue.
* The titlebar does not always properly match the menu gradient ([issue 16](https://code.google.com/p/tenfourfox/issues/detail?id=16)). This problem is also in the official release. Installing a Persona may fix this issue if you find it bothersome.
* Crash reporting is intentionally disabled to avoid polluting Mozilla's crash tracking system with our reports. Please use your system's crash logs if you are reporting a _reproducible_ crash, or (if you are able) provide a `gdb` backtrace.
* Although 10.4Fx will tell you when an update is available, you must download updates manually at this time.
You are welcome to report other bugs that you find. However, please **do not report Mozilla bugs to us.** If the bug or crash occurs in both the official Mozilla Firefox 24 _(3.6 doesn't count!)_ and in 10.4Fx, this is a Mozilla bug, and you should file it at [Bugzilla](http://bugzilla.mozilla.org/). **You must test your bug in both places -- bugs that are not confirmed to be part of 10.4Fx will be marked invalid** so that we can keep our task list focused. This is the [current list of known issues](http://code.google.com/p/tenfourfox/issues/list).

64
ReleaseNotes2470.md Normal file
View File

@ -0,0 +1,64 @@
_This document may be updated for late-breaking changes, so check back here if you are having difficulty._
## System requirements ##
TenFourFox (hereafter "10.4Fx") requires a G3 Power Macintosh, Mac OS X 10.4.11, 100MB of free disk space and 512MB of RAM. 1GB of RAM and a G4 or G5 processor is recommended. Video playback is likely to be poor on systems slower than 1.25GHz; a G5 is recommended. Mac OS X 10.5.8 is supported.
Intel Macintoshes are not supported. Although some users have reported success getting the G3 version of 10.4Fx to run under Rosetta, certain features may not work correctly or at all on Intel Macs, and you may need to completely disable JavaScript compilation for it to work with Rosetta (see [the FAQ](AAATheFAQ.md) for more information). Because Apple no longer supports Rosetta and 10.4Fx is not a Universal binary, it will not run under Lion 10.7 or any subsequent version of Mac OS X.
## Getting TenFourFox ##
Make sure you select the appropriate build for your Mac from the [download page](http://www.tenfourfox.com/). The G3 version will run on any supported Macintosh, but it will not take advantage of the additional features of G4 or G5 processors. The G4 and G5 versions will not run at all on a G3, and the G5 version will perform badly or crash on non-G5 Macintoshes.
**Starting with 24.1.0, all downloads are hosted on SourceForge due to Google Code's download restrictions.** We strongly recommend getting the most recent version directly from [the main TenFourFox website](http://www.tenfourfox.com/), but you can also browse files in the [TenFourFox SourceForge repository](https://sourceforge.net/projects/tenfourfox/files/) if you prefer.
If you are using a G4, you should try to choose the correct version for your processor generation (7400 or 7450 "G4e") as performance may be impaired if you run the wrong one. If you don't know which G4 processor you have, the instructions in WhichVersion will tell you how to find out.
## TenFourFox 24 is equivalent to Firefox 24 ##
TenFourFox uses modified Firefox source code, rewritten to remain compatible with Mac OS X v10.4 and the Power Macintosh. It also contains specific optimizations and special features for PowerPC processors. For this reason, it is not exactly the same as Firefox. However, it is intended to be as compatible with it as possible, including most add-ons and [most standard features](TechnicalDifferences.md). You can treat 10.4Fx 24 as equivalent with Firefox 24 in most circumstances, with specific exceptions noted below.
Note that add-ons which require an Intel Macintosh will not work with TenFourFox, even if they are otherwise compatible with Firefox 24, and add-ons that require 10.5 Leopard may not be compatible with TenFourFox running on Mac OS X 10.4 Tiger, even if they are compatible with PowerPC.
## This is the final release of TenFourFox 24 ##
Starting with Firefox 10, Mozilla began offering an extended support release version of Firefox ("Firefox **ESR**") intended for environments where users are unable to use rapid-release versions of Firefox due to policy or technical constraints. This ESR is the basis of the TenFourFox **stable** branch.
The current ESR release is currently based on Firefox 31. TenFourFox 31 is based on this extended support release and is intended for users who wish to remain with a stable browser core. The stable branch will continue to receive bugfixes and security updates, but will not receive new Firefox features (although it may receive certain 10.4Fx-specific features judged important for our legacy users).
**This legacy version, 24.7.0, is made available for users who cannot yet upgrade to 10.4Fx 31. However, it will not receive further updates. You are urged to update to TenFourFox 31 as soon as possible.**
## TenFourFox no longer supports plugins or Flash ##
Plugins on PowerPC are of special concern because Mozilla is making updates to their plugin architecture which may require the plugins themselves to be updated, and there are certain difficult-to-correct bugs with them already on Tiger. Most importantly, QuickTime, Java and Adobe Flash for PowerPC are no longer maintained and have known security risks that can crash, perform malicious operations or leak data, and Flash 10.1 is rapidly becoming unsupported by many applications.
**For these and other reasons (for details, see PluginsNoLongerSupported), TenFourFox does not run plugins and they cannot be enabled.** Bug reports will no longer be accepted. Sites will now act as if no plugins were installed at all. Earlier versions that allowed an undocumented plugin support mode are no longer supported.
For Internet video, we now recommend the use of TenFourFox's optional QuickTimeEnabler. This allows many videos to be handled in QuickTime Player directly.
You can also download videos for separate viewing using [Perian](http://www.perian.org/) and any of the available video download add-ons for Firefox.
For YouTube, you may also be able to use [MacTubes](http://macapps.sakura.ne.jp/mactubes/index_en.html). If you have a high end G4 or G5, you can also use WebM for selected videos by visiting http://www.youtube.com/html5 and enabling HTML5 video. This will set a temporary cookie enabling browser-based video without Flash. You do not need a YouTube account for this feature, but you may need to periodically renew the cookie setting. Not all video is available in WebM.
For a more in-depth explanation of this policy and other workarounds, see PluginsNoLongerSupported.
## Fixed in this version of TenFourFox ##
* All security and stability fixes from Firefox ESR 24.7.0.
## Known issues specific to TenFourFox ##
* Remember: **Plugins do not work in TenFourFox and can no longer be enabled.** See PluginsNoLongerSupported for an explanation and suggested workarounds. Please note that out-of-process plugins have never been supported.
* TenFourFox uses a lighter chrome for windows and dialogue boxes than prior versions or the official Mac Firefox. This is intentional.
* Systems with large numbers of fonts installed may experience intermittent pauses.
* Some pages may perform better on 10.5 systems than 10.4 ([issue 193](https://code.google.com/p/tenfourfox/issues/detail?id=193)).
* The performance characteristics for the JavaScript compiler used in 24.0 and up are different from those of 17.0.
* Bitmap-only fonts (usually Type 1 PostScript) cannot be used by the 10.4Fx font renderer and are discarded. A fallback font will be used in their place.
* Personas and certain custom skins may hide the "traffic light" window buttons, but they are still present and will work if hovered over or clicked on ([issue 247](https://code.google.com/p/tenfourfox/issues/detail?id=247)).
* Not all webcams are supported; in addition, multiple webcams may not all appear depending on how they are connected ([issue 221](https://code.google.com/p/tenfourfox/issues/detail?id=221)). For a list of supported webcam devices, see VideoDeviceSupport.
* 10.4Fx does not currently support WebGL, WebRTC or the webapp runtime, and scripts such as Arabic or Indic requiring glyph reordering or language-specific ligatures may not appear correctly. See TechnicalDifferences for the complete list of changes necessary for 10.4Fx. See [issue 5](https://code.google.com/p/tenfourfox/issues/detail?id=5) for notes specific to the font issue.
* The titlebar does not always properly match the menu gradient ([issue 16](https://code.google.com/p/tenfourfox/issues/detail?id=16)). This problem is also in the official release. Installing a Persona may fix this issue if you find it bothersome.
* Crash reporting is intentionally disabled to avoid polluting Mozilla's crash tracking system with our reports. Please use your system's crash logs if you are reporting a _reproducible_ crash, or (if you are able) provide a `gdb` backtrace.
* Although 10.4Fx will tell you when an update is available, you must download updates manually at this time.
You are welcome to report other bugs that you find. However, please **do not report Mozilla bugs to us.** If the bug or crash occurs in both the official Mozilla Firefox 24 _(3.6 doesn't count!)_ and in 10.4Fx, this is a Mozilla bug, and you should file it at [Bugzilla](http://bugzilla.mozilla.org/). **You must test your bug in both places -- bugs that are not confirmed to be part of 10.4Fx will be marked invalid** so that we can keep our task list focused. This is the [current list of known issues](http://code.google.com/p/tenfourfox/issues/list).

85
ReleaseNotes310.md Normal file
View File

@ -0,0 +1,85 @@
_This document may be updated for late-breaking changes, so check back here if you are having difficulty._
## System requirements ##
TenFourFox (hereafter "10.4Fx") requires a G3 Power Macintosh, Mac OS X 10.4.11, 200MB of free disk space and 512MB of RAM. 1GB of RAM and a G4 or G5 processor is recommended. Video playback is likely to be poor on systems slower than 1.25GHz; a G5 is recommended. Mac OS X 10.5.8 is supported. Although the browser may run under Mac OS X Server, it is not currently supported.
Intel Macintoshes are not supported. Although some users have reported success getting the G3 version of 10.4Fx to run under Rosetta, certain features may not work correctly or at all on Intel Macs, and you may need to completely disable JavaScript compilation for it to work with Rosetta (see [the FAQ](AAATheFAQ.md) for more information). Because Apple no longer supports Rosetta and 10.4Fx is not a Universal binary, it will not run under Lion 10.7 or any subsequent version of Mac OS X.
## Before you upgrade from an earlier version ##
If you are upgrading from an earlier version of 10.4Fx, make sure you are using the most current versions of the QuickTimeEnabler and MacTubesEnabler if you have them installed. In addition, major addons such as Adblock should be updated before you upgrade the browser.
Some other older add-ons may not function correctly in 31.x either due to substantial changes in the browser architecture.
## Getting TenFourFox ##
Make sure you select the appropriate build for your Mac from the [download page](http://www.tenfourfox.com/). The G3 version will run on any supported Macintosh, but it will not take advantage of the additional features of G4 or G5 processors. The G4 and G5 versions will not run at all on a G3, and the G5 version will perform badly or crash on non-G5 Macintoshes.
**Starting with 24.1.0, all downloads are hosted on SourceForge due to Google Code's download restrictions.** We strongly recommend getting the most recent version directly from [the main TenFourFox website](http://www.tenfourfox.com/), but you can also browse files in the [TenFourFox SourceForge repository](https://sourceforge.net/projects/tenfourfox/files/) if you prefer.
If you are using a G4, you should try to choose the correct version for your processor generation (7400 or 7450 "G4e") as performance may be impaired if you run the wrong one. If you don't know which G4 processor you have, the instructions in WhichVersion will tell you how to find out.
## TenFourFox 31 is equivalent to Firefox 31 ##
TenFourFox uses modified Firefox source code, rewritten to remain compatible with Mac OS X v10.4 and the Power Macintosh. It also contains specific optimizations and special features for PowerPC processors. For this reason, it is not exactly the same as Firefox. However, it is intended to be as compatible with it as possible, including most add-ons and [most standard features](TechnicalDifferences.md). You can treat 10.4Fx 31 as equivalent with Firefox 31 in most circumstances, with specific exceptions noted below.
Note that add-ons which require an Intel Macintosh will not work with TenFourFox, even if they are otherwise compatible with Firefox 31, and add-ons that require 10.5 Leopard (or higher) may not be compatible with TenFourFox running on Mac OS X 10.4 Tiger, even if they are compatible with PowerPC.
## This branch of TenFourFox is the _new_ stable version ##
Starting with Firefox 10, Mozilla began offering an extended support release version of Firefox ("Firefox **ESR**") intended for environments where users are unable to use rapid-release versions of Firefox due to policy or technical constraints. This ESR is the basis of the TenFourFox **stable** branch.
The current ESR release is based on Firefox 31. 10.4Fx 31.x is based on this extended support release and is intended for users who wish to remain with a stable browser core. The stable branch will continue to receive bugfixes and security updates, but will not receive new Firefox features (although it may receive certain 10.4Fx-specific features judged important for our legacy users).
**We recommend this version for most of our users.** If you wish to help test our continuing porting efforts, you can try the _unstable_ branch, which is based on the current release of Firefox. _The unstable branch does have bugs and is recommended only for advanced users._ For more information, see the [TenFourFox Development](http://tenfourfox.blogspot.com/) blog.
## TenFourFox no longer supports plugins or Flash ##
Plugins on PowerPC are of special concern because Mozilla is making updates to their plugin architecture which may require the plugins themselves to be updated, and there are certain difficult-to-correct bugs with them already on Tiger. Most importantly, QuickTime, Java and Adobe Flash for PowerPC are no longer maintained and have known security risks that can crash, perform malicious operations or leak data, and Flash 10.1 is rapidly becoming unsupported by many applications.
**For these and other reasons (for details, see PluginsNoLongerSupported), TenFourFox does not run plugins and they cannot be enabled.** Bug reports will no longer be accepted. Sites will now act as if no plugins were installed at all. Earlier versions that allowed an undocumented plugin support mode are no longer supported.
For Internet video, we now recommend the use of TenFourFox's optional QuickTimeEnabler. This allows many videos to be handled in QuickTime Player directly.
You can also download videos for separate viewing using [Perian](http://www.perian.org/) and any of the available video download add-ons for Firefox.
For YouTube, you may also be able to use [MacTubes](http://macapps.sakura.ne.jp/mactubes/index_en.html) along with the MacTubesEnabler. If you have a high end G4 or G5, you can also use WebM for selected videos by visiting http://www.youtube.com/html5 and enabling HTML5 video. This will set a temporary cookie enabling browser-based video without Flash. You do not need a YouTube account for this feature, but you may need to periodically renew the cookie setting. Not all video is available in WebM.
For a more in-depth explanation of this policy and other workarounds, see PluginsNoLongerSupported.
## New in this version of TenFourFox ##
* All new standard supported features of Firefox 31, including the new customizable "Australis" interface, accelerated web page rendering (with hardware acceleration where available), more aggressive memory management, SPDY 3.1 support, and additional ECMA6, CSS3 and HTML5 features.
## Fixed in the final release ##
* The G5 version no longer crashes with certain JavaScript operations ([issue 280](https://code.google.com/p/tenfourfox/issues/detail?id=280)).
* Additional performance improvements to garbage collection.
## Fixed in beta 3 ##
* Improved performance ([issue 277](https://code.google.com/p/tenfourfox/issues/detail?id=277)).
* The Window menu no longer displays spurious blank entries ([issue 278](https://code.google.com/p/tenfourfox/issues/detail?id=278)).
## Fixed in beta 2 ##
* The browser no longer crashes navigating to MP3 audio files.
* The browser no longer inserts extraneous characters when using IME composition with accented characters and Asian scripts ([issue 276](https://code.google.com/p/tenfourfox/issues/detail?id=276)).
* Off-main-thread composition and generational garbage collection are disabled for improved performance.
* Garbage collection tuning.
## Known issues specific to TenFourFox ##
* Remember: **Plugins do not work in TenFourFox and can no longer be enabled.** See PluginsNoLongerSupported for an explanation and suggested workarounds.
* TenFourFox uses a lighter chrome for windows and dialogue boxes than prior versions or the official Mac Firefox. This is intentional.
* Systems with large numbers of fonts installed may experience intermittent pauses.
* Bitmap-only fonts (usually Type 1 PostScript) cannot be used by the 10.4Fx font renderer and are automatically ignored by the browser. A fallback font will be used in their place.
* Personas and certain custom skins may hide the "traffic light" window buttons, but they are still present and will work if hovered over or clicked on ([issue 247](https://code.google.com/p/tenfourfox/issues/detail?id=247)).
* Not all webcams are supported; in addition, multiple webcams may not all appear depending on how they are connected ([issue 221](https://code.google.com/p/tenfourfox/issues/detail?id=221)). For a list of supported webcam devices, see VideoDeviceSupport.
* 10.4Fx does not currently support WebGL, WebRTC or the webapp runtime, and scripts such as Arabic or Indic requiring glyph reordering or language-specific ligatures may not appear correctly. See TechnicalDifferences for the complete list of changes necessary for 10.4Fx. See [issue 5](https://code.google.com/p/tenfourfox/issues/detail?id=5) for notes specific to the font issue.
* Printing may crash the browser on Mac OS X Tiger Server ([issue 279](https://code.google.com/p/tenfourfox/issues/detail?id=279)). Please note that Mac OS X Server is not supported currently.
* Crash reporting is intentionally disabled to avoid polluting Mozilla's crash tracking system with our reports. Please use your system's crash logs if you are reporting a _reproducible_ crash, or (if you are able) provide a `gdb` backtrace.
* Although 10.4Fx will tell you when an update is available, you must download updates manually at this time.
You are welcome to report other bugs that you find. However, please **do not report Mozilla bugs to us.** If the bug or crash occurs in both the official Mozilla Firefox 31 _(3.6 doesn't count!)_ and in 10.4Fx, this is a Mozilla bug, and you should file it at [Bugzilla](http://bugzilla.mozilla.org/). **You must test your bug in both places -- bugs that are not confirmed to be part of 10.4Fx will be marked invalid** so that we can keep our task list focused. This is the [current list of known issues](http://code.google.com/p/tenfourfox/issues/list).

73
ReleaseNotes3110.md Normal file
View File

@ -0,0 +1,73 @@
_This document may be updated for late-breaking changes, so check back here if you are having difficulty._
## System requirements ##
TenFourFox (hereafter "10.4Fx") requires a G3 Power Macintosh, Mac OS X 10.4.11, 200MB of free disk space and 512MB of RAM. 1GB of RAM and a G4 or G5 processor is recommended. Video playback is likely to be poor on systems slower than 1.25GHz; a G5 is recommended. Mac OS X 10.5.8 is supported. Although the browser may run under Mac OS X Server, it is not currently supported.
Intel Macintoshes are not supported. Although some users have reported success getting the G3 version of 10.4Fx to run under Rosetta, certain features may not work correctly or at all on Intel Macs, and you may need to completely disable JavaScript compilation for it to work with Rosetta (see [the FAQ](AAATheFAQ.md) for more information). Because Apple no longer supports Rosetta and 10.4Fx is not a Universal binary, it will not run under Lion 10.7 or any subsequent version of Mac OS X.
## Before you upgrade from an earlier version ##
If you are upgrading from an earlier version of 10.4Fx, make sure you are using the most current versions of the QuickTimeEnabler and MacTubesEnabler if you have them installed. In addition, major addons such as Adblock should be updated before you upgrade the browser.
Some other older add-ons may not function correctly in 31.x either due to substantial changes in the browser architecture.
## Getting TenFourFox ##
Make sure you select the appropriate build for your Mac from the [download page](http://www.tenfourfox.com/). The G3 version will run on any supported Macintosh, but it will not take advantage of the additional features of G4 or G5 processors. The G4 and G5 versions will not run at all on a G3, and the G5 version will perform badly or crash on non-G5 Macintoshes.
**Starting with 24.1.0, all downloads are hosted on SourceForge due to Google Code's download restrictions.** We strongly recommend getting the most recent version directly from [the main TenFourFox website](http://www.tenfourfox.com/), but you can also browse files in the [TenFourFox SourceForge repository](https://sourceforge.net/projects/tenfourfox/files/) if you prefer.
If you are using a G4, you should try to choose the correct version for your processor generation (7400 or 7450 "G4e") as performance may be impaired if you run the wrong one. If you don't know which G4 processor you have, the instructions in WhichVersion will tell you how to find out.
## TenFourFox 31 is equivalent to Firefox 31 ##
TenFourFox uses modified Firefox source code, rewritten to remain compatible with Mac OS X v10.4 and the Power Macintosh. It also contains specific optimizations and special features for PowerPC processors. For this reason, it is not exactly the same as Firefox. However, it is intended to be as compatible with it as possible, including most add-ons and [most standard features](TechnicalDifferences.md). You can treat 10.4Fx 31 as equivalent with Firefox 31 in most circumstances, with specific exceptions noted below.
Note that add-ons which require an Intel Macintosh will not work with TenFourFox, even if they are otherwise compatible with Firefox 31, and add-ons that require 10.5 Leopard (or higher) may not be compatible with TenFourFox running on Mac OS X 10.4 Tiger, even if they are compatible with PowerPC.
## This branch of TenFourFox is the _new_ stable version ##
Starting with Firefox 10, Mozilla began offering an extended support release version of Firefox ("Firefox **ESR**") intended for environments where users are unable to use rapid-release versions of Firefox due to policy or technical constraints. This ESR is the basis of the TenFourFox **stable** branch.
The current ESR release is based on Firefox 31. 10.4Fx 31.x is based on this extended support release and is intended for users who wish to remain with a stable browser core. The stable branch will continue to receive bugfixes and security updates, but will not receive new Firefox features (although it may receive certain 10.4Fx-specific features judged important for our legacy users).
**We recommend this version for most of our users.** If you wish to help test our continuing porting efforts, you can try the _unstable_ branch, which is based on the current release of Firefox. _The unstable branch does have bugs and is recommended only for advanced users._ For more information, see the [TenFourFox Development](http://tenfourfox.blogspot.com/) blog.
## TenFourFox no longer supports plugins or Flash ##
Plugins on PowerPC are of special concern because Mozilla is making updates to their plugin architecture which may require the plugins themselves to be updated, and there are certain difficult-to-correct bugs with them already on Tiger. Most importantly, QuickTime, Java and Adobe Flash for PowerPC are no longer maintained and have known security risks that can crash, perform malicious operations or leak data, and Flash 10.1 is rapidly becoming unsupported by many applications.
**For these and other reasons (for details, see PluginsNoLongerSupported), TenFourFox does not run plugins and they cannot be enabled.** Bug reports will no longer be accepted. Sites will now act as if no plugins were installed at all. Earlier versions that allowed an undocumented plugin support mode are no longer supported.
For Internet video, we now recommend the use of TenFourFox's optional QuickTimeEnabler. This allows many videos to be handled in QuickTime Player directly.
You can also download videos for separate viewing using [Perian](http://www.perian.org/) and any of the available video download add-ons for Firefox.
For YouTube, you may also be able to use [MacTubes](http://macapps.sakura.ne.jp/mactubes/index_en.html) along with the MacTubesEnabler. If you have a high end G4 or G5, you can also use WebM for selected videos by visiting http://www.youtube.com/html5 and enabling HTML5 video. This will set a temporary cookie enabling browser-based video without Flash. You do not need a YouTube account for this feature, but you may need to periodically renew the cookie setting. Not all video is available in WebM.
For a more in-depth explanation of this policy and other workarounds, see PluginsNoLongerSupported.
## Fixed in this version of TenFourFox ##
* Trackpad scrolling on supported PowerBooks/iBooks and with the Mighty Mouse works properly again ([issue 283](https://code.google.com/p/tenfourfox/issues/detail?id=283)).
* Screen scrolling performance is improved overall ([issue 284](https://code.google.com/p/tenfourfox/issues/detail?id=284)).
* Latency in the JavaScript JIT compiler is reduced ([issue 286](https://code.google.com/p/tenfourfox/issues/detail?id=286)).
* All security and stability fixes from Firefox ESR 31.1.0.
If you are new to TenFourFox 31, you may also wish to read the [release notes for 31.0](ReleaseNotes310.md).
## Known issues specific to TenFourFox ##
* Remember: **Plugins do not work in TenFourFox and can no longer be enabled.** See PluginsNoLongerSupported for an explanation and suggested workarounds.
* TenFourFox uses a lighter chrome for windows and dialogue boxes than prior versions or the official Mac Firefox. This is intentional.
* Systems with large numbers of fonts installed may experience intermittent pauses.
* Bitmap-only fonts (usually Type 1 PostScript) cannot be used by the 10.4Fx font renderer and are automatically ignored by the browser. A fallback font will be used in their place.
* Personas and certain custom skins may hide the "traffic light" window buttons, but they are still present and will work if hovered over or clicked on ([issue 247](https://code.google.com/p/tenfourfox/issues/detail?id=247)).
* Not all webcams are supported; in addition, multiple webcams may not all appear depending on how they are connected ([issue 221](https://code.google.com/p/tenfourfox/issues/detail?id=221)). For a list of supported webcam devices, see VideoDeviceSupport.
* 10.4Fx does not currently support WebGL, WebRTC or the webapp runtime, and scripts such as Arabic or Indic requiring glyph reordering or language-specific ligatures may not appear correctly. See TechnicalDifferences for the complete list of changes necessary for 10.4Fx. See [issue 5](https://code.google.com/p/tenfourfox/issues/detail?id=5) for notes specific to the font issue.
* Printing may crash the browser on Mac OS X Tiger Server ([issue 279](https://code.google.com/p/tenfourfox/issues/detail?id=279)). Please note that Mac OS X Server is not supported currently.
* Crash reporting is intentionally disabled to avoid polluting Mozilla's crash tracking system with our reports. Please use your system's crash logs if you are reporting a _reproducible_ crash, or (if you are able) provide a `gdb` backtrace.
* Although 10.4Fx will tell you when an update is available, you must download updates manually at this time.
You are welcome to report other bugs that you find. However, please **do not report Mozilla bugs to us.** If the bug or crash occurs in both the official Mozilla Firefox 31 _(3.6 doesn't count!)_ and in 10.4Fx, this is a Mozilla bug, and you should file it at [Bugzilla](http://bugzilla.mozilla.org/). **You must test your bug in both places -- bugs that are not confirmed to be part of 10.4Fx will be marked invalid** so that we can keep our task list focused. This is the [current list of known issues](http://code.google.com/p/tenfourfox/issues/list).

71
ReleaseNotes3111.md Normal file
View File

@ -0,0 +1,71 @@
_This document may be updated for late-breaking changes, so check back here if you are having difficulty._
## System requirements ##
TenFourFox (hereafter "10.4Fx") requires a G3 Power Macintosh, Mac OS X 10.4.11, 200MB of free disk space and 512MB of RAM. 1GB of RAM and a G4 or G5 processor is recommended. Video playback is likely to be poor on systems slower than 1.25GHz; a G5 is recommended. Mac OS X 10.5.8 is supported. Although the browser may run under Mac OS X Server, it is not currently supported.
Intel Macintoshes are not supported. Although some users have reported success getting the G3 version of 10.4Fx to run under Rosetta, certain features may not work correctly or at all on Intel Macs, and you may need to completely disable JavaScript compilation for it to work with Rosetta (see [the FAQ](AAATheFAQ.md) for more information). Because Apple no longer supports Rosetta and 10.4Fx is not a Universal binary, it will not run under Lion 10.7 or any subsequent version of Mac OS X.
## Before you upgrade from an earlier version ##
If you are upgrading from an earlier version of 10.4Fx, make sure you are using the most current versions of the QuickTimeEnabler and MacTubesEnabler if you have them installed. In addition, major addons such as Adblock should be updated before you upgrade the browser.
Some other older add-ons may not function correctly in 31.x either due to substantial changes in the browser architecture.
## Getting TenFourFox ##
Make sure you select the appropriate build for your Mac from the [download page](http://www.tenfourfox.com/). The G3 version will run on any supported Macintosh, but it will not take advantage of the additional features of G4 or G5 processors. The G4 and G5 versions will not run at all on a G3, and the G5 version will perform badly or crash on non-G5 Macintoshes.
**Starting with 24.1.0, all downloads are hosted on SourceForge due to Google Code's download restrictions.** We strongly recommend getting the most recent version directly from [the main TenFourFox website](http://www.tenfourfox.com/), but you can also browse files in the [TenFourFox SourceForge repository](https://sourceforge.net/projects/tenfourfox/files/) if you prefer.
If you are using a G4, you should try to choose the correct version for your processor generation (7400 or 7450 "G4e") as performance may be impaired if you run the wrong one. If you don't know which G4 processor you have, the instructions in WhichVersion will tell you how to find out.
## TenFourFox 31 is equivalent to Firefox 31 ##
TenFourFox uses modified Firefox source code, rewritten to remain compatible with Mac OS X v10.4 and the Power Macintosh. It also contains specific optimizations and special features for PowerPC processors. For this reason, it is not exactly the same as Firefox. However, it is intended to be as compatible with it as possible, including most add-ons and [most standard features](TechnicalDifferences.md). You can treat 10.4Fx 31 as equivalent with Firefox 31 in most circumstances, with specific exceptions noted below.
Note that add-ons which require an Intel Macintosh will not work with TenFourFox, even if they are otherwise compatible with Firefox 31, and add-ons that require 10.5 Leopard (or higher) may not be compatible with TenFourFox running on Mac OS X 10.4 Tiger, even if they are compatible with PowerPC.
## This branch of TenFourFox is the _new_ stable version ##
Starting with Firefox 10, Mozilla began offering an extended support release version of Firefox ("Firefox **ESR**") intended for environments where users are unable to use rapid-release versions of Firefox due to policy or technical constraints. This ESR is the basis of the TenFourFox **stable** branch.
The current ESR release is based on Firefox 31. 10.4Fx 31.x is based on this extended support release and is intended for users who wish to remain with a stable browser core. The stable branch will continue to receive bugfixes and security updates, but will not receive new Firefox features (although it may receive certain 10.4Fx-specific features judged important for our legacy users).
**We recommend this version for most of our users.** If you wish to help test our continuing porting efforts, you can try the _unstable_ branch, which is based on the current release of Firefox. _The unstable branch does have bugs and is recommended only for advanced users._ For more information, see the [TenFourFox Development](http://tenfourfox.blogspot.com/) blog.
## TenFourFox no longer supports plugins or Flash ##
Plugins on PowerPC are of special concern because Mozilla is making updates to their plugin architecture which may require the plugins themselves to be updated, and there are certain difficult-to-correct bugs with them already on Tiger. Most importantly, QuickTime, Java and Adobe Flash for PowerPC are no longer maintained and have known security risks that can crash, perform malicious operations or leak data, and Flash 10.1 is rapidly becoming unsupported by many applications.
**For these and other reasons (for details, see PluginsNoLongerSupported), TenFourFox does not run plugins and they cannot be enabled.** Bug reports will no longer be accepted. Sites will now act as if no plugins were installed at all. Earlier versions that allowed an undocumented plugin support mode are no longer supported.
For Internet video, we now recommend the use of TenFourFox's optional QuickTimeEnabler. This allows many videos to be handled in QuickTime Player directly.
You can also download videos for separate viewing using [Perian](http://www.perian.org/) and any of the available video download add-ons for Firefox.
For YouTube, you may also be able to use [MacTubes](http://macapps.sakura.ne.jp/mactubes/index_en.html) along with the MacTubesEnabler. If you have a high end G4 or G5, you can also use WebM for selected videos by visiting http://www.youtube.com/html5 and enabling HTML5 video. This will set a temporary cookie enabling browser-based video without Flash. You do not need a YouTube account for this feature, but you may need to periodically renew the cookie setting. Not all video is available in WebM.
For a more in-depth explanation of this policy and other workarounds, see PluginsNoLongerSupported.
## Fixed in this version of TenFourFox ##
* A flaw in Mozilla's encryption library that could mistakenly allow forged site certificates has been repaired ([CVE-2014-1568/MFSA 2014-73](https://www.mozilla.org/security/announce/2014/mfsa2014-73.html)). This issue affects all previous versions of TenFourFox and Firefox through at least 3.0.
* All security and stability patches to date from Firefox ESR 31.1.1.
If you are new to TenFourFox 31, you may also wish to read the release notes for [31.1.0](ReleaseNotes3110.md) and [31.0](ReleaseNotes310.md).
## Known issues specific to TenFourFox ##
* Remember: **Plugins do not work in TenFourFox and can no longer be enabled.** See PluginsNoLongerSupported for an explanation and suggested workarounds.
* TenFourFox uses a lighter chrome for windows and dialogue boxes than prior versions or the official Mac Firefox. This is intentional.
* Systems with large numbers of fonts installed may experience intermittent pauses.
* Bitmap-only fonts (usually Type 1 PostScript) cannot be used by the 10.4Fx font renderer and are automatically ignored by the browser. A fallback font will be used in their place.
* Personas and certain custom skins may hide the "traffic light" window buttons, but they are still present and will work if hovered over or clicked on ([issue 247](https://code.google.com/p/tenfourfox/issues/detail?id=247)).
* Not all webcams are supported; in addition, multiple webcams may not all appear depending on how they are connected ([issue 221](https://code.google.com/p/tenfourfox/issues/detail?id=221)). For a list of supported webcam devices, see VideoDeviceSupport.
* 10.4Fx does not currently support WebGL, WebRTC or the webapp runtime, and scripts such as Arabic or Indic requiring glyph reordering or language-specific ligatures may not appear correctly. See TechnicalDifferences for the complete list of changes necessary for 10.4Fx. See [issue 5](https://code.google.com/p/tenfourfox/issues/detail?id=5) for notes specific to the font issue.
* Printing may crash the browser on Mac OS X Tiger Server ([issue 279](https://code.google.com/p/tenfourfox/issues/detail?id=279)). Please note that Mac OS X Server is not supported currently.
* Crash reporting is intentionally disabled to avoid polluting Mozilla's crash tracking system with our reports. Please use your system's crash logs if you are reporting a _reproducible_ crash, or (if you are able) provide a `gdb` backtrace.
* Although 10.4Fx will tell you when an update is available, you must download updates manually at this time.
You are welcome to report other bugs that you find. However, please **do not report Mozilla bugs to us.** If the bug or crash occurs in both the official Mozilla Firefox 31 _(3.6 doesn't count!)_ and in 10.4Fx, this is a Mozilla bug, and you should file it at [Bugzilla](http://bugzilla.mozilla.org/). **You must test your bug in both places -- bugs that are not confirmed to be part of 10.4Fx will be marked invalid** so that we can keep our task list focused. This is the [current list of known issues](http://code.google.com/p/tenfourfox/issues/list).

70
ReleaseNotes3120.md Normal file
View File

@ -0,0 +1,70 @@
_This document may be updated for late-breaking changes, so check back here if you are having difficulty._
## System requirements ##
TenFourFox (hereafter "10.4Fx") requires a G3 Power Macintosh, Mac OS X 10.4.11, 200MB of free disk space and 512MB of RAM. 1GB of RAM and a G4 or G5 processor is recommended. Video playback is likely to be poor on systems slower than 1.25GHz; a G5 is recommended. Mac OS X 10.5.8 is supported. Although the browser may run under Mac OS X Server, it is not currently supported.
Intel Macintoshes are not supported. Although some users have reported success getting the G3 version of 10.4Fx to run under Rosetta, certain features may not work correctly or at all on Intel Macs, and you may need to completely disable JavaScript compilation for it to work with Rosetta (see [the FAQ](AAATheFAQ.md) for more information). Because Apple no longer supports Rosetta and 10.4Fx is not a Universal binary, it will not run under Lion 10.7 or any subsequent version of Mac OS X.
## Before you upgrade from an earlier version ##
If you are upgrading from an earlier version of 10.4Fx, make sure you are using the most current versions of the QuickTimeEnabler and MacTubesEnabler if you have them installed. In addition, major addons such as Adblock should be updated before you upgrade the browser.
Some other older add-ons may not function correctly in 31.x either due to substantial changes in the browser architecture.
## Getting TenFourFox ##
Make sure you select the appropriate build for your Mac from the [download page](http://www.tenfourfox.com/). The G3 version will run on any supported Macintosh, but it will not take advantage of the additional features of G4 or G5 processors. The G4 and G5 versions will not run at all on a G3, and the G5 version will perform badly or crash on non-G5 Macintoshes.
**Starting with 24.1.0, all downloads are hosted on SourceForge due to Google Code's download restrictions.** We strongly recommend getting the most recent version directly from [the main TenFourFox website](http://www.tenfourfox.com/), but you can also browse files in the [TenFourFox SourceForge repository](https://sourceforge.net/projects/tenfourfox/files/) if you prefer.
If you are using a G4, you should try to choose the correct version for your processor generation (7400 or 7450 "G4e") as performance may be impaired if you run the wrong one. If you don't know which G4 processor you have, the instructions in WhichVersion will tell you how to find out.
## TenFourFox 31 is equivalent to Firefox 31 ##
TenFourFox uses modified Firefox source code, rewritten to remain compatible with Mac OS X v10.4 and the Power Macintosh. It also contains specific optimizations and special features for PowerPC processors. For this reason, it is not exactly the same as Firefox. However, it is intended to be as compatible with it as possible, including most add-ons and [most standard features](TechnicalDifferences.md). You can treat 10.4Fx 31 as equivalent with Firefox 31 in most circumstances, with specific exceptions noted below.
Note that add-ons which require an Intel Macintosh will not work with TenFourFox, even if they are otherwise compatible with Firefox 31, and add-ons that require 10.5 Leopard (or higher) may not be compatible with TenFourFox running on Mac OS X 10.4 Tiger, even if they are compatible with PowerPC.
## This branch of TenFourFox is the _new_ stable version ##
Starting with Firefox 10, Mozilla began offering an extended support release version of Firefox ("Firefox **ESR**") intended for environments where users are unable to use rapid-release versions of Firefox due to policy or technical constraints. This ESR is the basis of the TenFourFox **stable** branch.
The current ESR release is based on Firefox 31. 10.4Fx 31.x is based on this extended support release and is intended for users who wish to remain with a stable browser core. The stable branch will continue to receive bugfixes and security updates, but will not receive new Firefox features (although it may receive certain 10.4Fx-specific features judged important for our legacy users).
**We recommend this version for most of our users.** If you wish to help test our continuing porting efforts, you can try the _unstable_ branch, which is based on the current release of Firefox. _The unstable branch does have bugs and is recommended only for advanced users._ For more information, see the [TenFourFox Development](http://tenfourfox.blogspot.com/) blog.
## TenFourFox no longer supports plugins or Flash ##
Plugins on PowerPC are of special concern because Mozilla is making updates to their plugin architecture which may require the plugins themselves to be updated, and there are certain difficult-to-correct bugs with them already on Tiger. Most importantly, QuickTime, Java and Adobe Flash for PowerPC are no longer maintained and have known security risks that can crash, perform malicious operations or leak data, and Flash 10.1 is rapidly becoming unsupported by many applications.
**For these and other reasons (for details, see PluginsNoLongerSupported), TenFourFox does not run plugins and they cannot be enabled.** Bug reports will no longer be accepted. Sites will now act as if no plugins were installed at all. Earlier versions that allowed an undocumented plugin support mode are no longer supported.
For Internet video, we now recommend the use of TenFourFox's optional QuickTimeEnabler. This allows many videos to be handled in QuickTime Player directly.
You can also download videos for separate viewing using [Perian](http://www.perian.org/) and any of the available video download add-ons for Firefox.
For YouTube, you may also be able to use [MacTubes](http://macapps.sakura.ne.jp/mactubes/index_en.html) along with the MacTubesEnabler. If you have a high end G4 or G5, you can also use WebM for selected videos by visiting http://www.youtube.com/html5 and enabling HTML5 video. This will set a temporary cookie enabling browser-based video without Flash. You do not need a YouTube account for this feature, but you may need to periodically renew the cookie setting. Not all video is available in WebM.
For a more in-depth explanation of this policy and other workarounds, see PluginsNoLongerSupported.
## Fixed in this version of TenFourFox ##
* All security and stability patches from Firefox ESR 31.2.0.
If you are new to TenFourFox 31, you may also wish to read the release notes for [31.1.0](ReleaseNotes3110.md) and [31.0](ReleaseNotes310.md).
## Known issues specific to TenFourFox ##
* Remember: **Plugins do not work in TenFourFox and can no longer be enabled.** See PluginsNoLongerSupported for an explanation and suggested workarounds.
* TenFourFox uses a lighter chrome for windows and dialogue boxes than prior versions or the official Mac Firefox. This is intentional.
* Systems with large numbers of fonts installed may experience intermittent pauses.
* Bitmap-only fonts (usually Type 1 PostScript) cannot be used by the 10.4Fx font renderer and are automatically ignored by the browser. A fallback font will be used in their place.
* Personas and certain custom skins may hide the "traffic light" window buttons, but they are still present and will work if hovered over or clicked on ([issue 247](https://code.google.com/p/tenfourfox/issues/detail?id=247)).
* Not all webcams are supported; in addition, multiple webcams may not all appear depending on how they are connected ([issue 221](https://code.google.com/p/tenfourfox/issues/detail?id=221)). For a list of supported webcam devices, see VideoDeviceSupport.
* 10.4Fx does not currently support WebGL, WebRTC or the webapp runtime, and scripts such as Arabic or Indic requiring glyph reordering or language-specific ligatures may not appear correctly. See TechnicalDifferences for the complete list of changes necessary for 10.4Fx. See [issue 5](https://code.google.com/p/tenfourfox/issues/detail?id=5) for notes specific to the font issue.
* Printing may crash the browser on Mac OS X Tiger Server ([issue 279](https://code.google.com/p/tenfourfox/issues/detail?id=279)). Please note that Mac OS X Server is not supported currently.
* Crash reporting is intentionally disabled to avoid polluting Mozilla's crash tracking system with our reports. Please use your system's crash logs if you are reporting a _reproducible_ crash, or (if you are able) provide a `gdb` backtrace.
* Although 10.4Fx will tell you when an update is available, you must download updates manually at this time.
You are welcome to report other bugs that you find. However, please **do not report Mozilla bugs to us.** If the bug or crash occurs in both the official Mozilla Firefox 31 _(3.6 doesn't count!)_ and in 10.4Fx, this is a Mozilla bug, and you should file it at [Bugzilla](http://bugzilla.mozilla.org/). **You must test your bug in both places -- bugs that are not confirmed to be part of 10.4Fx will be marked invalid** so that we can keep our task list focused. This is the [current list of known issues](http://code.google.com/p/tenfourfox/issues/list).

70
ReleaseNotes3130.md Normal file
View File

@ -0,0 +1,70 @@
_This document may be updated for late-breaking changes, so check back here if you are having difficulty._
## System requirements ##
TenFourFox (hereafter "10.4Fx") requires a G3 Power Macintosh, Mac OS X 10.4.11, 200MB of free disk space and 512MB of RAM. 1GB of RAM and a G4 or G5 processor is recommended. Video playback is likely to be poor on systems slower than 1.25GHz; a G5 is recommended. Mac OS X 10.5.8 is supported. Although the browser may run under Mac OS X Server, it is not currently supported.
Intel Macintoshes are not supported. Although some users have reported success getting the G3 version of 10.4Fx to run under Rosetta, certain features may not work correctly or at all on Intel Macs, and you may need to completely disable JavaScript compilation for it to work with Rosetta (see [the FAQ](AAATheFAQ.md) for more information). Because Apple no longer supports Rosetta and 10.4Fx is not a Universal binary, it will not run under Lion 10.7 or any subsequent version of Mac OS X.
## Before you upgrade from an earlier version ##
If you are upgrading from an earlier version of 10.4Fx, make sure you are using the most current versions of the QuickTimeEnabler and MacTubesEnabler if you have them installed. In addition, major addons such as Adblock should be updated before you upgrade the browser.
Some other older add-ons may not function correctly in 31.x either due to substantial changes in the browser architecture.
## Getting TenFourFox ##
Make sure you select the appropriate build for your Mac from the [download page](http://www.tenfourfox.com/). The G3 version will run on any supported Macintosh, but it will not take advantage of the additional features of G4 or G5 processors. The G4 and G5 versions will not run at all on a G3, and the G5 version will perform badly or crash on non-G5 Macintoshes.
**Starting with 24.1.0, all downloads are hosted on SourceForge due to Google Code's download restrictions.** We strongly recommend getting the most recent version directly from [the main TenFourFox website](http://www.tenfourfox.com/), but you can also browse files in the [TenFourFox SourceForge repository](https://sourceforge.net/projects/tenfourfox/files/) if you prefer.
If you are using a G4, you should try to choose the correct version for your processor generation (7400 or 7450 "G4e") as performance may be impaired if you run the wrong one. If you don't know which G4 processor you have, the instructions in WhichVersion will tell you how to find out.
## TenFourFox 31 is equivalent to Firefox 31 ##
TenFourFox uses modified Firefox source code, rewritten to remain compatible with Mac OS X v10.4 and the Power Macintosh. It also contains specific optimizations and special features for PowerPC processors. For this reason, it is not exactly the same as Firefox. However, it is intended to be as compatible with it as possible, including most add-ons and [most standard features](TechnicalDifferences.md). You can treat 10.4Fx 31 as equivalent with Firefox 31 in most circumstances, with specific exceptions noted below.
Note that add-ons which require an Intel Macintosh will not work with TenFourFox, even if they are otherwise compatible with Firefox 31, and add-ons that require 10.5 Leopard (or higher) may not be compatible with TenFourFox running on Mac OS X 10.4 Tiger, even if they are compatible with PowerPC.
## This branch of TenFourFox is the _new_ stable version ##
Starting with Firefox 10, Mozilla began offering an extended support release version of Firefox ("Firefox **ESR**") intended for environments where users are unable to use rapid-release versions of Firefox due to policy or technical constraints. This ESR is the basis of the TenFourFox **stable** branch.
The current ESR release is based on Firefox 31. 10.4Fx 31.x is based on this extended support release and is intended for users who wish to remain with a stable browser core. The stable branch will continue to receive bugfixes and security updates, but will not receive new Firefox features (although it may receive certain 10.4Fx-specific features judged important for our legacy users).
**We recommend this version for most of our users.** If you wish to help test our continuing porting efforts, you can try the _unstable_ branch, which is based on the current release of Firefox. _The unstable branch does have bugs and is recommended only for advanced users._ For more information, see the [TenFourFox Development](http://tenfourfox.blogspot.com/) blog.
## TenFourFox no longer supports plugins or Flash ##
Plugins on PowerPC are of special concern because Mozilla is making updates to their plugin architecture which may require the plugins themselves to be updated, and there are certain difficult-to-correct bugs with them already on Tiger. Most importantly, QuickTime, Java and Adobe Flash for PowerPC are no longer maintained and have known security risks that can crash, perform malicious operations or leak data, and Flash 10.1 is rapidly becoming unsupported by many applications.
**For these and other reasons (for details, see PluginsNoLongerSupported), TenFourFox does not run plugins and they cannot be enabled.** Bug reports will no longer be accepted. Sites will now act as if no plugins were installed at all. Earlier versions that allowed an undocumented plugin support mode are no longer supported.
For Internet video, we now recommend the use of TenFourFox's optional QuickTimeEnabler. This allows many videos to be handled in QuickTime Player directly.
You can also download videos for separate viewing using [Perian](http://www.perian.org/) and any of the available video download add-ons for Firefox.
For YouTube, you may also be able to use [MacTubes](http://macapps.sakura.ne.jp/mactubes/index_en.html) along with the MacTubesEnabler. If you have a high end G4 or G5, you can also use WebM for selected videos by visiting http://www.youtube.com/html5 and enabling HTML5 video. This will set a temporary cookie enabling browser-based video without Flash. You do not need a YouTube account for this feature, but you may need to periodically renew the cookie setting. Not all video is available in WebM.
For a more in-depth explanation of this policy and other workarounds, see PluginsNoLongerSupported.
## Fixed in this version of TenFourFox ##
* All security and stability patches from Firefox ESR 31.3.0.
* A crash printing pages with partial opacity was fixed ([issue 290](https://code.google.com/p/tenfourfox/issues/detail?id=290), Mozilla [bug 1059807](https://code.google.com/p/tenfourfox/issues/detail?id=059807)).
* Garbage collection properly handles multiple CPUs ([issue 292](https://code.google.com/p/tenfourfox/issues/detail?id=292)).
## Known issues specific to TenFourFox ##
* Remember: **Plugins do not work in TenFourFox and can no longer be enabled.** See PluginsNoLongerSupported for an explanation and suggested workarounds.
* TenFourFox uses a lighter chrome for windows and dialogue boxes than prior versions or the official Mac Firefox. This is intentional.
* Systems with large numbers of fonts installed may experience intermittent pauses.
* Bitmap-only fonts (usually Type 1 PostScript) cannot be used by the 10.4Fx font renderer and are automatically ignored by the browser. A fallback font will be used in their place.
* Personas and certain custom skins may hide the "traffic light" window buttons, but they are still present and will work if hovered over or clicked on ([issue 247](https://code.google.com/p/tenfourfox/issues/detail?id=247)).
* Not all webcams are supported; in addition, multiple webcams may not all appear depending on how they are connected ([issue 221](https://code.google.com/p/tenfourfox/issues/detail?id=221)). For a list of supported webcam devices, see VideoDeviceSupport.
* 10.4Fx does not currently support WebGL, WebRTC or the webapp runtime, and scripts such as Arabic or Indic requiring glyph reordering or language-specific ligatures may not appear correctly. See TechnicalDifferences for the complete list of changes necessary for 10.4Fx. See [issue 5](https://code.google.com/p/tenfourfox/issues/detail?id=5) for notes specific to the font issue.
* Printing may crash the browser on Mac OS X Tiger Server ([issue 279](https://code.google.com/p/tenfourfox/issues/detail?id=279)). Please note that Mac OS X Server is not supported currently.
* Crash reporting is intentionally disabled to avoid polluting Mozilla's crash tracking system with our reports. Please use your system's crash logs if you are reporting a _reproducible_ crash, or (if you are able) provide a `gdb` backtrace.
* Although 10.4Fx will tell you when an update is available, you must download updates manually at this time.
You are welcome to report other bugs that you find. However, please **do not report Mozilla bugs to us.** If the bug or crash occurs in both the official Mozilla Firefox 31 _(3.6 doesn't count!)_ and in 10.4Fx, this is a Mozilla bug, and you should file it at [Bugzilla](http://bugzilla.mozilla.org/). **You must test your bug in both places -- bugs that are not confirmed to be part of 10.4Fx will be marked invalid** so that we can keep our task list focused. This is the [current list of known issues](http://code.google.com/p/tenfourfox/issues/list).

75
ReleaseNotes3140.md Normal file
View File

@ -0,0 +1,75 @@
_This document may be updated for late-breaking changes, so check back here if you are having difficulty._
## System requirements ##
TenFourFox (hereafter "10.4Fx") requires a G3 Power Macintosh, Mac OS X 10.4.11, 200MB of free disk space and 512MB of RAM. 1GB of RAM and a G4 or G5 processor is recommended. Video playback is likely to be poor on systems slower than 1.25GHz; a G5 is recommended. Mac OS X 10.5.8 is supported. Although the browser may run under Mac OS X Server, it is not currently supported.
Intel Macintoshes are not supported. Although some users have reported success getting the G3 version of 10.4Fx to run under Rosetta, certain features may not work correctly or at all on Intel Macs, and you may need to completely disable JavaScript compilation for it to work with Rosetta (see [the FAQ](AAATheFAQ.md) for more information). Because Apple no longer supports Rosetta and 10.4Fx is not a Universal binary, it will not run under Lion 10.7 or any subsequent version of Mac OS X.
## Before you upgrade from an earlier version ##
If you are upgrading from an earlier version of 10.4Fx, make sure you are using the most current versions of the QuickTimeEnabler and MacTubesEnabler if you have them installed. In addition, major addons such as Adblock should be updated before you upgrade the browser.
Some other older add-ons may not function correctly in 31.x either due to substantial changes in the browser architecture.
## Getting TenFourFox ##
Make sure you select the appropriate build for your Mac from the [download page](http://www.tenfourfox.com/). The G3 version will run on any supported Macintosh, but it will not take advantage of the additional features of G4 or G5 processors. The G4 and G5 versions will not run at all on a G3, and the G5 version will perform badly or crash on non-G5 Macintoshes.
**Starting with 24.1.0, all downloads are hosted on SourceForge due to Google Code's download restrictions.** We strongly recommend getting the most recent version directly from [the main TenFourFox website](http://www.tenfourfox.com/), but you can also browse files in the [TenFourFox SourceForge repository](https://sourceforge.net/projects/tenfourfox/files/) if you prefer.
If you are using a G4, you should try to choose the correct version for your processor generation (7400 or 7450 "G4e") as performance may be impaired if you run the wrong one. If you don't know which G4 processor you have, the instructions in WhichVersion will tell you how to find out.
## TenFourFox 31 is equivalent to Firefox 31 ##
TenFourFox uses modified Firefox source code, rewritten to remain compatible with Mac OS X v10.4 and the Power Macintosh. It also contains specific optimizations and special features for PowerPC processors. For this reason, it is not exactly the same as Firefox. However, it is intended to be as compatible with it as possible, including most add-ons and [most standard features](TechnicalDifferences.md). You can treat 10.4Fx 31 as equivalent with Firefox 31 in most circumstances, with specific exceptions noted below.
Note that add-ons which require an Intel Macintosh will not work with TenFourFox, even if they are otherwise compatible with Firefox 31, and add-ons that require 10.5 Leopard (or higher) may not be compatible with TenFourFox running on Mac OS X 10.4 Tiger, even if they are compatible with PowerPC.
## This branch of TenFourFox is the stable version ##
Starting with Firefox 10, Mozilla began offering an extended support release version of Firefox ("Firefox **ESR**") intended for environments where users are unable to use rapid-release versions of Firefox due to policy or technical constraints. This ESR is the basis of the TenFourFox **stable** branch.
The current ESR release is based on Firefox 31. 10.4Fx 31.x is based on this extended support release and is intended for users who wish to remain with a stable browser core. The stable branch will continue to receive bugfixes and security updates, but will not receive new Firefox features (although it may receive certain 10.4Fx-specific features judged important for our legacy users).
**We recommend this version for most of our users.** If you wish to help test our continuing porting efforts, you can try the _unstable_ branch, which is based on the current release of Firefox. _The unstable branch does have bugs and is recommended only for advanced users._ For more information, see the [TenFourFox Development](http://tenfourfox.blogspot.com/) blog.
## TenFourFox no longer supports plugins or Flash ##
Plugins on PowerPC are of special concern because Mozilla is making updates to their plugin architecture which may require the plugins themselves to be updated, and there are certain difficult-to-correct bugs with them already on Tiger. Most importantly, QuickTime, Java and Adobe Flash for PowerPC are no longer maintained and have known security risks that can crash, perform malicious operations or leak data, and Flash 10.1 is rapidly becoming unsupported by many applications.
**For these and other reasons (for details, see PluginsNoLongerSupported), TenFourFox does not run plugins and they cannot be enabled.** Bug reports will no longer be accepted. Sites will now act as if no plugins were installed at all. Earlier versions that allowed an undocumented plugin support mode are no longer supported.
For Internet video, we now recommend the use of TenFourFox's optional QuickTimeEnabler. This allows many videos to be handled in QuickTime Player directly.
You can also download videos for separate viewing using [Perian](http://www.perian.org/) and any of the available video download add-ons for Firefox.
For YouTube, you may also be able to use [MacTubes](http://macapps.sakura.ne.jp/mactubes/index_en.html) along with the MacTubesEnabler. If you have a high end G4 or G5, you can also use WebM for selected videos by visiting http://www.youtube.com/html5 and enabling HTML5 video. This will set a temporary cookie enabling browser-based video without Flash. You do not need a YouTube account for this feature, but you may need to periodically renew the cookie setting. Not all video is available in WebM.
For a more in-depth explanation of this policy and other workarounds, see PluginsNoLongerSupported.
## Fixed in this version of TenFourFox ##
* All security and stability patches from Firefox ESR 31.4.0.
* Background finalization is disabled for most JavaScript objects, forcing garbage collection and memory usage to occur more immediately and reducing intermittent pauses ([issue 300](https://code.google.com/p/tenfourfox/issues/detail?id=300)).
* Video, including WebM, is now more aggressively buffered before playback ([issue 302](https://code.google.com/p/tenfourfox/issues/detail?id=302)).
* Incorrect hyphenation on some pages has been corrected ([issue 293](https://code.google.com/p/tenfourfox/issues/detail?id=293), Mozilla [bug 1109972](https://code.google.com/p/tenfourfox/issues/detail?id=109972)).
* The number of tab and window undos is reduced by default to four and two respectively, lessening memory overhead and the number of compartments garbage collection must scan ([issue 295](https://code.google.com/p/tenfourfox/issues/detail?id=295)).
* A potential crash in garbage collection has been fixed in the PPCBC JavaScript JIT ([issue 299](https://code.google.com/p/tenfourfox/issues/detail?id=299)).
* A potential error in comparison operations has been fixed in the PPCBC JavaScript JIT ([issue 294](https://code.google.com/p/tenfourfox/issues/detail?id=294)).
* A potential error in exception handling has been fixed in the PPCBC JavaScript JIT ([issue 301](https://code.google.com/p/tenfourfox/issues/detail?id=301)).
## Known issues specific to TenFourFox ##
* Remember: **Plugins do not work in TenFourFox and can no longer be enabled.** See PluginsNoLongerSupported for an explanation and suggested workarounds.
* TenFourFox uses a lighter chrome for windows and dialogue boxes than prior versions or the official Mac Firefox. This is intentional.
* Systems with large numbers of fonts installed may experience intermittent pauses.
* Bitmap-only fonts (usually Type 1 PostScript) cannot be used by the 10.4Fx font renderer and are automatically ignored by the browser. A fallback font will be used in their place.
* Personas and certain custom skins may hide the "traffic light" window buttons, but they are still present and will work if hovered over or clicked on ([issue 247](https://code.google.com/p/tenfourfox/issues/detail?id=247)).
* Not all webcams are supported; in addition, multiple webcams may not all appear depending on how they are connected ([issue 221](https://code.google.com/p/tenfourfox/issues/detail?id=221)). For a list of supported webcam devices, see VideoDeviceSupport.
* 10.4Fx does not currently support WebGL, WebRTC or the webapp runtime, and scripts such as Arabic or Indic requiring glyph reordering or language-specific ligatures may not appear correctly. See TechnicalDifferences for the complete list of changes necessary for 10.4Fx. See [issue 5](https://code.google.com/p/tenfourfox/issues/detail?id=5) for notes specific to the font issue.
* Printing may crash the browser on Mac OS X Tiger Server ([issue 279](https://code.google.com/p/tenfourfox/issues/detail?id=279)). Please note that Mac OS X Server is not supported currently.
* Crash reporting is intentionally disabled to avoid polluting Mozilla's crash tracking system with our reports. Please use your system's crash logs if you are reporting a _reproducible_ crash, or (if you are able) provide a `gdb` backtrace.
* Although 10.4Fx will tell you when an update is available, you must download updates manually at this time.
You are welcome to report other bugs that you find. However, please **do not report Mozilla bugs to us.** If the bug or crash occurs in both the official Mozilla Firefox 31 _(3.6 doesn't count!)_ and in 10.4Fx, this is a Mozilla bug, and you should file it at [Bugzilla](http://bugzilla.mozilla.org/). **You must test your bug in both places -- bugs that are not confirmed to be part of 10.4Fx will be marked invalid** so that we can keep our task list focused. This is the [current list of known issues](http://code.google.com/p/tenfourfox/issues/list).

68
ReleaseNotes3150.md Normal file
View File

@ -0,0 +1,68 @@
_This document may be updated for late-breaking changes, so check back here if you are having difficulty._
## System requirements ##
TenFourFox (hereafter "10.4Fx") requires a G3 Power Macintosh, Mac OS X 10.4.11, 200MB of free disk space and 512MB of RAM. 1GB of RAM and a G4 or G5 processor is recommended. Video playback is likely to be poor on systems slower than 1.25GHz; a G5 is recommended. Mac OS X 10.5.8 is supported. Although the browser may run under Mac OS X Server, it is not currently supported.
Intel Macintoshes are not supported. Although some users have reported success getting the G3 version of 10.4Fx to run under Rosetta, certain features may not work correctly or at all on Intel Macs, and you may need to completely disable JavaScript compilation for it to work with Rosetta (see [the FAQ](AAATheFAQ.md) for more information). Because Apple no longer supports Rosetta and 10.4Fx is not a Universal binary, it will not run under Lion 10.7 or any subsequent version of Mac OS X.
## Before you upgrade from an earlier version ##
If you are upgrading from an earlier version of 10.4Fx, make sure you are using the most current versions of the QuickTimeEnabler and MacTubesEnabler if you have them installed. In addition, major addons such as Adblock should be updated before you upgrade the browser.
Some other older add-ons may not function correctly in 31.x either due to substantial changes in the browser architecture.
## Getting TenFourFox ##
Make sure you select the appropriate build for your Mac from the [download page](http://www.tenfourfox.com/). The G3 version will run on any supported Macintosh, but it will not take advantage of the additional features of G4 or G5 processors. The G4 and G5 versions will not run at all on a G3, and the G5 version will perform badly or crash on non-G5 Macintoshes.
**Starting with 24.1.0, all downloads are hosted on SourceForge due to Google Code's download restrictions.** We strongly recommend getting the most recent version directly from [the main TenFourFox website](http://www.tenfourfox.com/), but you can also browse files in the [TenFourFox SourceForge repository](https://sourceforge.net/projects/tenfourfox/files/) if you prefer.
If you are using a G4, you should try to choose the correct version for your processor generation (7400 or 7450 "G4e") as performance may be impaired if you run the wrong one. If you don't know which G4 processor you have, the instructions in WhichVersion will tell you how to find out.
## TenFourFox 31 is equivalent to Firefox 31 ##
TenFourFox uses modified Firefox source code, rewritten to remain compatible with Mac OS X v10.4 and the Power Macintosh. It also contains specific optimizations and special features for PowerPC processors. For this reason, it is not exactly the same as Firefox. However, it is intended to be as compatible with it as possible, including most add-ons and [most standard features](TechnicalDifferences.md). You can treat 10.4Fx 31 as equivalent with Firefox 31 in most circumstances, with specific exceptions noted below.
Note that add-ons which require an Intel Macintosh will not work with TenFourFox, even if they are otherwise compatible with Firefox 31, and add-ons that require 10.5 Leopard (or higher) may not be compatible with TenFourFox running on Mac OS X 10.4 Tiger, even if they are compatible with PowerPC.
## This branch of TenFourFox is the stable version ##
Starting with Firefox 10, Mozilla began offering an extended support release version of Firefox ("Firefox **ESR**") intended for environments where users are unable to use rapid-release versions of Firefox due to policy or technical constraints. This ESR is the basis of the TenFourFox **stable** branch.
The current ESR release is based on Firefox 31. 10.4Fx 31.x is based on this extended support release and is intended for users who wish to remain with a stable browser core. The stable branch will continue to receive bugfixes and security updates, but will not receive new Firefox features (although it may receive certain 10.4Fx-specific features judged important for our legacy users).
**We recommend this version for most of our users.** If you wish to help test our continuing porting efforts, you can try the _unstable_ branch, which is based on the current release of Firefox. _The unstable branch does have bugs and is recommended only for advanced users._ For more information, see the [TenFourFox Development](http://tenfourfox.blogspot.com/) blog.
## TenFourFox no longer supports plugins or Flash ##
Plugins on PowerPC are of special concern because Mozilla is making updates to their plugin architecture which may require the plugins themselves to be updated, and there are certain difficult-to-correct bugs with them already on Tiger. Most importantly, QuickTime, Java and Adobe Flash for PowerPC are no longer maintained and have known security risks that can crash, perform malicious operations or leak data, and Flash 10.1 is rapidly becoming unsupported by many applications.
**For these and other reasons (for details, see PluginsNoLongerSupported), TenFourFox does not run plugins and they cannot be enabled.** Bug reports will no longer be accepted. Sites will now act as if no plugins were installed at all. Earlier versions that allowed an undocumented plugin support mode are no longer supported.
For Internet video, we now recommend the use of TenFourFox's optional QuickTimeEnabler. This allows many videos to be handled in QuickTime Player directly.
You can also download videos for separate viewing using [Perian](http://www.perian.org/) and any of the available video download add-ons for Firefox.
For YouTube, you may also be able to use [MacTubes](http://macapps.sakura.ne.jp/mactubes/index_en.html) along with the MacTubesEnabler. If you have a high end G4 or G5, you can also use WebM for selected videos by visiting http://www.youtube.com/html5 and enabling HTML5 video. This will set a temporary cookie enabling browser-based video without Flash. You do not need a YouTube account for this feature, but you may need to periodically renew the cookie setting. Not all video is available in WebM.
For a more in-depth explanation of this policy and other workarounds, see PluginsNoLongerSupported.
## Fixed in this version of TenFourFox ##
* All security and stability patches from Firefox ESR 31.5.0.
## Known issues specific to TenFourFox ##
* Remember: **Plugins do not work in TenFourFox and can no longer be enabled.** See PluginsNoLongerSupported for an explanation and suggested workarounds.
* TenFourFox uses a lighter chrome for windows and dialogue boxes than prior versions or the official Mac Firefox. This is intentional.
* Systems with large numbers of fonts installed may experience intermittent pauses.
* Bitmap-only fonts (usually Type 1 PostScript) cannot be used by the 10.4Fx font renderer and are automatically ignored by the browser. A fallback font will be used in their place.
* Personas and certain custom skins may hide the "traffic light" window buttons, but they are still present and will work if hovered over or clicked on ([issue 247](https://code.google.com/p/tenfourfox/issues/detail?id=247)).
* Not all webcams are supported; in addition, multiple webcams may not all appear depending on how they are connected ([issue 221](https://code.google.com/p/tenfourfox/issues/detail?id=221)). For a list of supported webcam devices, see VideoDeviceSupport.
* 10.4Fx does not currently support WebGL, WebRTC or the webapp runtime, and scripts such as Arabic or Indic requiring glyph reordering or language-specific ligatures may not appear correctly. See TechnicalDifferences for the complete list of changes necessary for 10.4Fx. See [issue 5](https://code.google.com/p/tenfourfox/issues/detail?id=5) for notes specific to the font issue.
* Printing may crash the browser on Mac OS X Tiger Server ([issue 279](https://code.google.com/p/tenfourfox/issues/detail?id=279)). Please note that Mac OS X Server is not supported currently.
* Crash reporting is intentionally disabled to avoid polluting Mozilla's crash tracking system with our reports. Please use your system's crash logs if you are reporting a _reproducible_ crash, or (if you are able) provide a `gdb` backtrace.
* Although 10.4Fx will tell you when an update is available, you must download updates manually at this time.
You are welcome to report other bugs that you find. However, please **do not report Mozilla bugs to us.** If the bug or crash occurs in both the official Mozilla Firefox 31 _(3.6 doesn't count!)_ and in 10.4Fx, this is a Mozilla bug, and you should file it at [Bugzilla](http://bugzilla.mozilla.org/). **You must test your bug in both places -- bugs that are not confirmed to be part of 10.4Fx will be marked invalid** so that we can keep our task list focused. This is the [current list of known issues](http://code.google.com/p/tenfourfox/issues/list).

68
ReleaseNotes3160.md Normal file
View File

@ -0,0 +1,68 @@
_This document may be updated for late-breaking changes, so check back here if you are having difficulty._
## System requirements ##
TenFourFox (hereafter "10.4Fx") requires a G3 Power Macintosh, Mac OS X 10.4.11, 200MB of free disk space and 512MB of RAM. 1GB of RAM and a G4 or G5 processor is recommended. Video playback is likely to be poor on systems slower than 1.25GHz; a G5 is recommended. Mac OS X 10.5.8 is supported. Although the browser may run under Mac OS X Server, it is not currently supported.
Intel Macintoshes are not supported. Although some users have reported success getting the G3 version of 10.4Fx to run under Rosetta, certain features may not work correctly or at all on Intel Macs, and you may need to completely disable JavaScript compilation for it to work with Rosetta (see [the FAQ](AAATheFAQ.md) for more information). Because Apple no longer supports Rosetta and 10.4Fx is not a Universal binary, it will not run under Lion 10.7 or any subsequent version of Mac OS X.
## Before you upgrade from an earlier version ##
If you are upgrading from an earlier version of 10.4Fx, make sure you are using the most current versions of the QuickTimeEnabler and MacTubesEnabler if you have them installed. In addition, major addons such as Adblock should be updated before you upgrade the browser.
Some other older add-ons may not function correctly in 31.x either due to substantial changes in the browser architecture.
## Getting TenFourFox ##
Make sure you select the appropriate build for your Mac from the [download page](http://www.tenfourfox.com/). The G3 version will run on any supported Macintosh, but it will not take advantage of the additional features of G4 or G5 processors. The G4 and G5 versions will not run at all on a G3, and the G5 version will perform badly or crash on non-G5 Macintoshes.
**Starting with 24.1.0, all downloads are hosted on SourceForge due to Google Code's download restrictions.** We strongly recommend getting the most recent version directly from [the main TenFourFox website](http://www.tenfourfox.com/), but you can also browse files in the [TenFourFox SourceForge repository](https://sourceforge.net/projects/tenfourfox/files/) if you prefer.
If you are using a G4, you should try to choose the correct version for your processor generation (7400 or 7450 "G4e") as performance may be impaired if you run the wrong one. If you don't know which G4 processor you have, the instructions in WhichVersion will tell you how to find out.
## TenFourFox 31 is equivalent to Firefox 31 ##
TenFourFox uses modified Firefox source code, rewritten to remain compatible with Mac OS X v10.4 and the Power Macintosh. It also contains specific optimizations and special features for PowerPC processors. For this reason, it is not exactly the same as Firefox. However, it is intended to be as compatible with it as possible, including most add-ons and [most standard features](TechnicalDifferences.md). You can treat 10.4Fx 31 as equivalent with Firefox 31 in most circumstances, with specific exceptions noted below.
Note that add-ons which require an Intel Macintosh will not work with TenFourFox, even if they are otherwise compatible with Firefox 31, and add-ons that require 10.5 Leopard (or higher) may not be compatible with TenFourFox running on Mac OS X 10.4 Tiger, even if they are compatible with PowerPC.
## This branch of TenFourFox is the stable version ##
Starting with Firefox 10, Mozilla began offering an extended support release version of Firefox ("Firefox **ESR**") intended for environments where users are unable to use rapid-release versions of Firefox due to policy or technical constraints. This ESR is the basis of the TenFourFox **stable** branch.
The current ESR release is based on Firefox 31. 10.4Fx 31.x is based on this extended support release and is intended for users who wish to remain with a stable browser core. The stable branch will continue to receive bugfixes and security updates, but will not receive new Firefox features (although it may receive certain 10.4Fx-specific features judged important for our legacy users).
**We recommend this version for most of our users.** If you wish to help test our continuing porting efforts, you can try the _unstable_ branch, which is based on the current release of Firefox. _The unstable branch does have bugs and is recommended only for advanced users._ For more information, see the [TenFourFox Development](http://tenfourfox.blogspot.com/) blog.
## TenFourFox no longer supports plugins or Flash ##
Plugins on PowerPC are of special concern because Mozilla is making updates to their plugin architecture which may require the plugins themselves to be updated, and there are certain difficult-to-correct bugs with them already on Tiger. Most importantly, QuickTime, Java and Adobe Flash for PowerPC are no longer maintained and have known security risks that can crash, perform malicious operations or leak data, and Flash 10.1 is rapidly becoming unsupported by many applications.
**For these and other reasons (for details, see PluginsNoLongerSupported), TenFourFox does not run plugins and they cannot be enabled.** Bug reports will no longer be accepted. Sites will now act as if no plugins were installed at all. Earlier versions that allowed an undocumented plugin support mode are no longer supported.
For Internet video, we now recommend the use of TenFourFox's optional QuickTimeEnabler. This allows many videos to be handled in QuickTime Player directly.
You can also download videos for separate viewing using [Perian](http://www.perian.org/) and any of the available video download add-ons for Firefox.
For YouTube, you may also be able to use [MacTubes](http://macapps.sakura.ne.jp/mactubes/index_en.html) along with the MacTubesEnabler. If you have a high end G4 or G5, you can also use WebM for selected videos by visiting http://www.youtube.com/html5 and enabling HTML5 video. This will set a temporary cookie enabling browser-based video without Flash. You do not need a YouTube account for this feature, but you may need to periodically renew the cookie setting. Not all video is available in WebM.
For a more in-depth explanation of this policy and other workarounds, see PluginsNoLongerSupported.
## Fixed in this version of TenFourFox ##
* All security and stability patches from Firefox ESR 31.6.0.
## Known issues specific to TenFourFox ##
* Remember: **Plugins do not work in TenFourFox and can no longer be enabled.** See PluginsNoLongerSupported for an explanation and suggested workarounds.
* TenFourFox uses a lighter chrome for windows and dialogue boxes than prior versions or the official Mac Firefox. This is intentional.
* Systems with large numbers of fonts installed may experience intermittent pauses.
* Bitmap-only fonts (usually Type 1 PostScript) cannot be used by the 10.4Fx font renderer and are automatically ignored by the browser. A fallback font will be used in their place.
* Personas and certain custom skins may hide the "traffic light" window buttons, but they are still present and will work if hovered over or clicked on ([issue 247](https://code.google.com/p/tenfourfox/issues/detail?id=247)).
* Not all webcams are supported; in addition, multiple webcams may not all appear depending on how they are connected ([issue 221](https://code.google.com/p/tenfourfox/issues/detail?id=221)). For a list of supported webcam devices, see VideoDeviceSupport.
* 10.4Fx does not currently support WebGL, WebRTC or the webapp runtime, and scripts such as Arabic or Indic requiring glyph reordering or language-specific ligatures may not appear correctly. See TechnicalDifferences for the complete list of changes necessary for 10.4Fx. See [issue 5](https://code.google.com/p/tenfourfox/issues/detail?id=5) for notes specific to the font issue.
* Printing may crash the browser on Mac OS X Tiger Server ([issue 279](https://code.google.com/p/tenfourfox/issues/detail?id=279)). Please note that Mac OS X Server is not supported currently.
* Crash reporting is intentionally disabled to avoid polluting Mozilla's crash tracking system with our reports. Please use your system's crash logs if you are reporting a _reproducible_ crash, or (if you are able) provide a `gdb` backtrace.
* Although 10.4Fx will tell you when an update is available, you must download updates manually at this time.
You are welcome to report other bugs that you find. However, please **do not report Mozilla bugs to us.** If the bug or crash occurs in both the official Mozilla Firefox 31 _(3.6 doesn't count!)_ and in 10.4Fx, this is a Mozilla bug, and you should file it at [Bugzilla](http://bugzilla.mozilla.org/). **You must test your bug in both places -- bugs that are not confirmed to be part of 10.4Fx will be marked invalid** so that we can keep our task list focused. This is the [current list of known issues](http://code.google.com/p/tenfourfox/issues/list).

68
ReleaseNotes3170.md Normal file
View File

@ -0,0 +1,68 @@
_This document may be updated for late-breaking changes, so check back here if you are having difficulty._
## System requirements ##
TenFourFox (hereafter "10.4Fx") requires a G3 Power Macintosh, Mac OS X 10.4.11, 200MB of free disk space and 512MB of RAM. 1GB of RAM and a G4 or G5 processor is recommended. Video playback is likely to be poor on systems slower than 1.25GHz; a G5 is recommended. Mac OS X 10.5.8 is supported. Although the browser may run under Mac OS X Server, it is not currently supported.
Intel Macintoshes are not supported. Although some users have reported success getting the G3 version of 10.4Fx to run under Rosetta, certain features may not work correctly or at all on Intel Macs, and you may need to completely disable JavaScript compilation for it to work with Rosetta (see [the FAQ](AAATheFAQ.md) for more information). Because Apple no longer supports Rosetta and 10.4Fx is not a Universal binary, it will not run under Lion 10.7 or any subsequent version of Mac OS X.
## Before you upgrade from an earlier version ##
If you are upgrading from an earlier version of 10.4Fx, make sure you are using the most current versions of the QuickTimeEnabler and MacTubesEnabler if you have them installed. In addition, major addons such as Adblock should be updated before you upgrade the browser.
Some other older add-ons may not function correctly in 31.x either due to substantial changes in the browser architecture.
## Getting TenFourFox ##
Make sure you select the appropriate build for your Mac from the [download page](http://www.tenfourfox.com/). The G3 version will run on any supported Macintosh, but it will not take advantage of the additional features of G4 or G5 processors. The G4 and G5 versions will not run at all on a G3, and the G5 version will perform badly or crash on non-G5 Macintoshes.
**Starting with 24.1.0, all downloads are hosted on SourceForge due to Google Code's download restrictions.** We strongly recommend getting the most recent version directly from [the main TenFourFox website](http://www.tenfourfox.com/), but you can also browse files in the [TenFourFox SourceForge repository](https://sourceforge.net/projects/tenfourfox/files/) if you prefer.
If you are using a G4, you should try to choose the correct version for your processor generation (7400 or 7450 "G4e") as performance may be impaired if you run the wrong one. If you don't know which G4 processor you have, the instructions in WhichVersion will tell you how to find out.
## TenFourFox 31 is equivalent to Firefox 31 ##
TenFourFox uses modified Firefox source code, rewritten to remain compatible with Mac OS X v10.4 and the Power Macintosh. It also contains specific optimizations and special features for PowerPC processors. For this reason, it is not exactly the same as Firefox. However, it is intended to be as compatible with it as possible, including most add-ons and [most standard features](TechnicalDifferences.md). You can treat 10.4Fx 31 as equivalent with Firefox 31 in most circumstances, with specific exceptions noted below.
Note that add-ons which require an Intel Macintosh will not work with TenFourFox, even if they are otherwise compatible with Firefox 31, and add-ons that require 10.5 Leopard (or higher) may not be compatible with TenFourFox running on Mac OS X 10.4 Tiger, even if they are compatible with PowerPC.
## This branch of TenFourFox is the stable version ##
Starting with Firefox 10, Mozilla began offering an extended support release version of Firefox ("Firefox **ESR**") intended for environments where users are unable to use rapid-release versions of Firefox due to policy or technical constraints. This ESR is the basis of the TenFourFox **stable** branch.
The current ESR release is based on Firefox 31. 10.4Fx 31.x is based on this extended support release and is intended for users who wish to remain with a stable browser core. The stable branch will continue to receive bugfixes and security updates, but will not receive new Firefox features (although it may receive certain 10.4Fx-specific features judged important for our legacy users).
**We recommend this version for most of our users.** If you wish to help test our continuing porting efforts, you can try the _unstable_ branch, which is based on the current release of Firefox. _The unstable branch does have bugs and is recommended only for advanced users._ For more information, see the [TenFourFox Development](http://tenfourfox.blogspot.com/) blog.
## TenFourFox no longer supports plugins or Flash ##
Plugins on PowerPC are of special concern because Mozilla is making updates to their plugin architecture which may require the plugins themselves to be updated, and there are certain difficult-to-correct bugs with them already on Tiger. Most importantly, QuickTime, Java and Adobe Flash for PowerPC are no longer maintained and have known security risks that can crash, perform malicious operations or leak data, and Flash 10.1 is rapidly becoming unsupported by many applications.
**For these and other reasons (for details, see PluginsNoLongerSupported), TenFourFox does not run plugins and they cannot be enabled.** Bug reports will no longer be accepted. Sites will now act as if no plugins were installed at all. Earlier versions that allowed an undocumented plugin support mode are no longer supported.
For Internet video, we now recommend the use of TenFourFox's optional QuickTimeEnabler. This allows many videos to be handled in QuickTime Player directly.
You can also download videos for separate viewing using [Perian](http://www.perian.org/) and any of the available video download add-ons for Firefox.
For YouTube, you may also be able to use [MacTubes](http://macapps.sakura.ne.jp/mactubes/index_en.html) along with the MacTubesEnabler. If you have a high end G4 or G5, you can also use WebM for selected videos by visiting http://www.youtube.com/html5 and enabling HTML5 video. This will set a temporary cookie enabling browser-based video without Flash. You do not need a YouTube account for this feature, but you may need to periodically renew the cookie setting. Not all video is available in WebM.
For a more in-depth explanation of this policy and other workarounds, see PluginsNoLongerSupported.
## Fixed in this version of TenFourFox ##
* All security and stability patches from Firefox ESR 31.7.0.
## Known issues specific to TenFourFox ##
* Remember: **Plugins do not work in TenFourFox and can no longer be enabled.** See PluginsNoLongerSupported for an explanation and suggested workarounds.
* TenFourFox uses a lighter chrome for windows and dialogue boxes than prior versions or the official Mac Firefox. This is intentional.
* Systems with large numbers of fonts installed may experience intermittent pauses.
* Bitmap-only fonts (usually Type 1 PostScript) cannot be used by the 10.4Fx font renderer and are automatically ignored by the browser. A fallback font will be used in their place.
* Personas and certain custom skins may hide the "traffic light" window buttons, but they are still present and will work if hovered over or clicked on ([issue 247](https://code.google.com/p/tenfourfox/issues/detail?id=247)).
* Not all webcams are supported; in addition, multiple webcams may not all appear depending on how they are connected ([issue 221](https://code.google.com/p/tenfourfox/issues/detail?id=221)). For a list of supported webcam devices, see VideoDeviceSupport.
* 10.4Fx does not currently support WebGL, WebRTC or the webapp runtime, and scripts such as Arabic or Indic requiring glyph reordering or language-specific ligatures may not appear correctly. See TechnicalDifferences for the complete list of changes necessary for 10.4Fx. See [issue 5](https://code.google.com/p/tenfourfox/issues/detail?id=5) for notes specific to the font issue.
* Printing may crash the browser on Mac OS X Tiger Server ([issue 279](https://code.google.com/p/tenfourfox/issues/detail?id=279)). Please note that Mac OS X Server is not supported currently.
* Crash reporting is intentionally disabled to avoid polluting Mozilla's crash tracking system with our reports. Please use your system's crash logs if you are reporting a _reproducible_ crash, or (if you are able) provide a `gdb` backtrace.
* Although 10.4Fx will tell you when an update is available, you must download updates manually at this time.
You are welcome to report other bugs that you find. However, please **do not report Mozilla bugs to us.** If the bug or crash occurs in both the official Mozilla Firefox 31 _(3.6 doesn't count!)_ and in 10.4Fx, this is a Mozilla bug, and you should file it at [Bugzilla](http://bugzilla.mozilla.org/). **You must test your bug in both places -- bugs that are not confirmed to be part of 10.4Fx will be marked invalid** so that we can keep our task list focused. This is the [current list of known issues](http://code.google.com/p/tenfourfox/issues/list).

64
ReleaseNotes3180.md Normal file
View File

@ -0,0 +1,64 @@
_This document may be updated for late-breaking changes, so check back here if you are having difficulty._
## System requirements ##
TenFourFox (hereafter "10.4Fx") requires a G3 Power Macintosh, Mac OS X 10.4.11, 200MB of free disk space and 512MB of RAM. 1GB of RAM and a G4 or G5 processor is recommended. Video playback is likely to be poor on systems slower than 1.25GHz; a G5 is recommended. Mac OS X 10.5.8 is supported. Although the browser may run under Mac OS X Server, it is not currently supported.
Intel Macintoshes are not supported. Although some users have reported success getting the G3 version of 10.4Fx to run under Rosetta, certain features may not work correctly or at all on Intel Macs, and you may need to completely disable JavaScript compilation for it to work with Rosetta (see [the FAQ](AAATheFAQ.md) for more information). Because Apple no longer supports Rosetta and 10.4Fx is not a Universal binary, it will not run under Lion 10.7 or any subsequent version of Mac OS X.
**This will be the final release of TenFourFox 31. Subsequent versions will be based on TenFourFox 38.**
## Getting TenFourFox ##
Make sure you select the appropriate build for your Mac from the [download page](http://www.tenfourfox.com/). The G3 version will run on any supported Macintosh, but it will not take advantage of the additional features of G4 or G5 processors. The G4 and G5 versions will not run at all on a G3, and the G5 version will perform badly or crash on non-G5 Macintoshes.
**Starting with 24.1.0, all downloads are hosted on SourceForge due to Google Code's download restrictions.** We strongly recommend getting the most recent version directly from [the main TenFourFox website](http://www.tenfourfox.com/), but you can also browse files in the [TenFourFox SourceForge repository](https://sourceforge.net/projects/tenfourfox/files/) if you prefer.
If you are using a G4, you should try to choose the correct version for your processor generation (7400 or 7450 "G4e") as performance may be impaired if you run the wrong one. If you don't know which G4 processor you have, the instructions in WhichVersion will tell you how to find out.
## TenFourFox 31 is equivalent to Firefox 31 ##
TenFourFox uses modified Firefox source code, rewritten to remain compatible with Mac OS X v10.4 and the Power Macintosh. It also contains specific optimizations and special features for PowerPC processors. For this reason, it is not exactly the same as Firefox. However, it is intended to be as compatible with it as possible, including most add-ons and [most standard features](TechnicalDifferences.md). You can treat 10.4Fx 31 as equivalent with Firefox 31 in most circumstances, with specific exceptions noted below.
Note that add-ons which require an Intel Macintosh will not work with TenFourFox, even if they are otherwise compatible with Firefox 31, and add-ons that require 10.5 Leopard (or higher) may not be compatible with TenFourFox running on Mac OS X 10.4 Tiger, even if they are compatible with PowerPC.
## This branch of TenFourFox is the stable version ##
Starting with Firefox 10, Mozilla began offering an extended support release version of Firefox ("Firefox **ESR**") intended for environments where users are unable to use rapid-release versions of Firefox due to policy or technical constraints. This ESR is the basis of the TenFourFox **stable** branch.
The current ESR release is based on Firefox 31. 10.4Fx 31.x is based on this extended support release and is intended for users who wish to remain with a stable browser core. The stable branch will continue to receive bugfixes and security updates, but will not receive new Firefox features (although it may receive certain 10.4Fx-specific features judged important for our legacy users).
**We recommend this version for most of our users.** If you wish to help test our continuing porting efforts, you can try the _unstable_ branch, which is based on the current release of Firefox. _The unstable branch does have bugs and is recommended only for advanced users._ For more information, see the [TenFourFox Development](http://tenfourfox.blogspot.com/) blog.
## TenFourFox no longer supports plugins or Flash ##
Plugins on PowerPC are of special concern because Mozilla is making updates to their plugin architecture which may require the plugins themselves to be updated, and there are certain difficult-to-correct bugs with them already on Tiger. Most importantly, QuickTime, Java and Adobe Flash for PowerPC are no longer maintained and have known security risks that can crash, perform malicious operations or leak data, and Flash 10.1 is rapidly becoming unsupported by many applications.
**For these and other reasons (for details, see PluginsNoLongerSupported), TenFourFox does not run plugins and they cannot be enabled.** Bug reports will no longer be accepted. Sites will now act as if no plugins were installed at all. Earlier versions that allowed an undocumented plugin support mode are no longer supported.
For Internet video, we now recommend the use of TenFourFox's optional QuickTimeEnabler. This allows many videos to be handled in QuickTime Player directly.
You can also download videos for separate viewing using [Perian](http://www.perian.org/) and any of the available video download add-ons for Firefox.
For YouTube, you may also be able to use [MacTubes](http://macapps.sakura.ne.jp/mactubes/index_en.html) along with the MacTubesEnabler. If you have a high end G4 or G5, you can also use WebM for selected videos by visiting http://www.youtube.com/html5 and enabling HTML5 video. This will set a temporary cookie enabling browser-based video without Flash. You do not need a YouTube account for this feature, but you may need to periodically renew the cookie setting. Not all video is available in WebM.
For a more in-depth explanation of this policy and other workarounds, see PluginsNoLongerSupported.
## Fixed in this version of TenFourFox ##
* All security and stability patches from Firefox ESR 31.8.0.
## Known issues specific to TenFourFox ##
* Remember: **Plugins do not work in TenFourFox and can no longer be enabled.** See PluginsNoLongerSupported for an explanation and suggested workarounds.
* TenFourFox uses a lighter chrome for windows and dialogue boxes than prior versions or the official Mac Firefox. This is intentional.
* Systems with large numbers of fonts installed may experience intermittent pauses.
* Bitmap-only fonts (usually Type 1 PostScript) cannot be used by the 10.4Fx font renderer and are automatically ignored by the browser. A fallback font will be used in their place.
* Personas and certain custom skins may hide the "traffic light" window buttons, but they are still present and will work if hovered over or clicked on ([issue 247](https://code.google.com/p/tenfourfox/issues/detail?id=247)).
* Not all webcams are supported; in addition, multiple webcams may not all appear depending on how they are connected ([issue 221](https://code.google.com/p/tenfourfox/issues/detail?id=221)). For a list of supported webcam devices, see VideoDeviceSupport.
* 10.4Fx does not currently support WebGL, WebRTC or the webapp runtime, and scripts such as Arabic or Indic requiring glyph reordering or language-specific ligatures may not appear correctly. See TechnicalDifferences for the complete list of changes necessary for 10.4Fx. See [issue 5](https://code.google.com/p/tenfourfox/issues/detail?id=5) for notes specific to the font issue.
* Printing may crash the browser on Mac OS X Tiger Server ([issue 279](https://code.google.com/p/tenfourfox/issues/detail?id=279)). Please note that Mac OS X Server is not supported currently.
* Crash reporting is intentionally disabled to avoid polluting Mozilla's crash tracking system with our reports. Please use your system's crash logs if you are reporting a _reproducible_ crash, or (if you are able) provide a `gdb` backtrace.
* Although 10.4Fx will tell you when an update is available, you must download updates manually at this time.
You are welcome to report other bugs that you find. However, please **do not report Mozilla bugs to us.** If the bug or crash occurs in both the official Mozilla Firefox 31 _(3.6 doesn't count!)_ and in 10.4Fx, this is a Mozilla bug, and you should file it at [Bugzilla](http://bugzilla.mozilla.org/). **You must test your bug in both places -- bugs that are not confirmed to be part of 10.4Fx will be marked invalid** so that we can keep our task list focused. This is the [current list of known issues](http://code.google.com/p/tenfourfox/issues/list).

70
ReleaseNotes3801.md Normal file
View File

@ -0,0 +1,70 @@
**This is for a beta release of TenFourFox and will be updated as new beta versions are posted, so check back here if you are having difficulty. If you want the regular version, _do not use_ this beta: it has known bugs. Please use version 31 in the meantime.**
## System requirements ##
TenFourFox (hereafter "10.4Fx") requires a G3 Power Macintosh, Mac OS X 10.4.11, 200MB of free disk space and 512MB of RAM. 1GB of RAM and a G4 or G5 processor is recommended. Video playback is likely to be poor on systems slower than 1.25GHz; a G5 is recommended. Mac OS X 10.5.8 is supported. Although the browser may run under Mac OS X Server, it is not currently supported.
Intel Macintoshes are not supported. Although some users have reported success getting the G3 version of 10.4Fx to run under Rosetta, certain features may not work correctly or at all on Intel Macs, and you may need to completely disable JavaScript compilation for it to work with Rosetta (see [the FAQ](AAATheFAQ.md) for more information). Because Apple no longer supports Rosetta and 10.4Fx is not a Universal binary, it will not run under Lion 10.7 or any subsequent version of Mac OS X.
## Getting TenFourFox ##
Make sure you select the appropriate build for your Mac from the [download page](http://www.tenfourfox.com/). The G3 version will run on any supported Macintosh, but it will not take advantage of the additional features of G4 or G5 processors. The G4 and G5 versions will not run at all on a G3, and the G5 version will perform badly or crash on non-G5 Macintoshes.
**Starting with 24.1.0, all downloads are hosted on SourceForge due to Google Code's download restrictions.** We strongly recommend getting the most recent version directly from [the main TenFourFox website](http://www.tenfourfox.com/), but you can also browse files in the [TenFourFox SourceForge repository](https://sourceforge.net/projects/tenfourfox/files/) if you prefer.
If you are using a G4, you should try to choose the correct version for your processor generation (7400 or 7450 "G4e") as performance may be impaired if you run the wrong one. If you don't know which G4 processor you have, the instructions in WhichVersion will tell you how to find out.
## TenFourFox 38 is equivalent to Firefox 38 ##
TenFourFox uses modified Firefox source code, rewritten to remain compatible with Mac OS X v10.4 and the Power Macintosh. It also contains specific optimizations and special features for PowerPC processors. For this reason, it is not exactly the same as Firefox. However, it is intended to be as compatible with it as possible, including most add-ons and [most standard features](TechnicalDifferences.md). You can treat 10.4Fx 38 as equivalent with Firefox 38 in most circumstances, with specific exceptions noted below.
Note that add-ons which require an Intel Macintosh will not work with TenFourFox, even if they are otherwise compatible with Firefox 38, and add-ons that require 10.5 Leopard (or higher) may not be compatible with TenFourFox running on Mac OS X 10.4 Tiger, even if they are compatible with PowerPC.
## This branch of TenFourFox is the _new_ stable version ##
Starting with Firefox 10, Mozilla began offering an extended support release version of Firefox ("Firefox **ESR**") intended for environments where users are unable to use rapid-release versions of Firefox due to policy or technical constraints. This ESR is the basis of the TenFourFox **stable** branch.
The current ESR release is based on Firefox 38. 10.4Fx 38.x is based on this extended support release and is intended for users who wish to remain with a stable browser core. The stable branch will continue to receive bugfixes and security updates, but will not receive new Firefox features (although it may receive certain 10.4Fx-specific features judged important for our legacy users).
**We recommend this version for most of our users.** If you wish to help test our continuing porting efforts, you can try the _unstable_ branch, which is based on the current release of Firefox. _The unstable branch does have bugs and is recommended only for advanced users._ For more information, see the [TenFourFox Development](http://tenfourfox.blogspot.com/) blog.
## TenFourFox no longer supports plugins or Flash ##
Plugins on PowerPC are of special concern because Mozilla is making updates to their plugin architecture which may require the plugins themselves to be updated, and there are certain difficult-to-correct bugs with them already on Tiger. Most importantly, QuickTime, Java and Adobe Flash for PowerPC are no longer maintained and have known security risks that can crash, perform malicious operations or leak data, and Flash 10.1 is rapidly becoming unsupported by many applications.
**For these and other reasons (for details, see PluginsNoLongerSupported), TenFourFox does not run plugins and they cannot be enabled.** Bug reports will no longer be accepted. Sites will now act as if no plugins were installed at all. Earlier versions that allowed an undocumented plugin support mode are no longer supported.
For Internet video, we now recommend the use of TenFourFox's optional QuickTimeEnabler. This allows many videos to be handled in QuickTime Player directly.
You can also download videos for separate viewing using [Perian](http://www.perian.org/) and any of the available video download add-ons for Firefox.
If you have a high end G4 or G5, you can also use WebM for selected videos by visiting http://www.youtube.com/html5 and enabling HTML5 video. This will set a temporary cookie enabling browser-based video without Flash. You do not need a YouTube account for this feature, but you may need to periodically renew the cookie setting. Not all video is available in WebM.
For a more in-depth explanation of this policy and other workarounds, see PluginsNoLongerSupported.
## New in this version of TenFourFox ##
* All standard supported features of Firefox 38, including in-browser PDF viewing, Reader View for simplified and faster loading pages, in-content preferences, enhanced memory management and garbage collection, and multiple improvements to HTML5/CSS performance and compatibility.
* The new IonPower JavaScript backend accelerates JavaScript operations by eleven times over version 31 ([issue 178](https://code.google.com/p/tenfourfox/issues/detail?id=178)).
* Local font attributes are now cached more aggressively, improving text rendering performance.
## Known bugs in this beta version ##
* Traffic light buttons appear misplaced on private browsing windows when the title bar is on. They function correctly; the bug is cosmetic only.
## Known issues specific to TenFourFox ##
* Remember: **Plugins do not work in TenFourFox and can no longer be enabled.** See PluginsNoLongerSupported for an explanation and suggested workarounds.
* Starting in version 38, the `Check for Updates` menu option is now under the Help menu, as in the official Mac Firefox.
* Starting in version 38, the new tab page is always blank.
* Starting in version 38, the default search provider is now Yahoo, not Google. You can change it back from the preferences page.
* TenFourFox intentionally uses a lighter chrome for windows and dialogue boxes than prior versions or the official Mac Firefox.
* Bitmap-only fonts (usually Type 1 PostScript) cannot be used by the 10.4Fx font renderer and are automatically ignored by the browser. A fallback font will be used in their place.
* Personas and certain custom skins may hide the "traffic light" window buttons, but they are still present and will work if hovered over or clicked on ([issue 247](https://code.google.com/p/tenfourfox/issues/detail?id=247)).
* Not all webcams are supported; in addition, multiple webcams may not all appear depending on how they are connected ([issue 221](https://code.google.com/p/tenfourfox/issues/detail?id=221)). For a list of supported webcam devices, see VideoDeviceSupport.
* 10.4Fx does not currently support WebGL, WebRTC or the webapp runtime, and scripts such as Arabic or Indic requiring glyph reordering or language-specific ligatures may not appear correctly without OpenType fonts. See TechnicalDifferences for the complete list of changes necessary for 10.4Fx. See [issue 5](https://code.google.com/p/tenfourfox/issues/detail?id=5) for notes specific to the font issue.
* Printing may crash the browser on Mac OS X Tiger Server ([issue 279](https://code.google.com/p/tenfourfox/issues/detail?id=279)). Please note that Mac OS X Server is not supported currently.
* Crash reporting is intentionally disabled to avoid polluting Mozilla's crash tracking system with our reports. Please use your system's crash logs if you are reporting a _reproducible_ crash, or (if you are able) provide a `gdb` backtrace.
* Although 10.4Fx will tell you when an update is available, you must download updates manually at this time.
You are welcome to report other bugs that you find. However, please **do not report Mozilla bugs to us.** If the bug or crash occurs in both the official Mozilla Firefox 38 _(3.6 doesn't count!)_ and in 10.4Fx, this is a Mozilla bug, and you should file it at [Bugzilla](http://bugzilla.mozilla.org/). **You must test your bug in both places -- bugs that are not confirmed to be part of 10.4Fx will be marked invalid** so that we can keep our task list focused. This is the [current list of known issues](http://code.google.com/p/tenfourfox/issues/list).

77
ReleaseNotes3811.md Normal file
View File

@ -0,0 +1,77 @@
**This is for a beta release of TenFourFox and will be updated as new beta versions are posted, so check back here if you are having difficulty. If you want the regular version, _do not use_ this beta: it may have additional bugs. Please use version 31 in the meantime.**
## System requirements ##
TenFourFox (hereafter "10.4Fx") requires a G3 Power Macintosh, Mac OS X 10.4.11, 200MB of free disk space and 512MB of RAM. 1GB of RAM and a G4 or G5 processor is recommended. Video playback is likely to be poor on systems slower than 1.25GHz; a G5 is recommended. Mac OS X 10.5.8 is supported. Although the browser may run under Mac OS X Server, it is not currently supported.
Intel Macintoshes are not supported. Although some users have reported success getting the G3 version of 10.4Fx to run under Rosetta, certain features may not work correctly or at all on Intel Macs, and you may need to completely disable JavaScript compilation for it to work with Rosetta (see [the FAQ](AAATheFAQ.md) for more information). Because Apple no longer supports Rosetta and 10.4Fx is not a Universal binary, it will not run under Lion 10.7 or any subsequent version of Mac OS X.
## Getting TenFourFox ##
Make sure you select the appropriate build for your Mac from the [download page](http://www.tenfourfox.com/). The G3 version will run on any supported Macintosh, but it will not take advantage of the additional features of G4 or G5 processors. The G4 and G5 versions will not run at all on a G3, and the G5 version will perform badly or crash on non-G5 Macintoshes.
**Starting with 24.1.0, all downloads are hosted on SourceForge due to Google Code's download restrictions.** We strongly recommend getting the most recent version directly from [the main TenFourFox website](http://www.tenfourfox.com/), but you can also browse files in the [TenFourFox SourceForge repository](https://sourceforge.net/projects/tenfourfox/files/) if you prefer.
If you are using a G4, you should try to choose the correct version for your processor generation (7400 or 7450 "G4e") as performance may be impaired if you run the wrong one. If you don't know which G4 processor you have, the instructions in WhichVersion will tell you how to find out.
## TenFourFox 38 is equivalent to Firefox 38 ##
TenFourFox uses modified Firefox source code, rewritten to remain compatible with Mac OS X v10.4 and the Power Macintosh. It also contains specific optimizations and special features for PowerPC processors. For this reason, it is not exactly the same as Firefox. However, it is intended to be as compatible with it as possible, including most add-ons and [most standard features](TechnicalDifferences.md). You can treat 10.4Fx 38 as equivalent with Firefox 38 in most circumstances, with specific exceptions noted below.
Note that add-ons which require an Intel Macintosh will not work with TenFourFox, even if they are otherwise compatible with Firefox 38, and add-ons that require 10.5 Leopard (or higher) may not be compatible with TenFourFox running on Mac OS X 10.4 Tiger, even if they are compatible with PowerPC.
## This branch of TenFourFox is the _new_ stable version ##
Starting with Firefox 10, Mozilla began offering an extended support release version of Firefox ("Firefox **ESR**") intended for environments where users are unable to use rapid-release versions of Firefox due to policy or technical constraints. This ESR is the basis of the TenFourFox **stable** branch.
The current ESR release is based on Firefox 38. 10.4Fx 38.x is based on this extended support release and is intended for users who wish to remain with a stable browser core. The stable branch will continue to receive bugfixes and security updates, but will not receive new Firefox features (although it may receive certain 10.4Fx-specific features judged important for our legacy users).
**We recommend this version for most of our users.** If you wish to help test our continuing porting efforts, you can try the _unstable_ branch, which is based on the current release of Firefox. _The unstable branch does have bugs and is recommended only for advanced users._ For more information, see the [TenFourFox Development](http://tenfourfox.blogspot.com/) blog.
## TenFourFox no longer supports plugins or Flash ##
Plugins on PowerPC are of special concern because Mozilla is making updates to their plugin architecture which may require the plugins themselves to be updated, and there are certain difficult-to-correct bugs with them already on Tiger. Most importantly, QuickTime, Java and Adobe Flash for PowerPC are no longer maintained and have known security risks that can crash, perform malicious operations or leak data, and Flash 10.1 is rapidly becoming unsupported by many applications.
**For these and other reasons (for details, see PluginsNoLongerSupported), TenFourFox does not run plugins and they cannot be enabled.** Bug reports will no longer be accepted. Sites will now act as if no plugins were installed at all. Earlier versions that allowed an undocumented plugin support mode are no longer supported.
For Internet video, we now recommend the use of TenFourFox's optional QuickTimeEnabler. This allows many videos to be handled in QuickTime Player directly.
You can also download videos for separate viewing using [Perian](http://www.perian.org/) and any of the available video download add-ons for Firefox.
If you have a high end G4 or G5, you can also use WebM for selected videos by visiting http://www.youtube.com/html5 and enabling HTML5 video. This will set a temporary cookie enabling browser-based video without Flash. You do not need a YouTube account for this feature, but you may need to periodically renew the cookie setting. Not all video is available in WebM.
For a more in-depth explanation of this policy and other workarounds, see PluginsNoLongerSupported.
## New in this version of TenFourFox ##
* All standard supported features of Firefox 38, including in-browser PDF viewing, Reader View for simplified and faster loading pages, in-content preferences, enhanced memory management and garbage collection, and multiple improvements to HTML5/CSS performance and compatibility.
* TenFourFox's new custom IonPower JavaScript backend accelerates JavaScript operations by up to eleven times over version 31, and up to over 40 times faster than the basic interpreter ([issue 178](https://code.google.com/p/tenfourfox/issues/detail?id=178)).
* Local font attributes are now cached more aggressively, improving text rendering performance.
* Full colour management is enabled for all images.
## Bugs fixed in this beta of TenFourFox ##
* The browser no longer crashes when enumerating webfonts for cleanup.
* The browser no longer crashes on 10.5 systems while viewing certain New York Times websites with non-standard webfonts. This issue also affects 31.8, and can cause 10.4 systems to display unusual error messages. A general font URL blacklist has been internally implemented for future use.
* Issues with JavaScript malfunctioning on Facebook and Facebook-derived sites such as Instagram have been corrected.
* Saved passwords now correctly appear in preferences ([issue 305](https://code.google.com/p/tenfourfox/issues/detail?id=305)).
* Checkmarks now correctly appear on context and drop-down menus.
* Basic JavaScript internationalization support is implemented for add-ons that may require it ([issue 266](https://code.google.com/p/tenfourfox/issues/detail?id=266)). This issue also affects 31.8.
## Known issues specific to TenFourFox ##
* Remember: **Plugins do not work in TenFourFox and can no longer be enabled.** See PluginsNoLongerSupported for an explanation and suggested workarounds.
* Starting in version 38, the `Check for Updates` menu option is now under the Help menu, as in the official Mac Firefox.
* Starting in version 38, the new tab page is always blank.
* Starting in version 38, the default search provider is now Yahoo, not Google. You can change it back from the preferences page.
* TenFourFox intentionally uses a lighter chrome for windows and dialogue boxes than prior versions or the official Mac Firefox.
* Bitmap-only fonts (usually Type 1 PostScript) cannot be used by the 10.4Fx font renderer and are automatically ignored by the browser. A fallback font will be used in their place.
* Personas and certain custom skins may hide the "traffic light" window buttons, but they are still present and will work if hovered over or clicked on ([issue 247](https://code.google.com/p/tenfourfox/issues/detail?id=247)).
* The "traffic light" buttons are misplaced on private browsing windows if the title bar is enabled (not the default). They function normally otherwise.
* Not all webcams are supported; in addition, multiple webcams may not all appear depending on how they are connected ([issue 221](https://code.google.com/p/tenfourfox/issues/detail?id=221)). For a list of supported webcam devices, see VideoDeviceSupport.
* 10.4Fx does not currently support WebGL, WebRTC or the webapp runtime, and scripts such as Arabic or Indic requiring glyph reordering or language-specific ligatures may not appear correctly without OpenType fonts. See TechnicalDifferences for the complete list of changes necessary for 10.4Fx. See [issue 5](https://code.google.com/p/tenfourfox/issues/detail?id=5) for notes specific to the font issue.
* Printing may crash the browser on Mac OS X Tiger Server ([issue 279](https://code.google.com/p/tenfourfox/issues/detail?id=279)). Please note that Mac OS X Server is not supported currently.
* Crash reporting is intentionally disabled to avoid polluting Mozilla's crash tracking system with our reports. Please use your system's crash logs if you are reporting a _reproducible_ crash, or (if you are able) provide a `gdb` backtrace.
* Although 10.4Fx will tell you when an update is available, you must download updates manually at this time.
You are welcome to report other bugs that you find. However, please **do not report Mozilla bugs to us.** If the bug or crash occurs in both the official Mozilla Firefox 38 _(3.6 doesn't count!)_ and in 10.4Fx, this is a Mozilla bug, and you should file it at [Bugzilla](http://bugzilla.mozilla.org/). **You must test your bug in both places -- bugs that are not confirmed to be part of 10.4Fx will be marked invalid** so that we can keep our task list focused. This is the [current list of known issues](http://code.google.com/p/tenfourfox/issues/list).

75
ReleaseNotes3820.md Normal file
View File

@ -0,0 +1,75 @@
_This document may be updated for late-breaking changes, so check back here if you are having difficulty._
**TenFourFox is moving to Github! Future release notes will be hosted on Github due to Google Code becoming read-only. This will be the last release note posted here, though older notes will be available while the service persists.**
## System requirements ##
TenFourFox (hereafter "10.4Fx") requires a G3 Power Macintosh, Mac OS X 10.4.11, 200MB of free disk space and 512MB of RAM. 1GB of RAM and a G4 or G5 processor is recommended. Video playback is likely to be poor on systems slower than 1.25GHz; a G5 is recommended. Mac OS X 10.5.8 is supported. Although the browser may run under Mac OS X Server, it is not currently supported.
Intel Macintoshes are not supported. Although some users have reported success getting the G3 version of 10.4Fx to run under Rosetta, certain features may not work correctly or at all on Intel Macs, and you may need to completely disable JavaScript compilation for it to work with Rosetta (see [the FAQ](AAATheFAQ.md) for more information). Because Apple no longer supports Rosetta and 10.4Fx is not a Universal binary, it will not run under Lion 10.7 or any subsequent version of Mac OS X.
## Getting TenFourFox ##
Make sure you select the appropriate build for your Mac from the [download page](http://www.tenfourfox.com/). The G3 version will run on any supported Macintosh, but it will not take advantage of the additional features of G4 or G5 processors. The G4 and G5 versions will not run at all on a G3, and the G5 version will perform badly or crash on non-G5 Macintoshes.
**Starting with 24.1.0, all downloads are hosted on SourceForge due to Google Code's download restrictions.** We strongly recommend getting the most recent version directly from [the main TenFourFox website](http://www.tenfourfox.com/), but you can also browse files in the [TenFourFox SourceForge repository](https://sourceforge.net/projects/tenfourfox/files/) if you prefer.
If you are using a G4, you should try to choose the correct version for your processor generation (7400 or 7450 "G4e") as performance may be impaired if you run the wrong one. If you don't know which G4 processor you have, the instructions in WhichVersion will tell you how to find out.
## TenFourFox 38 is equivalent to Firefox 38 ##
TenFourFox uses modified Firefox source code, rewritten to remain compatible with Mac OS X v10.4 and the Power Macintosh. It also contains specific optimizations and special features for PowerPC processors. For this reason, it is not exactly the same as Firefox. However, it is intended to be as compatible with it as possible, including most add-ons and [most standard features](TechnicalDifferences.md). You can treat 10.4Fx 38 as equivalent with Firefox 38 in most circumstances, with specific exceptions noted below.
Note that add-ons which require an Intel Macintosh will not work with TenFourFox, even if they are otherwise compatible with Firefox 38, and add-ons that require 10.5 Leopard (or higher) may not be compatible with TenFourFox running on Mac OS X 10.4 Tiger, even if they are compatible with PowerPC.
## This branch of TenFourFox is the _new_ stable version ##
Starting with Firefox 10, Mozilla began offering an extended support release version of Firefox ("Firefox **ESR**") intended for environments where users are unable to use rapid-release versions of Firefox due to policy or technical constraints. This ESR is the basis of the TenFourFox **stable** branch.
The current ESR release is based on Firefox 38. 10.4Fx 38.x is based on this extended support release and is intended for users who wish to remain with a stable browser core. The stable branch will continue to receive bugfixes and security updates, but will not receive new Firefox features (although it may receive certain 10.4Fx-specific features judged important for our legacy users).
**We recommend this version for most of our users.** If you wish to help test our continuing porting efforts, you can try the _unstable_ branch, which is based on the current release of Firefox. _The unstable branch does have bugs and is recommended only for advanced users._ For more information, see the [TenFourFox Development](http://tenfourfox.blogspot.com/) blog.
## TenFourFox no longer supports plugins or Flash ##
Plugins on PowerPC are of special concern because Mozilla is making updates to their plugin architecture which may require the plugins themselves to be updated, and there are certain difficult-to-correct bugs with them already on Tiger. Most importantly, QuickTime, Java and Adobe Flash for PowerPC are no longer maintained and have known security risks that can crash, perform malicious operations or leak data, and Flash 10.1 is rapidly becoming unsupported by many applications.
**For these and other reasons (for details, see PluginsNoLongerSupported), TenFourFox does not run plugins and they cannot be enabled.** Bug reports will no longer be accepted. Sites will now act as if no plugins were installed at all. Earlier versions that allowed an undocumented plugin support mode are no longer supported.
For Internet video, we now recommend the use of TenFourFox's optional QuickTimeEnabler. This allows many videos to be handled in QuickTime Player directly.
You can also download videos for separate viewing using [Perian](http://www.perian.org/) and any of the available video download add-ons for Firefox.
If you have a high end G4 or G5, you can also use WebM for selected videos by visiting http://www.youtube.com/html5 and enabling HTML5 video. This will set a temporary cookie enabling browser-based video without Flash. You do not need a YouTube account for this feature, but you may need to periodically renew the cookie setting. Not all video is available in WebM.
For a more in-depth explanation of this policy and other workarounds, see PluginsNoLongerSupported.
## New in this version of TenFourFox ##
* All standard supported features of Firefox 38, including in-browser PDF viewing, Reader View for simplified and faster loading pages, in-content preferences, enhanced memory management and garbage collection, and multiple improvements to HTML5/CSS performance and compatibility.
* TenFourFox's new custom IonPower JavaScript backend accelerates JavaScript operations by up to eleven times over version 31, and up to over 40 times faster than the basic interpreter ([issue 178](https://code.google.com/p/tenfourfox/issues/detail?id=178)).
* Local font attributes are now cached more aggressively, improving text rendering performance.
* Full colour management is enabled for all images.
## Fixed in this version of TenFourFox ##
* The browser no longer crashes on 10.5 systems while viewing certain New York Times websites with non-standard webfonts. This issue also can cause 10.4 systems to display unusual error messages. A general font URL blacklist has been internally implemented for future use.
* Basic JavaScript internationalization support is implemented for add-ons that may require it ([issue 266](https://code.google.com/p/tenfourfox/issues/detail?id=266)).
## Known issues specific to TenFourFox ##
* Remember: **Plugins do not work in TenFourFox and cannot be enabled.** See PluginsNoLongerSupported for an explanation and suggested workarounds.
* Starting in version 38, the `Check for Updates` menu option is now under the Help menu, as in the official Mac Firefox.
* Starting in version 38, the new tab page is always blank.
* Starting in version 38, the default search provider is now Yahoo, not Google. You can change it back from the preferences page.
* TenFourFox intentionally uses a different chrome for windows and dialogue boxes than prior versions or the official Mac Firefox.
* Bitmap-only fonts (usually Type 1 PostScript) cannot be used by the 10.4Fx font renderer and are automatically ignored by the browser. A fallback font will be used in their place.
* Personas and certain custom skins may hide the "traffic light" window buttons, but they are still present and will work if hovered over or clicked on ([issue 247](https://code.google.com/p/tenfourfox/issues/detail?id=247)).
* The "traffic light" buttons are misplaced on private browsing windows if the title bar is enabled (not the default). They function normally otherwise.
* Not all webcams are supported; in addition, multiple webcams may not all appear depending on how they are connected ([issue 221](https://code.google.com/p/tenfourfox/issues/detail?id=221)). For a list of supported webcam devices, see VideoDeviceSupport.
* 10.4Fx does not currently support WebGL, WebRTC or the webapp runtime, and scripts such as Arabic or Indic requiring glyph reordering or language-specific ligatures may not appear correctly without OpenType fonts. See TechnicalDifferences for the complete list of changes necessary for 10.4Fx. See [issue 5](https://code.google.com/p/tenfourfox/issues/detail?id=5) for notes specific to the font issue.
* Printing may crash the browser on Mac OS X Tiger Server ([issue 279](https://code.google.com/p/tenfourfox/issues/detail?id=279)). Please note that Mac OS X Server is not supported currently.
* Crash reporting is intentionally disabled to avoid polluting Mozilla's crash tracking system with our reports. Please use your system's crash logs if you are reporting a _reproducible_ crash, or (if you are able) provide a `gdb` backtrace.
* Although 10.4Fx will tell you when an update is available, you must download updates manually at this time.
You are welcome to report other bugs that you find. However, please **do not report Mozilla bugs to us.** If the bug or crash occurs in both the official Mozilla Firefox 38 _(3.6 doesn't count!)_ and in 10.4Fx, this is a Mozilla bug, and you should file it at [Bugzilla](http://bugzilla.mozilla.org/). **You must test your bug in both places -- bugs that are not confirmed to be part of 10.4Fx will be marked invalid** so that we can keep our task list focused. This is the [current list of known issues](http://code.google.com/p/tenfourfox/issues/list).

40
ReleaseNotes40.md Normal file
View File

@ -0,0 +1,40 @@
_This document may be updated for late-breaking changes, so check back here if you are having difficulty._
## System requirements ##
TenFourFox (hereafter "10.4Fx") requires a G3 Power Macintosh, Mac OS X 10.4.11, 100MB of free disk space and 256MB of RAM. 512MB of RAM and a G4 or G5 processor is recommended. Video playback is likely to be suboptimal on systems slower than 1.25GHz. Mac OS X 10.5.8 is supported.
Intel Macintoshes are not supported, but the G3 build is known to run under Rosetta in 10.5.8. It is not tested with Snow Leopard. 10.4Fx will not run in the Lion Preview, as Lion does not support Rosetta and 10.4Fx is pure PowerPC code.
## Getting TenFourFox ##
Make sure you select the appropriate build for your Mac from the [download page](http://www.tenfourfox.com/). The G3 version will run on any supported Macintosh, but it will not take advantage of the additional features of G4 or G5 processors. The G4 and G5 versions will not run correctly on a G3, and the G5 version will perform worse on non-G5 Macintoshes.
If you are using a G4, you should try to choose the correct version for your processor generation (7400 or 7450 "G4e") as performance may be impaired if you run the wrong one. If you don't know which G4 processor you have, the instructions in WhichVersion will tell you how to find out.
## TenFourFox 4.0 is equivalent to Mozilla Firefox 4.0 ##
TenFourFox uses modified Mozilla source code, rewritten to remain compatible with Mac OS X v10.4 and the Power Macintosh. It also contains specific optimizations and special features for PowerPC processors. For this reason, it is not exactly the same as Firefox. However, it is intended to be as compatible with it as possible, including most add-ons and most standard features. You can treat 10.4Fx as equivalent with Firefox 4.0 in most circumstances, with specific exceptions noted below.
Note that add-ons and plugins which require an Intel Macintosh will not work with TenFourFox, even if they are otherwise compatible with Firefox 4.
## Known issues fixed in this version of TenFourFox ##
* All known Mozilla general fixes for Firefox 4.0. **Release 4.0s includes an out-of-cycle security update to revoke malicious certificates issued by a compromised vendor, and fixes a performance issue with JavaScript.**
* Cmd-~ (tilde) now correctly cycles windows again ([issue 33](https://code.google.com/p/tenfourfox/issues/detail?id=33)), fixing the regression introduced in beta 12.
* Window ordering is now more reliable ([issue 34](https://code.google.com/p/tenfourfox/issues/detail?id=34)).
* A crash in the JavaScript accelerator has been repaired ([issue 37](https://code.google.com/p/tenfourfox/issues/detail?id=37)).
## Known issues specific to TenFourFox ##
* **Plugins, although most will still work, are _officially deprecated._** This is due to security, performance and technical issues from plugins such as Flash and QuickTime which will soon be no longer updated for Power Macintoshes. These plugins represent a future potential means of compromising browser security, and they use older OS APIs that Mozilla will no longer support. While they will still continue to function throughout TenFourFox 4.x, only major bugs will be repaired, and it is possible there may be graphical glitches. **Plugins will be turned off by default in the next major release, and support for them will be removed entirely in a subsequent version.** For more about this, [see this blog entry](http://tenfourfox.blogspot.com/2011/01/plugins-unplugged.html) and [issue 24](https://code.google.com/p/tenfourfox/issues/detail?id=24).
* When 10.4Fx has no suggestions for the awesome bar, a blank box appears instead ([issue 21](https://code.google.com/p/tenfourfox/issues/detail?id=21)). This is intentional.
* 10.4Fx does not currently support WebGL or out-of-process plugins, and Indic, Arabic and other scripts requiring glyph reordering or language-specific ligatures may not appear correctly. See TechnicalDifferences for the complete list of changes necessary for 10.4Fx. See [issue 5](https://code.google.com/p/tenfourfox/issues/detail?id=5) for notes specific to the font issue.
* Animation performance is currently poorer in Mozilla 2.0/Firefox 4.0 versions using software rendering, which includes 10.4Fx. Mozilla acknowledges this bug, but there is not yet an ETR. See [issue 7](https://code.google.com/p/tenfourfox/issues/detail?id=7).
* The titlebar does not always properly match the menu gradient ([issue 16](https://code.google.com/p/tenfourfox/issues/detail?id=16)). This problem is also in the official release. Installing a Persona may fix this issue if you find it bothersome.
* Crash reporting is intentionally disabled to avoid polluting Mozilla's crash tracking system with our reports. Please use your system's crash logs if you are reporting a _reproducible_ crash, or (if you are able) provide a `gdb` backtrace.
* Although 10.4Fx will tell you when an update is available, you must download updates manually at this time.
You may also wish to read the [Mozilla Firefox release notes](http://www.mozilla.com/en-US/firefox/4.0/whatsnew/) for what's new in this version of Firefox.
You are welcome to report other bugs that you find. However, please **do not report Mozilla bugs to us.** If the bug or crash occurs in both the official Mozilla Firefox 4 _(3.6 doesn't count!)_ and in 10.4Fx, this is a Mozilla bug, and you should file it at [Bugzilla](http://bugzilla.mozilla.org/). **You must test your bug in both places -- bugs that are not confirmed to be part of 10.4Fx will be marked invalid** so that we can keep our task list focused. This is the [current list of known issues](http://code.google.com/p/tenfourfox/issues/list).

41
ReleaseNotes401.md Normal file
View File

@ -0,0 +1,41 @@
_This document may be updated for late-breaking changes, so check back here if you are having difficulty._
## System requirements ##
TenFourFox (hereafter "10.4Fx") requires a G3 Power Macintosh, Mac OS X 10.4.11, 100MB of free disk space and 256MB of RAM. 512MB of RAM and a G4 or G5 processor is recommended. Video playback is likely to be poor on systems slower than 1.25GHz; a G5 is recommended. Mac OS X 10.5.8 is supported.
Intel Macintoshes are not supported, but the G3 build is known to run under Rosetta in 10.5.8 and should run under Rosetta in Intel 10.4.11. It is not tested with Snow Leopard. 10.4Fx will not run in the Lion Preview, as Lion does not support Rosetta and 10.4Fx is not a Universal binary.
## Getting TenFourFox ##
Make sure you select the appropriate build for your Mac from the [download page](http://www.tenfourfox.com/). The G3 version will run on any supported Macintosh, but it will not take advantage of the additional features of G4 or G5 processors. The G4 and G5 versions will not run correctly on a G3, and the G5 version will perform worse on non-G5 Macintoshes.
If you are using a G4, you should try to choose the correct version for your processor generation (7400 or 7450 "G4e") as performance may be impaired if you run the wrong one. If you don't know which G4 processor you have, the instructions in WhichVersion will tell you how to find out.
## TenFourFox 4.0.1 is equivalent to Mozilla Firefox 4.0.1 "Macaw" ##
TenFourFox uses modified Firefox source code, rewritten to remain compatible with Mac OS X v10.4 and the Power Macintosh. It also contains specific optimizations and special features for PowerPC processors. For this reason, it is not exactly the same as Firefox. However, it is intended to be as compatible with it as possible, including most add-ons and [most standard features](TechnicalDifferences.md). You can treat 10.4Fx as equivalent with Firefox 4.0.1 in most circumstances, with specific exceptions noted below.
Note that add-ons and plugins which require an Intel Macintosh will not work with TenFourFox, even if they are otherwise compatible with Firefox 4, and add-ons and plugins that require 10.5 Leopard may not be compatible with TenFourFox running on Mac OS X 10.4 Tiger, even if they are compatible with PowerPC.
## Known issues fixed in this version of TenFourFox ##
* All known general Mozilla security and stability fixes for Firefox 4.0.1 ("Macaw").
* G5 JavaScript performance is now significantly faster ([issue 23](https://code.google.com/p/tenfourfox/issues/detail?id=23)).
* WebM video is now AltiVec-accelerated ([issue 28](https://code.google.com/p/tenfourfox/issues/detail?id=28)). Performance may still be limited by your Macintosh, but many videos will now play fully and almost all will play better than before.
* When a plugin is on-screen, scrolling is adjusted to reduce video artifacts ([issue 50](https://code.google.com/p/tenfourfox/issues/detail?id=50)).
* Pixel-level compositing is now AltiVec-accelerated ([issue 53](https://code.google.com/p/tenfourfox/issues/detail?id=53)).
## Known issues specific to TenFourFox ##
* **Plugins, although most will still work, are _officially deprecated._** This is due to security, performance and technical issues from plugins such as Flash and QuickTime which will soon be no longer updated for Power Macintoshes. These plugins represent a future potential means of compromising browser security, and they use older OS APIs that Mozilla will no longer support. While they will still continue to function throughout TenFourFox 4.x, only major bugs will be repaired, and it is possible there may be graphical glitches. **Plugins will be turned off by default in the next major release, and support for them will be removed entirely in a subsequent version.** For more about this, [see this blog entry](http://tenfourfox.blogspot.com/2011/01/plugins-unplugged.html) and [issue 24](https://code.google.com/p/tenfourfox/issues/detail?id=24).
* When 10.4Fx has no suggestions for the awesome bar, a blank box appears instead ([issue 21](https://code.google.com/p/tenfourfox/issues/detail?id=21)). This is intentional.
* 10.4Fx does not currently support WebGL or out-of-process plugins, and Indic, Arabic and other scripts requiring glyph reordering or language-specific ligatures may not appear correctly. See TechnicalDifferences for the complete list of changes necessary for 10.4Fx. See [issue 5](https://code.google.com/p/tenfourfox/issues/detail?id=5) for notes specific to the font issue.
* Animation performance is currently poorer in Mozilla 2.0/Firefox 4.0 versions using software rendering, which includes 10.4Fx. Mozilla acknowledges this bug, but there is not yet an ETR. See [issue 7](https://code.google.com/p/tenfourfox/issues/detail?id=7).
* The titlebar does not always properly match the menu gradient ([issue 16](https://code.google.com/p/tenfourfox/issues/detail?id=16)). This problem is also in the official release. Installing a Persona may fix this issue if you find it bothersome.
* Crash reporting is intentionally disabled to avoid polluting Mozilla's crash tracking system with our reports. Please use your system's crash logs if you are reporting a _reproducible_ crash, or (if you are able) provide a `gdb` backtrace.
* Although 10.4Fx will tell you when an update is available, you must download updates manually at this time.
You may also wish to read the [Mozilla Firefox release notes](http://www.mozilla.com/en-US/firefox/4.0.1/whatsnew/) for what's new in this version of Firefox. This page may not yet be available.
You are welcome to report other bugs that you find. However, please **do not report Mozilla bugs to us.** If the bug or crash occurs in both the official Mozilla Firefox 4 _(3.6 doesn't count!)_ and in 10.4Fx, this is a Mozilla bug, and you should file it at [Bugzilla](http://bugzilla.mozilla.org/). **You must test your bug in both places -- bugs that are not confirmed to be part of 10.4Fx will be marked invalid** so that we can keep our task list focused. This is the [current list of known issues](http://code.google.com/p/tenfourfox/issues/list).

39
ReleaseNotes402.md Normal file
View File

@ -0,0 +1,39 @@
_This document may be updated for late-breaking changes, so check back here if you are having difficulty._
## System requirements ##
TenFourFox (hereafter "10.4Fx") requires a G3 Power Macintosh, Mac OS X 10.4.11, 100MB of free disk space and 256MB of RAM. 512MB of RAM and a G4 or G5 processor is recommended. Video playback is likely to be poor on systems slower than 1.25GHz; a G5 is recommended. Mac OS X 10.5.8 is supported.
Intel Macintoshes are not supported, but the G3 build is known to run under Rosetta in 10.5.8 and should run under Rosetta in Intel 10.4.11. It is not tested with Snow Leopard. 10.4Fx will not run in the Lion Preview, as Lion does not support Rosetta and 10.4Fx is not a Universal binary.
## Getting TenFourFox ##
Make sure you select the appropriate build for your Mac from the [download page](http://www.tenfourfox.com/). The G3 version will run on any supported Macintosh, but it will not take advantage of the additional features of G4 or G5 processors. The G4 and G5 versions will not run correctly on a G3, and the G5 version will perform worse on non-G5 Macintoshes.
If you are using a G4, you should try to choose the correct version for your processor generation (7400 or 7450 "G4e") as performance may be impaired if you run the wrong one. If you don't know which G4 processor you have, the instructions in WhichVersion will tell you how to find out.
## TenFourFox 4.0.2 includes security updates to Mozilla Firefox 4.0.1 ##
TenFourFox uses modified Firefox source code, rewritten to remain compatible with Mac OS X v10.4 and the Power Macintosh. It also contains specific optimizations and special features for PowerPC processors. For this reason, it is not exactly the same as Firefox. However, it is intended to be as compatible with it as possible, including most add-ons and [most standard features](TechnicalDifferences.md). You can treat 10.4Fx as equivalent with Firefox 4.0.1 in most circumstances, with specific exceptions noted below.
**Please note that Mozilla does not plan to release an official Firefox 4.0.2; this is a special TenFourFox release.** This version of TenFourFox is a security, stability and performance update addressing 10.4Fx-specific bugs and to repair maintenance issues Mozilla only plans to fix in Firefox 5, but that also affect Firefox 4. Because Firefox 5 is still being evaluated on Power Macintosh, we have issued this interim release while the 10.4Fx team works on the next version.
Note that add-ons and plugins which require an Intel Macintosh will not work with TenFourFox, even if they are otherwise compatible with Firefox 4, and add-ons and plugins that require 10.5 Leopard may not be compatible with TenFourFox running on Mac OS X 10.4 Tiger, even if they are compatible with PowerPC.
## Known issues fixed in this version of TenFourFox ##
* A crash bug in the JavaScript interpreter has been repaired ([issue 37](https://code.google.com/p/tenfourfox/issues/detail?id=37), [issue 62](https://code.google.com/p/tenfourfox/issues/detail?id=62)). Due to the nature of this bug, the fix also improves overall JavaScript performance on all platforms.
* Plugin smooth scrolling can be turned off with a preference if desired ([issue 58](https://code.google.com/p/tenfourfox/issues/detail?id=58)).
* Multiple applicable Mozilla-general security and stability issues have been applied and/or backported.
## Known issues specific to TenFourFox ##
* **Plugins, although most will still work, are _officially deprecated._** This is due to security, performance and technical issues from plugins such as Flash and QuickTime which will soon be no longer updated for Power Macintoshes. These plugins represent a future potential means of compromising browser security, and they use older OS APIs that Mozilla will no longer support. While they will still continue to function throughout TenFourFox 4.x, only major bugs will be repaired, and it is possible there may be graphical glitches. **Plugins will be turned off by default in the next major release, and support for them will be removed entirely in a subsequent version.** For more about this, [see this blog entry](http://tenfourfox.blogspot.com/2011/01/plugins-unplugged.html) and [issue 24](https://code.google.com/p/tenfourfox/issues/detail?id=24).
* When 10.4Fx has no suggestions for the awesome bar, a blank box appears instead ([issue 21](https://code.google.com/p/tenfourfox/issues/detail?id=21)). This is intentional.
* 10.4Fx does not currently support WebGL or out-of-process plugins, and Indic, Arabic and other scripts requiring glyph reordering or language-specific ligatures may not appear correctly. See TechnicalDifferences for the complete list of changes necessary for 10.4Fx. See [issue 5](https://code.google.com/p/tenfourfox/issues/detail?id=5) for notes specific to the font issue.
* Animation performance is currently poorer in Mozilla 2.0/Firefox 4.0 versions using software rendering, which includes 10.4Fx. Mozilla acknowledges this bug, but there is not yet an ETR. See [issue 7](https://code.google.com/p/tenfourfox/issues/detail?id=7).
* The titlebar does not always properly match the menu gradient ([issue 16](https://code.google.com/p/tenfourfox/issues/detail?id=16)). This problem is also in the official release. Installing a Persona may fix this issue if you find it bothersome.
* Crash reporting is intentionally disabled to avoid polluting Mozilla's crash tracking system with our reports. Please use your system's crash logs if you are reporting a _reproducible_ crash, or (if you are able) provide a `gdb` backtrace.
* Although 10.4Fx will tell you when an update is available, you must download updates manually at this time.
You are welcome to report other bugs that you find. However, please **do not report Mozilla bugs to us.** If the bug or crash occurs in both the official Mozilla Firefox 4 _(3.6 doesn't count!)_ and in 10.4Fx, this is a Mozilla bug, and you should file it at [Bugzilla](http://bugzilla.mozilla.org/). **You must test your bug in both places -- bugs that are not confirmed to be part of 10.4Fx will be marked invalid** so that we can keep our task list focused. This is the [current list of known issues](http://code.google.com/p/tenfourfox/issues/list).

38
ReleaseNotes403.md Normal file
View File

@ -0,0 +1,38 @@
_This document may be updated for late-breaking changes, so check back here if you are having difficulty._
## System requirements ##
TenFourFox (hereafter "10.4Fx") requires a G3 Power Macintosh, Mac OS X 10.4.11, 100MB of free disk space and 256MB of RAM. 512MB of RAM and a G4 or G5 processor is recommended. Video playback is likely to be poor on systems slower than 1.25GHz; a G5 is recommended. Mac OS X 10.5.8 is supported.
Intel Macintoshes are not supported, but the G3 build is known to run under Rosetta in 10.5.8 and should run under Rosetta in Intel 10.4.11. It is not tested with Snow Leopard. 10.4Fx will not run under Lion, as Lion does not support Rosetta and 10.4Fx is not a Universal binary.
## Getting TenFourFox ##
Make sure you select the appropriate build for your Mac from the [download page](http://www.tenfourfox.com/). The G3 version will run on any supported Macintosh, but it will not take advantage of the additional features of G4 or G5 processors. The G4 and G5 versions will not run correctly on a G3, and the G5 version will perform worse on non-G5 Macintoshes.
If you are using a G4, you should try to choose the correct version for your processor generation (7400 or 7450 "G4e") as performance may be impaired if you run the wrong one. If you don't know which G4 processor you have, the instructions in WhichVersion will tell you how to find out.
## TenFourFox 4.0.3 is the final release of TenFourFox 4 ##
TenFourFox uses modified Firefox source code, rewritten to remain compatible with Mac OS X v10.4 and the Power Macintosh. It also contains specific optimizations and special features for PowerPC processors. For this reason, it is not exactly the same as Firefox. However, it is intended to be as compatible with it as possible, including most add-ons and [most standard features](TechnicalDifferences.md). You can treat 10.4Fx as equivalent with Firefox 4.0.1 in most circumstances, with specific exceptions noted below.
Please note that Mozilla has not released a Firefox 4.0.3; this is a special TenFourFox release. This version of TenFourFox is a security, stability and performance update addressing known Mozilla security issues and 10.4Fx-specific bugs. **This release is intended for users who require TenFourFox 4.0.x and cannot use TenFourFox 5. There will be no further updates to TenFourFox 4.**
Note that add-ons and plugins which require an Intel Macintosh will not work with TenFourFox, even if they are otherwise compatible with Firefox 4, and add-ons and plugins that require 10.5 Leopard may not be compatible with TenFourFox running on Mac OS X 10.4 Tiger, even if they are compatible with PowerPC.
## Known issues fixed in this version of TenFourFox ##
* A crash bug in the JavaScript interpreter has been repaired ([issue 63](https://code.google.com/p/tenfourfox/issues/detail?id=63)). This fix is also in 10.4Fx 5.0.
* Multiple applicable Mozilla-general security and stability issues have been applied and/or backported.
## Known issues specific to TenFourFox ##
* **Plugins, although most will still work, are _officially deprecated._** This is due to security, performance and technical issues from plugins such as Flash and QuickTime which will soon be no longer updated for Power Macintoshes. These plugins represent a future potential means of compromising browser security, and they use older OS APIs that Mozilla will no longer support. While they will still continue to function throughout TenFourFox 4.x, only major bugs will be repaired, and it is possible there may be graphical glitches. **Plugins will be turned off by default in TenFourFox 6, and support for them will be removed entirely in a subsequent version.** For more about this, [see this blog entry](http://tenfourfox.blogspot.com/2011/01/plugins-unplugged.html) and [issue 24](https://code.google.com/p/tenfourfox/issues/detail?id=24).
* When 10.4Fx has no suggestions for the awesome bar, a blank box appears instead ([issue 21](https://code.google.com/p/tenfourfox/issues/detail?id=21)). This is intentional.
* 10.4Fx does not currently support WebGL or out-of-process plugins, and Indic, Arabic and other scripts requiring glyph reordering or language-specific ligatures may not appear correctly. See TechnicalDifferences for the complete list of changes necessary for 10.4Fx. See [issue 5](https://code.google.com/p/tenfourfox/issues/detail?id=5) for notes specific to the font issue.
* Animation performance is currently poorer in Mozilla 2.0/Firefox 4.0 versions using software rendering, which includes 10.4Fx. Mozilla acknowledges this bug, but there is not yet an ETR. See [issue 7](https://code.google.com/p/tenfourfox/issues/detail?id=7).
* The titlebar does not always properly match the menu gradient ([issue 16](https://code.google.com/p/tenfourfox/issues/detail?id=16)). This problem is also in the official release. Installing a Persona may fix this issue if you find it bothersome.
* Crash reporting is intentionally disabled to avoid polluting Mozilla's crash tracking system with our reports.
* Although 10.4Fx will tell you when an update is available, you must download updates manually at this time.
No further bug reports are being accepted against this version of TenFourFox. If you experience what you believe to be a bug, we recommend updating to TenFourFox 5 or higher. This is the [current list of known issues](http://code.google.com/p/tenfourfox/issues/list).

58
ReleaseNotes50.md Normal file
View File

@ -0,0 +1,58 @@
_This document may be updated for late-breaking changes, so check back here if you are having difficulty._
## System requirements ##
TenFourFox (hereafter "10.4Fx") requires a G3 Power Macintosh, Mac OS X 10.4.11, 100MB of free disk space and 256MB of RAM. 512MB of RAM and a G4 or G5 processor is recommended. Video playback is likely to be poor on systems slower than 1.25GHz; a G5 is recommended. Mac OS X 10.5.8 is supported.
Intel Macintoshes are not supported, but the G3 build is known to run under Rosetta in 10.5.8 and should run under Rosetta in Intel 10.4.11. It is not tested with Snow Leopard. 10.4Fx will not run under 10.7 Lion, as Lion does not support Rosetta and 10.4Fx is not a Universal binary.
## Getting TenFourFox ##
Make sure you select the appropriate build for your Mac from the [download page](http://www.tenfourfox.com/). The G3 version will run on any supported Macintosh, but it will not take advantage of the additional features of G4 or G5 processors. The G4 and G5 versions will not run correctly on a G3, and the G5 version will perform worse on non-G5 Macintoshes.
If you are using a G4, you should try to choose the correct version for your processor generation (7400 or 7450 "G4e") as performance may be impaired if you run the wrong one. If you don't know which G4 processor you have, the instructions in WhichVersion will tell you how to find out.
## TenFourFox 5.0 is equivalent to Firefox 5.0 ##
TenFourFox uses modified Firefox source code, rewritten to remain compatible with Mac OS X v10.4 and the Power Macintosh. It also contains specific optimizations and special features for PowerPC processors. For this reason, it is not exactly the same as Firefox. However, it is intended to be as compatible with it as possible, including most add-ons and [most standard features](TechnicalDifferences.md). You can treat 10.4Fx as equivalent with Firefox 5.0 in most circumstances, with specific exceptions noted below.
Note that add-ons and plugins which require an Intel Macintosh will not work with TenFourFox, even if they are otherwise compatible with Firefox 5, and add-ons and plugins that require 10.5 Leopard may not be compatible with TenFourFox running on Mac OS X 10.4 Tiger, even if they are compatible with PowerPC.
## TenFourFox 5 will be the final release to support plugins ##
Plugins on PowerPC are of special concern because Mozilla is making updates to their plugin architecture which may require the plugins themselves to be updated, and there are certain difficult-to-correct bugs with them already on Tiger. Most importantly, Adobe Flash for PowerPC is no longer maintained and has known security risks that can crash or leak data, and QuickTime for Leopard will lose its own support with the release of OS X Lion. In addition, Flash 10.1 is rapidly becoming unsupported by many applications.
Plugins will be maintained through the lifetime of 4.0 (which will end with 4.0.3) and 5.0 (which will end with 6.0). Only crash and stability bugs will be accepted. **In TenFourFox 6.0, plugins will be turned off by default** and no bug reports related to plugins will be accepted.
For Internet video, we strongly recommend the use of [Perian](http://www.perian.org/) and any of the available video download add-ons for Firefox.
For YouTube, we recommend [MacTubes](http://macapps.web.infoseek.co.jp/mactubes/index_en.html). If you have a high end G4 or G5, you can also use WebM for selected videos by visiting http://www.youtube.com/html5 and enabling HTML5 video. This will set a cookie enabling browser-based video without Flash. You do not need a YouTube account for this feature. Not all video is available in WebM.
## New features specific to TenFourFox ##
* All new standard features of Firefox 5.0, including CSS animation, multiple bug fixes, improvements to canvas and graphic display, and a faster browser core.
* JavaScript acceleration is now enabled by default for the browser chrome ([issue 27](https://code.google.com/p/tenfourfox/issues/detail?id=27)), improving overall interface performance.
* JavaScript typed arrays are now accelerated ([issue 32](https://code.google.com/p/tenfourfox/issues/detail?id=32)), improving the speed of performance-critical applications and browser-generated audio.
* Media scaling is now AltiVec accelerated ([issue 64](https://code.google.com/p/tenfourfox/issues/detail?id=64)).
* Fully compatible with the current Mozilla build system ([issue 35](https://code.google.com/p/tenfourfox/issues/detail?id=35)).
## Known issues fixed in this version of TenFourFox ##
* A crash bug in the JavaScript interpreter has been repaired ([issue 63](https://code.google.com/p/tenfourfox/issues/detail?id=63)). This fix will also be in 4.0.3.
* Recursion limits on certain extremely long search expressions in the JavaScript regular expression parser were increased ([issue 67](https://code.google.com/p/tenfourfox/issues/detail?id=67)), allowing extensions such as Ghostery to function correctly. Due to the unconventionality of this fix, it will not appear in 4.0.3, although it affects 4.0.2 also.
## Known issues fixed between beta 2 and RC/final ##
* Certain sites may cause the browser to abnormally leak memory or crash using JavaScript ([issue 68](https://code.google.com/p/tenfourfox/issues/detail?id=68)). This issue was repaired by Mozilla. This issue does not affect 4.0.2 or standard Firefox.
## Known issues specific to TenFourFox ##
* Remember: **Plugins, although most will still work, are _officially deprecated._ Plugins will be turned off by default in TenFourFox 6, and support for them will be removed entirely in a subsequent version.**
* When 10.4Fx has no suggestions for the awesome bar, a blank box appears instead ([issue 21](https://code.google.com/p/tenfourfox/issues/detail?id=21)). This is intentional.
* 10.4Fx does not currently support WebGL or out-of-process plugins, and Indic, Arabic and other scripts requiring glyph reordering or language-specific ligatures may not appear correctly. See TechnicalDifferences for the complete list of changes necessary for 10.4Fx. See [issue 5](https://code.google.com/p/tenfourfox/issues/detail?id=5) for notes specific to the font issue.
* Animation performance is currently poorer in Mozilla 2.0/Firefox 4.0 and later versions using software rendering, which includes 10.4Fx. Mozilla acknowledges this bug, but there is not yet an ETR. See [issue 7](https://code.google.com/p/tenfourfox/issues/detail?id=7).
* The titlebar does not always properly match the menu gradient ([issue 16](https://code.google.com/p/tenfourfox/issues/detail?id=16)). This problem is also in the official release. Installing a Persona may fix this issue if you find it bothersome.
* Crash reporting is intentionally disabled to avoid polluting Mozilla's crash tracking system with our reports. Please use your system's crash logs if you are reporting a _reproducible_ crash, or (if you are able) provide a `gdb` backtrace.
* Although 10.4Fx will tell you when an update is available, you must download updates manually at this time.
You are welcome to report other bugs that you find. However, please **do not report Mozilla bugs to us.** If the bug or crash occurs in both the official Mozilla Firefox 5 _(3.6 doesn't count!)_ and in 10.4Fx, this is a Mozilla bug, and you should file it at [Bugzilla](http://bugzilla.mozilla.org/). **You must test your bug in both places -- bugs that are not confirmed to be part of 10.4Fx will be marked invalid** so that we can keep our task list focused. This is the [current list of known issues](http://code.google.com/p/tenfourfox/issues/list).

51
ReleaseNotes5Beta1.md Normal file
View File

@ -0,0 +1,51 @@
_This document may be updated for late-breaking changes, so check back here if you are having difficulty._
## System requirements ##
TenFourFox (hereafter "10.4Fx") requires a G3 Power Macintosh, Mac OS X 10.4.11, 100MB of free disk space and 256MB of RAM. 512MB of RAM and a G4 or G5 processor is recommended. Video playback is likely to be poor on systems slower than 1.25GHz; a G5 is recommended. Mac OS X 10.5.8 is supported.
Intel Macintoshes are not supported, but the G3 build is known to run under Rosetta in 10.5.8 and should run under Rosetta in Intel 10.4.11. It is not tested with Snow Leopard. 10.4Fx will not run in the Lion Preview, as Lion does not support Rosetta and 10.4Fx is not a Universal binary.
## Getting TenFourFox ##
Make sure you select the appropriate build for your Mac from the [download page](http://www.tenfourfox.com/). The G3 version will run on any supported Macintosh, but it will not take advantage of the additional features of G4 or G5 processors. The G4 and G5 versions will not run correctly on a G3, and the G5 version will perform worse on non-G5 Macintoshes.
If you are using a G4, you should try to choose the correct version for your processor generation (7400 or 7450 "G4e") as performance may be impaired if you run the wrong one. If you don't know which G4 processor you have, the instructions in WhichVersion will tell you how to find out.
## Beta considerations ##
**This version of TenFourFox is a beta.** It is only _mostly_ complete. In particular, there are some late breaking features planned for the final version which are not yet present in this beta (which is equivalent to Mozilla Firefox 5.0 beta 3), and there will be some final additional optimizations specific to 10.4Fx which will be made just prior to final release. **You should know that you are using this software at your own risk. It may cause data loss, security breaches, system instability and crashes. If you are not comfortable with these (remote but possible) possibilities, do not use this beta release.**
## TenFourFox 5.0 is equivalent to Firefox 5.0 ##
TenFourFox uses modified Firefox source code, rewritten to remain compatible with Mac OS X v10.4 and the Power Macintosh. It also contains specific optimizations and special features for PowerPC processors. For this reason, it is not exactly the same as Firefox. However, it is intended to be as compatible with it as possible, including most add-ons and [most standard features](TechnicalDifferences.md). You can treat 10.4Fx as equivalent with Firefox 5.0 in most circumstances, with specific exceptions noted below.
Note that add-ons and plugins which require an Intel Macintosh will not work with TenFourFox, even if they are otherwise compatible with Firefox 5, and add-ons and plugins that require 10.5 Leopard may not be compatible with TenFourFox running on Mac OS X 10.4 Tiger, even if they are compatible with PowerPC.
## New features specific to TenFourFox ##
* All new standard features of Firefox 5.0, including CSS animation, multiple bug fixes, improvements to canvas and graphic display, and a faster browser core.
* JavaScript acceleration is now enabled by default for the browser chrome ([issue 27](https://code.google.com/p/tenfourfox/issues/detail?id=27)), improving overall interface performance.
* JavaScript typed arrays are now accelerated ([issue 32](https://code.google.com/p/tenfourfox/issues/detail?id=32)), improving the speed of performance-critical applications and browser-generated audio.
* Media scaling is now AltiVec accelerated ([issue 64](https://code.google.com/p/tenfourfox/issues/detail?id=64)).
* Fully compatible with the current Mozilla build system ([issue 35](https://code.google.com/p/tenfourfox/issues/detail?id=35)).
## Known issues fixed in this version of TenFourFox ##
* A crash bug in the JavaScript interpreter has been repaired ([issue 63](https://code.google.com/p/tenfourfox/issues/detail?id=63)). This fix will also be in 4.0.3.
## Known issues in beta 1 to be fixed in beta 2 ##
* The Bookmarks menu and widget controls are incorrectly sized or disappear altogether on Leopard ([issue 65](https://code.google.com/p/tenfourfox/issues/detail?id=65)). This will be fixed in beta 2. This issue does not affect Tiger or 4.0.2.
## Known issues specific to TenFourFox ##
* **Plugins, although most will still work, are _officially deprecated._** This is due to security, performance and technical issues from plugins such as Flash and QuickTime which will soon be no longer updated for Power Macintoshes. These plugins represent a future potential means of compromising browser security, and they use older OS APIs that Mozilla will no longer support. While they will still continue to function throughout TenFourFox 5.x, only major bugs will be repaired, and it is possible there may be graphical glitches. **Plugins will be turned off by default in the next major release, and support for them will be removed entirely in a subsequent version.** For more about this, [see this blog entry](http://tenfourfox.blogspot.com/2011/01/plugins-unplugged.html) and [issue 24](https://code.google.com/p/tenfourfox/issues/detail?id=24).
* When 10.4Fx has no suggestions for the awesome bar, a blank box appears instead ([issue 21](https://code.google.com/p/tenfourfox/issues/detail?id=21)). This is intentional.
* 10.4Fx does not currently support WebGL or out-of-process plugins, and Indic, Arabic and other scripts requiring glyph reordering or language-specific ligatures may not appear correctly. See TechnicalDifferences for the complete list of changes necessary for 10.4Fx. See [issue 5](https://code.google.com/p/tenfourfox/issues/detail?id=5) for notes specific to the font issue.
* Animation performance is currently poorer in Mozilla 2.0/Firefox 4.0 and later versions using software rendering, which includes 10.4Fx. Mozilla acknowledges this bug, but there is not yet an ETR. See [issue 7](https://code.google.com/p/tenfourfox/issues/detail?id=7).
* The titlebar does not always properly match the menu gradient ([issue 16](https://code.google.com/p/tenfourfox/issues/detail?id=16)). This problem is also in the official release. Installing a Persona may fix this issue if you find it bothersome.
* Crash reporting is intentionally disabled to avoid polluting Mozilla's crash tracking system with our reports. Please use your system's crash logs if you are reporting a _reproducible_ crash, or (if you are able) provide a `gdb` backtrace.
* Although 10.4Fx will tell you when an update is available, you must download updates manually at this time.
You are welcome to report other bugs that you find. However, please **do not report Mozilla bugs to us.** If the bug or crash occurs in both the official Mozilla Firefox 5 _(3.6 doesn't count!)_ and in 10.4Fx, this is a Mozilla bug, and you should file it at [Bugzilla](http://bugzilla.mozilla.org/). **You must test your bug in both places -- bugs that are not confirmed to be part of 10.4Fx will be marked invalid** so that we can keep our task list focused. This is the [current list of known issues](http://code.google.com/p/tenfourfox/issues/list).

56
ReleaseNotes5Beta2.md Normal file
View File

@ -0,0 +1,56 @@
_This document may be updated for late-breaking changes, so check back here if you are having difficulty._
## System requirements ##
TenFourFox (hereafter "10.4Fx") requires a G3 Power Macintosh, Mac OS X 10.4.11, 100MB of free disk space and 256MB of RAM. 512MB of RAM and a G4 or G5 processor is recommended. Video playback is likely to be poor on systems slower than 1.25GHz; a G5 is recommended. Mac OS X 10.5.8 is supported.
Intel Macintoshes are not supported, but the G3 build is known to run under Rosetta in 10.5.8 and should run under Rosetta in Intel 10.4.11. It is not tested with Snow Leopard. 10.4Fx will not run in the Lion Preview, as Lion does not support Rosetta and 10.4Fx is not a Universal binary.
## Getting TenFourFox ##
Make sure you select the appropriate build for your Mac from the [download page](http://www.tenfourfox.com/). The G3 version will run on any supported Macintosh, but it will not take advantage of the additional features of G4 or G5 processors. The G4 and G5 versions will not run correctly on a G3, and the G5 version will perform worse on non-G5 Macintoshes.
If you are using a G4, you should try to choose the correct version for your processor generation (7400 or 7450 "G4e") as performance may be impaired if you run the wrong one. If you don't know which G4 processor you have, the instructions in WhichVersion will tell you how to find out.
## Beta considerations ##
**This version of TenFourFox is a beta.** It is only _mostly_ complete. In particular, there are some late breaking features planned for the final version which are not yet present in this beta (which approximately corresponds to Mozilla Firefox 5.0 beta 5), and there will be some final additional optimizations specific to 10.4Fx which will be made just prior to final release. **You should know that you are using this software at your own risk. It may cause data loss, security breaches, system instability and crashes. If you are not comfortable with these (remote but possible) possibilities, do not use this beta release.**
## TenFourFox 5.0 is equivalent to Firefox 5.0 ##
TenFourFox uses modified Firefox source code, rewritten to remain compatible with Mac OS X v10.4 and the Power Macintosh. It also contains specific optimizations and special features for PowerPC processors. For this reason, it is not exactly the same as Firefox. However, it is intended to be as compatible with it as possible, including most add-ons and [most standard features](TechnicalDifferences.md). You can treat 10.4Fx as equivalent with Firefox 5.0 in most circumstances, with specific exceptions noted below.
Note that add-ons and plugins which require an Intel Macintosh will not work with TenFourFox, even if they are otherwise compatible with Firefox 5, and add-ons and plugins that require 10.5 Leopard may not be compatible with TenFourFox running on Mac OS X 10.4 Tiger, even if they are compatible with PowerPC.
## New features specific to TenFourFox ##
* All new standard features of Firefox 5.0, including CSS animation, multiple bug fixes, improvements to canvas and graphic display, and a faster browser core.
* JavaScript acceleration is now enabled by default for the browser chrome ([issue 27](https://code.google.com/p/tenfourfox/issues/detail?id=27)), improving overall interface performance.
* JavaScript typed arrays are now accelerated ([issue 32](https://code.google.com/p/tenfourfox/issues/detail?id=32)), improving the speed of performance-critical applications and browser-generated audio.
* Media scaling is now AltiVec accelerated ([issue 64](https://code.google.com/p/tenfourfox/issues/detail?id=64)).
* Fully compatible with the current Mozilla build system ([issue 35](https://code.google.com/p/tenfourfox/issues/detail?id=35)).
## Known issues fixed in this version of TenFourFox ##
* A crash bug in the JavaScript interpreter has been repaired ([issue 63](https://code.google.com/p/tenfourfox/issues/detail?id=63)). This fix will also be in 4.0.3.
* Recursion limits on certain extremely long search expressions in the JavaScript regular expression parser were increased ([issue 67](https://code.google.com/p/tenfourfox/issues/detail?id=67)), allowing extensions such as Ghostery to function correctly. Due to the unconventionality of this fix, it will not appear in 4.0.3, although it affects 4.0.2 also.
## Known issues fixed in this beta ##
* The Bookmarks menu and widget controls were incorrectly sized or disappeared altogether on Leopard ([issue 65](https://code.google.com/p/tenfourfox/issues/detail?id=65)). These constants were corrected. This issue did not affect Tiger or 4.0.2.
## Known issues specific to the beta ##
* Certain sites cannot dynamically insert plugins into the page ([issue 68](https://code.google.com/p/tenfourfox/issues/detail?id=68)) and may cause the browser to crash under particular circumstances. This issue does not affect 4.0.2.
## Known issues specific to TenFourFox ##
* **Plugins, although most will still work, are _officially deprecated._** This is due to security, performance and technical issues from plugins such as Flash and QuickTime which will soon be no longer updated for Power Macintoshes. These plugins represent a future potential means of compromising browser security, and they use older OS APIs that Mozilla will no longer support. While they will still continue to function throughout TenFourFox 5.x, only major bugs will be repaired, and it is possible there may be graphical glitches. **Plugins will be turned off by default in the next major release, and support for them will be removed entirely in a subsequent version.** For more about this, [see this blog entry](http://tenfourfox.blogspot.com/2011/01/plugins-unplugged.html) and [issue 24](https://code.google.com/p/tenfourfox/issues/detail?id=24).
* When 10.4Fx has no suggestions for the awesome bar, a blank box appears instead ([issue 21](https://code.google.com/p/tenfourfox/issues/detail?id=21)). This is intentional.
* 10.4Fx does not currently support WebGL or out-of-process plugins, and Indic, Arabic and other scripts requiring glyph reordering or language-specific ligatures may not appear correctly. See TechnicalDifferences for the complete list of changes necessary for 10.4Fx. See [issue 5](https://code.google.com/p/tenfourfox/issues/detail?id=5) for notes specific to the font issue.
* Animation performance is currently poorer in Mozilla 2.0/Firefox 4.0 and later versions using software rendering, which includes 10.4Fx. Mozilla acknowledges this bug, but there is not yet an ETR. See [issue 7](https://code.google.com/p/tenfourfox/issues/detail?id=7).
* The titlebar does not always properly match the menu gradient ([issue 16](https://code.google.com/p/tenfourfox/issues/detail?id=16)). This problem is also in the official release. Installing a Persona may fix this issue if you find it bothersome.
* Crash reporting is intentionally disabled to avoid polluting Mozilla's crash tracking system with our reports. Please use your system's crash logs if you are reporting a _reproducible_ crash, or (if you are able) provide a `gdb` backtrace.
* Although 10.4Fx will tell you when an update is available, you must download updates manually at this time.
You are welcome to report other bugs that you find. However, please **do not report Mozilla bugs to us.** If the bug or crash occurs in both the official Mozilla Firefox 5 _(3.6 doesn't count!)_ and in 10.4Fx, this is a Mozilla bug, and you should file it at [Bugzilla](http://bugzilla.mozilla.org/). **You must test your bug in both places -- bugs that are not confirmed to be part of 10.4Fx will be marked invalid** so that we can keep our task list focused. This is the [current list of known issues](http://code.google.com/p/tenfourfox/issues/list).

62
ReleaseNotes60.md Normal file
View File

@ -0,0 +1,62 @@
_This document may be updated for late-breaking changes, so check back here if you are having difficulty._
## System requirements ##
TenFourFox (hereafter "10.4Fx") requires a G3 Power Macintosh, Mac OS X 10.4.11, 100MB of free disk space and 256MB of RAM. 512MB of RAM and a G4 or G5 processor is recommended. Video playback is likely to be poor on systems slower than 1.25GHz; a G5 is recommended. Mac OS X 10.5.8 is supported.
Intel Macintoshes are not supported, but the G3 build is known to run under Rosetta in 10.5.8 and should run under Rosetta in Intel 10.4.11. It is not tested with Snow Leopard. 10.4Fx will not run under 10.7 Lion, as Lion does not support Rosetta and 10.4Fx is not a Universal binary.
## Getting TenFourFox ##
Make sure you select the appropriate build for your Mac from the [download page](http://www.tenfourfox.com/). The G3 version will run on any supported Macintosh, but it will not take advantage of the additional features of G4 or G5 processors. The G4 and G5 versions will not run correctly on a G3, and the G5 version will perform worse on non-G5 Macintoshes.
If you are using a G4, you should try to choose the correct version for your processor generation (7400 or 7450 "G4e") as performance may be impaired if you run the wrong one. If you don't know which G4 processor you have, the instructions in WhichVersion will tell you how to find out.
## TenFourFox 6.0 is equivalent to Firefox 6.0 ##
TenFourFox uses modified Firefox source code, rewritten to remain compatible with Mac OS X v10.4 and the Power Macintosh. It also contains specific optimizations and special features for PowerPC processors. For this reason, it is not exactly the same as Firefox. However, it is intended to be as compatible with it as possible, including most add-ons and [most standard features](TechnicalDifferences.md). You can treat 10.4Fx as equivalent with Firefox 6.0 in most circumstances, with specific exceptions noted below.
Note that add-ons which require an Intel Macintosh will not work with TenFourFox, even if they are otherwise compatible with Firefox 6, and add-ons that require 10.5 Leopard may not be compatible with TenFourFox running on Mac OS X 10.4 Tiger, even if they are compatible with PowerPC.
**Due to a serious bug found late in testing, the original TenFourFox 6.0 release candidate was retracted.** If you are using a build of 10.4Fx built prior to August 15, please download the latest binary.
## TenFourFox no longer supports plugins or Flash ##
Plugins on PowerPC are of special concern because Mozilla is making updates to their plugin architecture which may require the plugins themselves to be updated, and there are certain difficult-to-correct bugs with them already on Tiger. Most importantly, Adobe Flash for PowerPC is no longer maintained and has known security risks that can crash or leak data, and QuickTime for Leopard will lose its own support with the release of OS X Lion. In addition, Flash 10.1 is rapidly becoming unsupported by many applications.
**As of TenFourFox 6.0, for these and other reasons (for details, see PluginsNoLongerSupported), plugin support ships disabled.** Plugins will not operate by default, and bug reports will no longer be accepted. Sites will now act as if no plugins were installed at all.
For Internet video, we strongly recommend the use of [Perian](http://www.perian.org/) and any of the available video download add-ons for Firefox.
For YouTube, we recommend [MacTubes](http://macapps.web.infoseek.co.jp/mactubes/index_en.html). If you have a high end G4 or G5, you can also use WebM for selected videos by visiting http://www.youtube.com/html5 and enabling HTML5 video. This will set a temporary cookie enabling browser-based video without Flash. You do not need a YouTube account for this feature, but you may need to periodically renew the cookie setting. Not all video is available in WebM.
For a more in-depth explanation of this policy and other workarounds, see PluginsNoLongerSupported.
## New features specific to TenFourFox ##
* All new standard features of Firefox 6.0, including improved network performance, Web Sockets, media queries, and additional HTML5 support; as well as security and stability improvements to 5.0.
* Additional performance improvements to colour and media scaling with AltiVec ([issue 64](https://code.google.com/p/tenfourfox/issues/detail?id=64)).
* Dynamically adding text nodes to documents is now AltiVec-accelerated ([issue 75](https://code.google.com/p/tenfourfox/issues/detail?id=75)).
* Conversion of UTF-8 to Unicode is now AltiVec-accelerated ([issue 76](https://code.google.com/p/tenfourfox/issues/detail?id=76)).
## Known issues fixed in TenFourFox 6 ##
* An issue with Twitter and other sites with extremely long JavaScript regular expression searches has been repaired ([issue 77](https://code.google.com/p/tenfourfox/issues/detail?id=77)). This issue affected 5.0 and 4.0.3.
* Certain spurious debugging messages to the console are now suppressed ([issue 70](https://code.google.com/p/tenfourfox/issues/detail?id=70)). This issue only affected 5.0.
## Known issues fixed from earlier versions of 6.0 beta/RC ##
* Progress bars no longer shift when a window is activated or inactivated on 10.5 ([issue 81](https://code.google.com/p/tenfourfox/issues/detail?id=81)).
* Printing and print preview now work correctly on 10.4 ([issue 82](https://code.google.com/p/tenfourfox/issues/detail?id=82)).
## Known issues specific to TenFourFox ##
* Remember: **Plugins are turned off by default, and code for them will fail to function entirely in a subsequent version.** See PluginsNoLongerSupported for an explanation and suggested workarounds.
* When 10.4Fx has no suggestions for the awesome bar, a blank box appears instead ([issue 21](https://code.google.com/p/tenfourfox/issues/detail?id=21)). This is intentional.
* 10.4Fx does not currently support WebGL or out-of-process plugins, and Indic, Arabic and other scripts requiring glyph reordering or language-specific ligatures may not appear correctly. See TechnicalDifferences for the complete list of changes necessary for 10.4Fx. See [issue 5](https://code.google.com/p/tenfourfox/issues/detail?id=5) for notes specific to the font issue.
* Animation performance is currently poorer in Mozilla 2.0/Firefox 4.0 and later versions using software rendering, which includes 10.4Fx. Mozilla acknowledges this bug, but there is not yet an ETR. See [issue 7](https://code.google.com/p/tenfourfox/issues/detail?id=7).
* The titlebar does not always properly match the menu gradient ([issue 16](https://code.google.com/p/tenfourfox/issues/detail?id=16)). This problem is also in the official release. Installing a Persona may fix this issue if you find it bothersome.
* Crash reporting is intentionally disabled to avoid polluting Mozilla's crash tracking system with our reports. Please use your system's crash logs if you are reporting a _reproducible_ crash, or (if you are able) provide a `gdb` backtrace.
* Although 10.4Fx will tell you when an update is available, you must download updates manually at this time.
You are welcome to report other bugs that you find. However, please **do not report Mozilla bugs to us.** If the bug or crash occurs in both the official Mozilla Firefox 6 _(3.6 doesn't count!)_ and in 10.4Fx, this is a Mozilla bug, and you should file it at [Bugzilla](http://bugzilla.mozilla.org/). **You must test your bug in both places -- bugs that are not confirmed to be part of 10.4Fx will be marked invalid** so that we can keep our task list focused. This is the [current list of known issues](http://code.google.com/p/tenfourfox/issues/list).

51
ReleaseNotes601.md Normal file
View File

@ -0,0 +1,51 @@
_This document may be updated for late-breaking changes, so check back here if you are having difficulty._
## System requirements ##
TenFourFox (hereafter "10.4Fx") requires a G3 Power Macintosh, Mac OS X 10.4.11, 100MB of free disk space and 256MB of RAM. 512MB of RAM and a G4 or G5 processor is recommended. Video playback is likely to be poor on systems slower than 1.25GHz; a G5 is recommended. Mac OS X 10.5.8 is supported.
Intel Macintoshes are not supported, but the G3 build is known to run under Rosetta in 10.5.8 and should run under Rosetta in Intel 10.4.11. It is not tested with Snow Leopard. 10.4Fx will not run under 10.7 Lion, as Lion does not support Rosetta and 10.4Fx is not a Universal binary.
## Getting TenFourFox ##
Make sure you select the appropriate build for your Mac from the [download page](http://www.tenfourfox.com/). The G3 version will run on any supported Macintosh, but it will not take advantage of the additional features of G4 or G5 processors. The G4 and G5 versions will not run correctly on a G3, and the G5 version will perform worse on non-G5 Macintoshes.
If you are using a G4, you should try to choose the correct version for your processor generation (7400 or 7450 "G4e") as performance may be impaired if you run the wrong one. If you don't know which G4 processor you have, the instructions in WhichVersion will tell you how to find out.
## TenFourFox 6.0.1 is equivalent to Firefox 6.0.1 ##
TenFourFox uses modified Firefox source code, rewritten to remain compatible with Mac OS X v10.4 and the Power Macintosh. It also contains specific optimizations and special features for PowerPC processors. For this reason, it is not exactly the same as Firefox. However, it is intended to be as compatible with it as possible, including most add-ons and [most standard features](TechnicalDifferences.md). You can treat 10.4Fx as equivalent with Firefox 6.0 in most circumstances, with specific exceptions noted below.
Note that add-ons which require an Intel Macintosh will not work with TenFourFox, even if they are otherwise compatible with Firefox 6, and add-ons that require 10.5 Leopard may not be compatible with TenFourFox running on Mac OS X 10.4 Tiger, even if they are compatible with PowerPC.
6.0.1 is a security update for TenFourFox repairing [an issue with fraudulent SSL certificates](http://blog.mozilla.com/security/2011/08/29/fraudulent-google-com-certificate/). This fix is also part of Firefox 6.0.1. It is strongly advised for all users of TenFourFox.
## TenFourFox no longer supports plugins or Flash ##
Plugins on PowerPC are of special concern because Mozilla is making updates to their plugin architecture which may require the plugins themselves to be updated, and there are certain difficult-to-correct bugs with them already on Tiger. Most importantly, Adobe Flash for PowerPC is no longer maintained and has known security risks that can crash or leak data, and QuickTime for Leopard will lose its own support with the release of OS X Lion. In addition, Flash 10.1 is rapidly becoming unsupported by many applications.
**As of TenFourFox 6.0, for these and other reasons (for details, see PluginsNoLongerSupported), plugin support ships disabled.** Plugins will not operate by default, and bug reports will no longer be accepted. Sites will now act as if no plugins were installed at all.
For Internet video, we strongly recommend the use of [Perian](http://www.perian.org/) and any of the available video download add-ons for Firefox.
For YouTube, we recommend [MacTubes](http://macapps.web.infoseek.co.jp/mactubes/index_en.html). If you have a high end G4 or G5, you can also use WebM for selected videos by visiting http://www.youtube.com/html5 and enabling HTML5 video. This will set a temporary cookie enabling browser-based video without Flash. You do not need a YouTube account for this feature, but you may need to periodically renew the cookie setting. Not all video is available in WebM.
For a more in-depth explanation of this policy and other workarounds, see PluginsNoLongerSupported.
## Known issues fixed in TenFourFox 6.0.1 ##
* An issue with certificates issued by a compromised certificate authority has been corrected by blacklisting the CA (DigiNotar) and certificates believed to have been issued during the vulnerable period. This is tracked as Mozilla [bug 682927](https://code.google.com/p/tenfourfox/issues/detail?id=82927). **All previous versions of Firefox and TenFourFox are affected.**
For a list of general changes in 10.4Fx 6.0, please see ReleaseNotes60 for all new and corrected issues.
## Known issues specific to TenFourFox ##
* Remember: **Plugins are turned off by default, and code for them will fail to function entirely in a subsequent version.** See PluginsNoLongerSupported for an explanation and suggested workarounds.
* When 10.4Fx has no suggestions for the awesome bar, a blank box appears instead ([issue 21](https://code.google.com/p/tenfourfox/issues/detail?id=21)). This is intentional.
* 10.4Fx does not currently support WebGL or out-of-process plugins, and Indic, Arabic and other scripts requiring glyph reordering or language-specific ligatures may not appear correctly. See TechnicalDifferences for the complete list of changes necessary for 10.4Fx. See [issue 5](https://code.google.com/p/tenfourfox/issues/detail?id=5) for notes specific to the font issue.
* Animation performance is currently poorer in Mozilla 2.0/Firefox 4.0 and later versions using software rendering, which includes 10.4Fx. Mozilla acknowledges this bug, but there is not yet an ETR. See [issue 7](https://code.google.com/p/tenfourfox/issues/detail?id=7).
* The titlebar does not always properly match the menu gradient ([issue 16](https://code.google.com/p/tenfourfox/issues/detail?id=16)). This problem is also in the official release. Installing a Persona may fix this issue if you find it bothersome.
* Crash reporting is intentionally disabled to avoid polluting Mozilla's crash tracking system with our reports. Please use your system's crash logs if you are reporting a _reproducible_ crash, or (if you are able) provide a `gdb` backtrace.
* Although 10.4Fx will tell you when an update is available, you must download updates manually at this time.
You are welcome to report other bugs that you find. However, please **do not report Mozilla bugs to us.** If the bug or crash occurs in both the official Mozilla Firefox 6 _(3.6 doesn't count!)_ and in 10.4Fx, this is a Mozilla bug, and you should file it at [Bugzilla](http://bugzilla.mozilla.org/). **You must test your bug in both places -- bugs that are not confirmed to be part of 10.4Fx will be marked invalid** so that we can keep our task list focused. This is the [current list of known issues](http://code.google.com/p/tenfourfox/issues/list).

59
ReleaseNotes6Beta1.md Normal file
View File

@ -0,0 +1,59 @@
_This document may be updated for late-breaking changes, so check back here if you are having difficulty._
## System requirements ##
TenFourFox (hereafter "10.4Fx") requires a G3 Power Macintosh, Mac OS X 10.4.11, 100MB of free disk space and 256MB of RAM. 512MB of RAM and a G4 or G5 processor is recommended. Video playback is likely to be poor on systems slower than 1.25GHz; a G5 is recommended. Mac OS X 10.5.8 is supported.
Intel Macintoshes are not supported, but the G3 build is known to run under Rosetta in 10.5.8 and should run under Rosetta in Intel 10.4.11. It is not tested with Snow Leopard. 10.4Fx will not run under 10.7 Lion, as Lion does not support Rosetta and 10.4Fx is not a Universal binary.
## Getting TenFourFox ##
Make sure you select the appropriate build for your Mac from the [download page](http://www.tenfourfox.com/). The G3 version will run on any supported Macintosh, but it will not take advantage of the additional features of G4 or G5 processors. The G4 and G5 versions will not run correctly on a G3, and the G5 version will perform worse on non-G5 Macintoshes.
If you are using a G4, you should try to choose the correct version for your processor generation (7400 or 7450 "G4e") as performance may be impaired if you run the wrong one. If you don't know which G4 processor you have, the instructions in WhichVersion will tell you how to find out.
## Beta considerations ##
**This version of TenFourFox is a beta.** It is only _mostly_ complete. In particular, there are some late breaking features planned for the final version which are not yet present in this beta (which is equivalent to Mozilla Firefox 6.0 beta 2), and there will be some final additional optimizations specific to 10.4Fx which will be made just prior to final release. **You should know that you are using this software at your own risk. It may cause data loss, security breaches, system instability and crashes. If you are not comfortable with these (remote but possible) possibilities, do not use this beta release.**
## TenFourFox 6.0 is equivalent to Firefox 6.0 ##
TenFourFox uses modified Firefox source code, rewritten to remain compatible with Mac OS X v10.4 and the Power Macintosh. It also contains specific optimizations and special features for PowerPC processors. For this reason, it is not exactly the same as Firefox. However, it is intended to be as compatible with it as possible, including most add-ons and [most standard features](TechnicalDifferences.md). You can treat 10.4Fx as equivalent with Firefox 6.0 in most circumstances, with specific exceptions noted below.
Note that add-ons which require an Intel Macintosh will not work with TenFourFox, even if they are otherwise compatible with Firefox 6, and add-ons that require 10.5 Leopard may not be compatible with TenFourFox running on Mac OS X 10.4 Tiger, even if they are compatible with PowerPC.
## TenFourFox no longer supports plugins or Flash ##
Plugins on PowerPC are of special concern because Mozilla is making updates to their plugin architecture which may require the plugins themselves to be updated, and there are certain difficult-to-correct bugs with them already on Tiger. Most importantly, Adobe Flash for PowerPC is no longer maintained and has known security risks that can crash or leak data, and QuickTime for Leopard will lose its own support with the release of OS X Lion. In addition, Flash 10.1 is rapidly becoming unsupported by many applications.
**As of TenFourFox 6.0, for these and other reasons (for details, see PluginsNoLongerSupported), plugin support ships disabled.** Plugins will not operate by default, and bug reports will no longer be accepted. Sites will now act as if no plugins were installed at all.
For Internet video, we strongly recommend the use of [Perian](http://www.perian.org/) and any of the available video download add-ons for Firefox.
For YouTube, we recommend [MacTubes](http://macapps.web.infoseek.co.jp/mactubes/index_en.html). If you have a high end G4 or G5, you can also use WebM for selected videos by visiting http://www.youtube.com/html5 and enabling HTML5 video. This will set a temporary cookie enabling browser-based video without Flash. You do not need a YouTube account for this feature, but you may need to periodically renew the cookie setting. Not all video is available in WebM.
For a more in-depth explanation of this policy and other workarounds, see PluginsNoLongerSupported.
## New features specific to TenFourFox ##
* All new standard features of Firefox 6.0, including improved network performance, Web Sockets, media queries, and additional HTML5 support; as well as security and stability improvements to 5.0.
* Additional performance improvements to colour and media scaling with AltiVec ([issue 64](https://code.google.com/p/tenfourfox/issues/detail?id=64)).
* Dynamically adding text nodes to documents is now AltiVec-accelerated ([issue 75](https://code.google.com/p/tenfourfox/issues/detail?id=75)).
* Conversion of UTF-8 to Unicode is now AltiVec-accelerated ([issue 76](https://code.google.com/p/tenfourfox/issues/detail?id=76)).
## Known issues fixed in this version of TenFourFox ##
* An issue with Twitter and other sites with extremely long JavaScript regular expression searches has been repaired ([issue 77](https://code.google.com/p/tenfourfox/issues/detail?id=77)). This issue affected 5.0 and 4.0.3.
* Certain spurious debugging messages to the console are now suppressed ([issue 70](https://code.google.com/p/tenfourfox/issues/detail?id=70)). This issue only affected 5.0.
## Known issues specific to TenFourFox ##
* Remember: **Plugins are turned off by default, and code for them will fail to function entirely in a subsequent version.** See PluginsNoLongerSupported for an explanation and suggested workarounds.
* When 10.4Fx has no suggestions for the awesome bar, a blank box appears instead ([issue 21](https://code.google.com/p/tenfourfox/issues/detail?id=21)). This is intentional.
* 10.4Fx does not currently support WebGL or out-of-process plugins, and Indic, Arabic and other scripts requiring glyph reordering or language-specific ligatures may not appear correctly. See TechnicalDifferences for the complete list of changes necessary for 10.4Fx. See [issue 5](https://code.google.com/p/tenfourfox/issues/detail?id=5) for notes specific to the font issue.
* Animation performance is currently poorer in Mozilla 2.0/Firefox 4.0 and later versions using software rendering, which includes 10.4Fx. Mozilla acknowledges this bug, but there is not yet an ETR. See [issue 7](https://code.google.com/p/tenfourfox/issues/detail?id=7).
* The titlebar does not always properly match the menu gradient ([issue 16](https://code.google.com/p/tenfourfox/issues/detail?id=16)). This problem is also in the official release. Installing a Persona may fix this issue if you find it bothersome.
* Crash reporting is intentionally disabled to avoid polluting Mozilla's crash tracking system with our reports. Please use your system's crash logs if you are reporting a _reproducible_ crash, or (if you are able) provide a `gdb` backtrace.
* Although 10.4Fx will tell you when an update is available, you must download updates manually at this time.
You are welcome to report other bugs that you find. However, please **do not report Mozilla bugs to us.** If the bug or crash occurs in both the official Mozilla Firefox 6 _(3.6 doesn't count!)_ and in 10.4Fx, this is a Mozilla bug, and you should file it at [Bugzilla](http://bugzilla.mozilla.org/). **You must test your bug in both places -- bugs that are not confirmed to be part of 10.4Fx will be marked invalid** so that we can keep our task list focused. This is the [current list of known issues](http://code.google.com/p/tenfourfox/issues/list).

51
ReleaseNotes70.md Normal file
View File

@ -0,0 +1,51 @@
_This document may be updated for late-breaking changes, so check back here if you are having difficulty._
## System requirements ##
TenFourFox (hereafter "10.4Fx") requires a G3 Power Macintosh, Mac OS X 10.4.11, 100MB of free disk space and 512MB of RAM. **Systems with 256MB of RAM are no longer supported as of 7.0.** 768MB of RAM and a G4 or G5 processor is recommended. Video playback is likely to be poor on systems slower than 1.25GHz; a G5 is recommended. Mac OS X 10.5.8 is supported.
Intel Macintoshes are not supported, but the G3 build is known to run under Rosetta in 10.5.8 and should run under Rosetta in Intel 10.4.11. It is not tested with Snow Leopard. 10.4Fx will not run under 10.7 Lion, as Lion does not support Rosetta and 10.4Fx is not a Universal binary.
## Getting TenFourFox ##
Make sure you select the appropriate build for your Mac from the [download page](http://www.tenfourfox.com/). The G3 version will run on any supported Macintosh, but it will not take advantage of the additional features of G4 or G5 processors. The G4 and G5 versions will not run correctly on a G3, and the G5 version will perform worse on non-G5 Macintoshes.
If you are using a G4, you should try to choose the correct version for your processor generation (7400 or 7450 "G4e") as performance may be impaired if you run the wrong one. If you don't know which G4 processor you have, the instructions in WhichVersion will tell you how to find out.
## TenFourFox 7.0 is equivalent to Firefox 7.0 ##
TenFourFox uses modified Firefox source code, rewritten to remain compatible with Mac OS X v10.4 and the Power Macintosh. It also contains specific optimizations and special features for PowerPC processors. For this reason, it is not exactly the same as Firefox. However, it is intended to be as compatible with it as possible, including most add-ons and [most standard features](TechnicalDifferences.md). You can treat 10.4Fx as equivalent with Firefox 7.0 in most circumstances, with specific exceptions noted below.
Note that add-ons which require an Intel Macintosh will not work with TenFourFox, even if they are otherwise compatible with Firefox 7, and add-ons that require 10.5 Leopard may not be compatible with TenFourFox running on Mac OS X 10.4 Tiger, even if they are compatible with PowerPC.
## TenFourFox no longer supports plugins or Flash ##
Plugins on PowerPC are of special concern because Mozilla is making updates to their plugin architecture which may require the plugins themselves to be updated, and there are certain difficult-to-correct bugs with them already on Tiger. Most importantly, Adobe Flash for PowerPC is no longer maintained and has known security risks that can crash or leak data, and QuickTime for Leopard will lose its own support with the release of OS X Lion. In addition, Flash 10.1 is rapidly becoming unsupported by many applications.
**As of TenFourFox 6.0, for these and other reasons (for details, see PluginsNoLongerSupported), plugin support ships disabled.** Plugins will not operate by default, and bug reports will no longer be accepted. Sites will now act as if no plugins were installed at all.
For Internet video, we strongly recommend the use of [Perian](http://www.perian.org/) and any of the available video download add-ons for Firefox.
For YouTube, we recommend [MacTubes](http://macapps.web.infoseek.co.jp/mactubes/index_en.html). If you have a high end G4 or G5, you can also use WebM for selected videos by visiting http://www.youtube.com/html5 and enabling HTML5 video. This will set a temporary cookie enabling browser-based video without Flash. You do not need a YouTube account for this feature, but you may need to periodically renew the cookie setting. Not all video is available in WebM.
For a more in-depth explanation of this policy and other workarounds, see PluginsNoLongerSupported.
## New features specific to TenFourFox ##
* All new standard features of Firefox 7.0, including memory usage improvements, faster graphics performance and performance analytics.
## Known issues fixed in this version of TenFourFox ##
* An issue with complex JavaScript crashing the browser has been repaired ([issue 85](https://code.google.com/p/tenfourfox/issues/detail?id=85)). This bug affects all prior versions of 10.4Fx.
## Known issues specific to TenFourFox ##
* Remember: **Plugins are turned off by default, and code for them will fail to function entirely in a subsequent version.** See PluginsNoLongerSupported for an explanation and suggested workarounds.
* When 10.4Fx has no suggestions for the awesome bar, a blank box appears instead ([issue 21](https://code.google.com/p/tenfourfox/issues/detail?id=21)). This is intentional.
* 10.4Fx does not currently support WebGL or out-of-process plugins, and Indic, Arabic and other scripts requiring glyph reordering or language-specific ligatures may not appear correctly. See TechnicalDifferences for the complete list of changes necessary for 10.4Fx. See [issue 5](https://code.google.com/p/tenfourfox/issues/detail?id=5) for notes specific to the font issue.
* Animation performance is currently poorer in Mozilla 2.0/Firefox 4.0 and later versions using software rendering, which includes 10.4Fx. Mozilla acknowledges this bug, but there is not yet an ETR. See [issue 7](https://code.google.com/p/tenfourfox/issues/detail?id=7).
* The titlebar does not always properly match the menu gradient ([issue 16](https://code.google.com/p/tenfourfox/issues/detail?id=16)). This problem is also in the official release. Installing a Persona may fix this issue if you find it bothersome.
* Crash reporting is intentionally disabled to avoid polluting Mozilla's crash tracking system with our reports. Please use your system's crash logs if you are reporting a _reproducible_ crash, or (if you are able) provide a `gdb` backtrace.
* Although 10.4Fx will tell you when an update is available, you must download updates manually at this time.
You are welcome to report other bugs that you find. However, please **do not report Mozilla bugs to us.** If the bug or crash occurs in both the official Mozilla Firefox 7 _(3.6 doesn't count!)_ and in 10.4Fx, this is a Mozilla bug, and you should file it at [Bugzilla](http://bugzilla.mozilla.org/). **You must test your bug in both places -- bugs that are not confirmed to be part of 10.4Fx will be marked invalid** so that we can keep our task list focused. This is the [current list of known issues](http://code.google.com/p/tenfourfox/issues/list).

56
ReleaseNotes7Beta1.md Normal file
View File

@ -0,0 +1,56 @@
_This document may be updated for late-breaking changes, so check back here if you are having difficulty._
## System requirements ##
TenFourFox (hereafter "10.4Fx") requires a G3 Power Macintosh, Mac OS X 10.4.11, 100MB of free disk space and 512MB of RAM. **Systems with 256MB of RAM are no longer supported as of 7.0.** 768MB of RAM and a G4 or G5 processor is recommended. Video playback is likely to be poor on systems slower than 1.25GHz; a G5 is recommended. Mac OS X 10.5.8 is supported.
Intel Macintoshes are not supported, but the G3 build is known to run under Rosetta in 10.5.8 and should run under Rosetta in Intel 10.4.11. It is not tested with Snow Leopard. 10.4Fx will not run under 10.7 Lion, as Lion does not support Rosetta and 10.4Fx is not a Universal binary.
## Getting TenFourFox ##
Make sure you select the appropriate build for your Mac from the [download page](http://www.tenfourfox.com/). The G3 version will run on any supported Macintosh, but it will not take advantage of the additional features of G4 or G5 processors. The G4 and G5 versions will not run correctly on a G3, and the G5 version will perform worse on non-G5 Macintoshes.
If you are using a G4, you should try to choose the correct version for your processor generation (7400 or 7450 "G4e") as performance may be impaired if you run the wrong one. If you don't know which G4 processor you have, the instructions in WhichVersion will tell you how to find out.
## Beta considerations ##
**This version of TenFourFox is a beta.** It is only _mostly_ complete. In particular, there are some late breaking features planned for the final version which are not yet present in this beta (which is equivalent to Mozilla Firefox 7.0 beta 4), and there will be some final additional optimizations specific to 10.4Fx which will be made just prior to final release. **You should know that you are using this software at your own risk. It may cause data loss, security breaches, system instability and crashes. If you are not comfortable with these (remote but possible) possibilities, do not use this beta release.**
## TenFourFox 7.0 is equivalent to Firefox 7.0 ##
TenFourFox uses modified Firefox source code, rewritten to remain compatible with Mac OS X v10.4 and the Power Macintosh. It also contains specific optimizations and special features for PowerPC processors. For this reason, it is not exactly the same as Firefox. However, it is intended to be as compatible with it as possible, including most add-ons and [most standard features](TechnicalDifferences.md). You can treat 10.4Fx as equivalent with Firefox 7.0 in most circumstances, with specific exceptions noted below.
Note that add-ons which require an Intel Macintosh will not work with TenFourFox, even if they are otherwise compatible with Firefox 7, and add-ons that require 10.5 Leopard may not be compatible with TenFourFox running on Mac OS X 10.4 Tiger, even if they are compatible with PowerPC.
## TenFourFox no longer supports plugins or Flash ##
Plugins on PowerPC are of special concern because Mozilla is making updates to their plugin architecture which may require the plugins themselves to be updated, and there are certain difficult-to-correct bugs with them already on Tiger. Most importantly, Adobe Flash for PowerPC is no longer maintained and has known security risks that can crash or leak data, and QuickTime for Leopard will lose its own support with the release of OS X Lion. In addition, Flash 10.1 is rapidly becoming unsupported by many applications.
**As of TenFourFox 6.0, for these and other reasons (for details, see PluginsNoLongerSupported), plugin support ships disabled.** Plugins will not operate by default, and bug reports will no longer be accepted. Sites will now act as if no plugins were installed at all.
For Internet video, we strongly recommend the use of [Perian](http://www.perian.org/) and any of the available video download add-ons for Firefox.
For YouTube, we recommend [MacTubes](http://macapps.web.infoseek.co.jp/mactubes/index_en.html). If you have a high end G4 or G5, you can also use WebM for selected videos by visiting http://www.youtube.com/html5 and enabling HTML5 video. This will set a temporary cookie enabling browser-based video without Flash. You do not need a YouTube account for this feature, but you may need to periodically renew the cookie setting. Not all video is available in WebM.
For a more in-depth explanation of this policy and other workarounds, see PluginsNoLongerSupported.
## New features specific to TenFourFox ##
* All new standard features of Firefox 7.0, including memory usage improvements, faster graphics performance and performance analytics.
## Known issues fixed in this version of TenFourFox ##
* An issue with repeatedly triggering drop downs on 10.5 causing browser unresponsiveness has been mitigated ([issue 72](https://code.google.com/p/tenfourfox/issues/detail?id=72)). This bug affects all prior versions of 10.4Fx.
* An issue with complex JavaScript crashing the browser has been repaired ([issue 85](https://code.google.com/p/tenfourfox/issues/detail?id=85)). This bug affects all prior versions of 10.4Fx.
## Known issues specific to TenFourFox ##
* Remember: **Plugins are turned off by default, and code for them will fail to function entirely in a subsequent version.** See PluginsNoLongerSupported for an explanation and suggested workarounds.
* When 10.4Fx has no suggestions for the awesome bar, a blank box appears instead ([issue 21](https://code.google.com/p/tenfourfox/issues/detail?id=21)). This is intentional.
* 10.4Fx does not currently support WebGL or out-of-process plugins, and Indic, Arabic and other scripts requiring glyph reordering or language-specific ligatures may not appear correctly. See TechnicalDifferences for the complete list of changes necessary for 10.4Fx. See [issue 5](https://code.google.com/p/tenfourfox/issues/detail?id=5) for notes specific to the font issue.
* Animation performance is currently poorer in Mozilla 2.0/Firefox 4.0 and later versions using software rendering, which includes 10.4Fx. Mozilla acknowledges this bug, but there is not yet an ETR. See [issue 7](https://code.google.com/p/tenfourfox/issues/detail?id=7).
* The titlebar does not always properly match the menu gradient ([issue 16](https://code.google.com/p/tenfourfox/issues/detail?id=16)). This problem is also in the official release. Installing a Persona may fix this issue if you find it bothersome.
* Crash reporting is intentionally disabled to avoid polluting Mozilla's crash tracking system with our reports. Please use your system's crash logs if you are reporting a _reproducible_ crash, or (if you are able) provide a `gdb` backtrace.
* Although 10.4Fx will tell you when an update is available, you must download updates manually at this time.
You are welcome to report other bugs that you find. However, please **do not report Mozilla bugs to us.** If the bug or crash occurs in both the official Mozilla Firefox 7 _(3.6 doesn't count!)_ and in 10.4Fx, this is a Mozilla bug, and you should file it at [Bugzilla](http://bugzilla.mozilla.org/). **You must test your bug in both places -- bugs that are not confirmed to be part of 10.4Fx will be marked invalid** so that we can keep our task list focused. This is the [current list of known issues](http://code.google.com/p/tenfourfox/issues/list).

66
ReleaseNotes80.md Normal file
View File

@ -0,0 +1,66 @@
_This document may be updated for late-breaking changes, so check back here if you are having difficulty._
## System requirements ##
TenFourFox (hereafter "10.4Fx") requires a G3 Power Macintosh, Mac OS X 10.4.11, 100MB of free disk space and 512MB of RAM. 768MB of RAM and a G4 or G5 processor is recommended. Video playback is likely to be poor on systems slower than 1.25GHz; a G5 is recommended. Mac OS X 10.5.8 is supported.
Intel Macintoshes are not supported, but the G3 build is known to run under Rosetta in 10.5.8 and should run under Rosetta in Intel 10.4.11. It is not tested with Snow Leopard. 10.4Fx will not run under 10.7 Lion, as Lion does not support Rosetta and 10.4Fx is not a Universal binary.
## Getting TenFourFox ##
Make sure you select the appropriate build for your Mac from the [download page](http://www.tenfourfox.com/). The G3 version will run on any supported Macintosh, but it will not take advantage of the additional features of G4 or G5 processors. The G4 and G5 versions will not run correctly on a G3, and the G5 version will perform worse on non-G5 Macintoshes.
If you are using a G4, you should try to choose the correct version for your processor generation (7400 or 7450 "G4e") as performance may be impaired if you run the wrong one. If you don't know which G4 processor you have, the instructions in WhichVersion will tell you how to find out.
## If you are updating from Firefox 3.5 or earlier ##
Your profile may have issues when you update directly to this version, which may cause TenFourFox to start or behave improperly. You may wish to update your system to Firefox 3.6 first, and then update to TenFourFox, to make sure your profile and bookmarks are properly updated. Note that once you do, it may not be possible to use your old profile with the earlier version of Firefox. See [the FAQ](AAATheFAQ.md) for possible workarounds or other solutions.
## TenFourFox 8.0 is equivalent to Firefox 8.0 ##
TenFourFox uses modified Firefox source code, rewritten to remain compatible with Mac OS X v10.4 and the Power Macintosh. It also contains specific optimizations and special features for PowerPC processors. For this reason, it is not exactly the same as Firefox. However, it is intended to be as compatible with it as possible, including most add-ons and [most standard features](TechnicalDifferences.md). You can treat 10.4Fx as equivalent with Firefox 8.0 in most circumstances, with specific exceptions noted below.
Note that add-ons which require an Intel Macintosh will not work with TenFourFox, even if they are otherwise compatible with Firefox 8, and add-ons that require 10.5 Leopard may not be compatible with TenFourFox running on Mac OS X 10.4 Tiger, even if they are compatible with PowerPC.
## TenFourFox no longer supports plugins or Flash ##
Plugins on PowerPC are of special concern because Mozilla is making updates to their plugin architecture which may require the plugins themselves to be updated, and there are certain difficult-to-correct bugs with them already on Tiger. Most importantly, Adobe Flash for PowerPC is no longer maintained and has known security risks that can crash or leak data, and QuickTime for Leopard will lose its own support with the release of OS X Lion. In addition, Flash 10.1 is rapidly becoming unsupported by many applications.
**As of TenFourFox 6.0, for these and other reasons (for details, see PluginsNoLongerSupported), plugin support ships disabled.** Plugins will not operate by default, and bug reports will no longer be accepted. Sites will now act as if no plugins were installed at all.
For Internet video, we strongly recommend the use of [Perian](http://www.perian.org/) and any of the available video download add-ons for Firefox.
For YouTube, we recommend [MacTubes](http://macapps.web.infoseek.co.jp/mactubes/index_en.html). If you have a high end G4 or G5, you can also use WebM for selected videos by visiting http://www.youtube.com/html5 and enabling HTML5 video. This will set a temporary cookie enabling browser-based video without Flash. You do not need a YouTube account for this feature, but you may need to periodically renew the cookie setting. Not all video is available in WebM.
For a more in-depth explanation of this policy and other workarounds, see PluginsNoLongerSupported.
## New features specific to TenFourFox ##
* All new standard features of Firefox 8.0, including HTML5 content menus and improved add-on management.
* Revised Tiger-specific window chrome and colours.
* AltiVec-accelerated JPEG decoding ([issue 51](https://code.google.com/p/tenfourfox/issues/detail?id=51)).
* Improved AltiVec text conversion ([issue 76](https://code.google.com/p/tenfourfox/issues/detail?id=76)).
* Improved AltiVec-accelerated WebM decoding ([issue 78](https://code.google.com/p/tenfourfox/issues/detail?id=78)).
* Improved JavaScript performance ([issue 93](https://code.google.com/p/tenfourfox/issues/detail?id=93)).
## Known issues fixed in this version of TenFourFox ##
* An issue with certain table layouts appearing shifted to the right is repaired with an enhanced AltiVec text fragment routine ([issue 75](https://code.google.com/p/tenfourfox/issues/detail?id=75), [issue 84](https://code.google.com/p/tenfourfox/issues/detail?id=84)). This issue does not affect G3 computers. This bug is present in 6.0 and 7.0.
* An issue with increased CPU usage when TenFourFox is in the background has been mitigated ([issue 88](https://code.google.com/p/tenfourfox/issues/detail?id=88)).
## Known issues fixed between 8.0 beta and final ##
* Buttons now appear correctly ([issue 92](https://code.google.com/p/tenfourfox/issues/detail?id=92)).
## Known issues specific to TenFourFox ##
* Remember: **Plugins are turned off by default, and code for them will fail to function entirely in a subsequent version.** See PluginsNoLongerSupported for an explanation and suggested workarounds.
* As of TenFourFox 8, TenFourFox uses a lighter chrome for windows and dialogue boxes than prior versions or the official Mac Firefox. Other interface elements may appear slightly different. This is intentional.
* When 10.4Fx has no suggestions for the awesome bar, a blank box appears instead ([issue 21](https://code.google.com/p/tenfourfox/issues/detail?id=21)). This is intentional.
* 10.4Fx does not currently support WebGL or out-of-process plugins, and Indic, Arabic and other scripts requiring glyph reordering or language-specific ligatures may not appear correctly. See TechnicalDifferences for the complete list of changes necessary for 10.4Fx. See [issue 5](https://code.google.com/p/tenfourfox/issues/detail?id=5) for notes specific to the font issue.
* Animation performance is currently poorer in Mozilla 2.0/Firefox 4.0 and later versions using software rendering, which includes 10.4Fx. Mozilla acknowledges this bug, but there is not yet an ETR. See [issue 7](https://code.google.com/p/tenfourfox/issues/detail?id=7).
* The titlebar does not always properly match the menu gradient ([issue 16](https://code.google.com/p/tenfourfox/issues/detail?id=16)). This problem is also in the official release. Installing a Persona may fix this issue if you find it bothersome.
* Crash reporting is intentionally disabled to avoid polluting Mozilla's crash tracking system with our reports. Please use your system's crash logs if you are reporting a _reproducible_ crash, or (if you are able) provide a `gdb` backtrace.
* Although 10.4Fx will tell you when an update is available, you must download updates manually at this time.
You are welcome to report other bugs that you find. However, please **do not report Mozilla bugs to us.** If the bug or crash occurs in both the official Mozilla Firefox 8 _(3.6 doesn't count!)_ and in 10.4Fx, this is a Mozilla bug, and you should file it at [Bugzilla](http://bugzilla.mozilla.org/). **You must test your bug in both places -- bugs that are not confirmed to be part of 10.4Fx will be marked invalid** so that we can keep our task list focused. This is the [current list of known issues](http://code.google.com/p/tenfourfox/issues/list).

61
ReleaseNotes8Beta1.md Normal file
View File

@ -0,0 +1,61 @@
_This document may be updated for late-breaking changes, so check back here if you are having difficulty._
## System requirements ##
TenFourFox (hereafter "10.4Fx") requires a G3 Power Macintosh, Mac OS X 10.4.11, 100MB of free disk space and 512MB of RAM. **Systems with 256MB of RAM are no longer supported as of 7.0.** 768MB of RAM and a G4 or G5 processor is recommended. Video playback is likely to be poor on systems slower than 1.25GHz; a G5 is recommended. Mac OS X 10.5.8 is supported.
Intel Macintoshes are not supported, but the G3 build is known to run under Rosetta in 10.5.8 and should run under Rosetta in Intel 10.4.11. It is not tested with Snow Leopard. 10.4Fx will not run under 10.7 Lion, as Lion does not support Rosetta and 10.4Fx is not a Universal binary.
## Getting TenFourFox ##
Make sure you select the appropriate build for your Mac from the [download page](http://www.tenfourfox.com/). The G3 version will run on any supported Macintosh, but it will not take advantage of the additional features of G4 or G5 processors. The G4 and G5 versions will not run correctly on a G3, and the G5 version will perform worse on non-G5 Macintoshes.
If you are using a G4, you should try to choose the correct version for your processor generation (7400 or 7450 "G4e") as performance may be impaired if you run the wrong one. If you don't know which G4 processor you have, the instructions in WhichVersion will tell you how to find out.
## Beta considerations ##
**This version of TenFourFox is a beta.** It is only _mostly_ complete. In particular, there are some late breaking features planned for the final version which are not yet present in this beta (which is equivalent to Mozilla Firefox 8.0 beta 2), and there will be some final additional optimizations specific to 10.4Fx which will be made just prior to final release. **You should know that you are using this software at your own risk. It may cause data loss, security breaches, system instability and crashes. If you are not comfortable with these (remote but possible) possibilities, do not use this beta release.**
## TenFourFox 8.0 is equivalent to Firefox 8.0 ##
TenFourFox uses modified Firefox source code, rewritten to remain compatible with Mac OS X v10.4 and the Power Macintosh. It also contains specific optimizations and special features for PowerPC processors. For this reason, it is not exactly the same as Firefox. However, it is intended to be as compatible with it as possible, including most add-ons and [most standard features](TechnicalDifferences.md). You can treat 10.4Fx as equivalent with Firefox 8.0 in most circumstances, with specific exceptions noted below.
Note that add-ons which require an Intel Macintosh will not work with TenFourFox, even if they are otherwise compatible with Firefox 8, and add-ons that require 10.5 Leopard may not be compatible with TenFourFox running on Mac OS X 10.4 Tiger, even if they are compatible with PowerPC.
## TenFourFox no longer supports plugins or Flash ##
Plugins on PowerPC are of special concern because Mozilla is making updates to their plugin architecture which may require the plugins themselves to be updated, and there are certain difficult-to-correct bugs with them already on Tiger. Most importantly, Adobe Flash for PowerPC is no longer maintained and has known security risks that can crash or leak data, and QuickTime for Leopard will lose its own support with the release of OS X Lion. In addition, Flash 10.1 is rapidly becoming unsupported by many applications.
**As of TenFourFox 6.0, for these and other reasons (for details, see PluginsNoLongerSupported), plugin support ships disabled.** Plugins will not operate by default, and bug reports will no longer be accepted. Sites will now act as if no plugins were installed at all.
For Internet video, we strongly recommend the use of [Perian](http://www.perian.org/) and any of the available video download add-ons for Firefox.
For YouTube, we recommend [MacTubes](http://macapps.web.infoseek.co.jp/mactubes/index_en.html). If you have a high end G4 or G5, you can also use WebM for selected videos by visiting http://www.youtube.com/html5 and enabling HTML5 video. This will set a temporary cookie enabling browser-based video without Flash. You do not need a YouTube account for this feature, but you may need to periodically renew the cookie setting. Not all video is available in WebM.
For a more in-depth explanation of this policy and other workarounds, see PluginsNoLongerSupported.
## New features specific to TenFourFox ##
* All new standard features of Firefox 8.0, including tab dragging, HTML5 content menus and improved add-on management.
* Revised Tiger-specific window chrome and colours.
* AltiVec-accelerated JPEG decoding ([issue 51](https://code.google.com/p/tenfourfox/issues/detail?id=51)).
* Improved AltiVec text conversion ([issue 76](https://code.google.com/p/tenfourfox/issues/detail?id=76)).
* Improved AltiVec-accelerated WebM decoding ([issue 78](https://code.google.com/p/tenfourfox/issues/detail?id=78)).
## Known issues fixed in this version of TenFourFox ##
* An issue with certain table layouts appearing shifted to the right has been mitigated at the parser level ([issue 84](https://code.google.com/p/tenfourfox/issues/detail?id=84)).
* An issue with increased CPU usage when TenFourFox is in the background has been mitigated ([issue 88](https://code.google.com/p/tenfourfox/issues/detail?id=88)).
## Known issues specific to TenFourFox ##
* Remember: **Plugins are turned off by default, and code for them will fail to function entirely in a subsequent version.** See PluginsNoLongerSupported for an explanation and suggested workarounds.
* As of TenFourFox 8, TenFourFox uses a lighter chrome for windows and dialogue boxes than prior versions or the official Mac Firefox. This is intentional.
* When 10.4Fx has no suggestions for the awesome bar, a blank box appears instead ([issue 21](https://code.google.com/p/tenfourfox/issues/detail?id=21)). This is intentional.
* 10.4Fx does not currently support WebGL or out-of-process plugins, and Indic, Arabic and other scripts requiring glyph reordering or language-specific ligatures may not appear correctly. See TechnicalDifferences for the complete list of changes necessary for 10.4Fx. See [issue 5](https://code.google.com/p/tenfourfox/issues/detail?id=5) for notes specific to the font issue.
* Animation performance is currently poorer in Mozilla 2.0/Firefox 4.0 and later versions using software rendering, which includes 10.4Fx. Mozilla acknowledges this bug, but there is not yet an ETR. See [issue 7](https://code.google.com/p/tenfourfox/issues/detail?id=7).
* The titlebar does not always properly match the menu gradient ([issue 16](https://code.google.com/p/tenfourfox/issues/detail?id=16)). This problem is also in the official release. Installing a Persona may fix this issue if you find it bothersome.
* Crash reporting is intentionally disabled to avoid polluting Mozilla's crash tracking system with our reports. Please use your system's crash logs if you are reporting a _reproducible_ crash, or (if you are able) provide a `gdb` backtrace.
* Although 10.4Fx will tell you when an update is available, you must download updates manually at this time.
You are welcome to report other bugs that you find. However, please **do not report Mozilla bugs to us.** If the bug or crash occurs in both the official Mozilla Firefox 8 _(3.6 doesn't count!)_ and in 10.4Fx, this is a Mozilla bug, and you should file it at [Bugzilla](http://bugzilla.mozilla.org/). **You must test your bug in both places -- bugs that are not confirmed to be part of 10.4Fx will be marked invalid** so that we can keep our task list focused. This is the [current list of known issues](http://code.google.com/p/tenfourfox/issues/list).

63
ReleaseNotes90.md Normal file
View File

@ -0,0 +1,63 @@
_This document may be updated for late-breaking changes, so check back here if you are having difficulty._
## System requirements ##
TenFourFox (hereafter "10.4Fx") requires a G3 Power Macintosh, Mac OS X 10.4.11, 100MB of free disk space and 512MB of RAM. 1GB of RAM and a G4 or G5 processor is recommended. Video playback is likely to be poor on systems slower than 1.25GHz; a G5 is recommended. Mac OS X 10.5.8 is supported.
Intel Macintoshes are not supported, but the G3 build is known to run under Rosetta in 10.5.8 and should run under Rosetta in Intel 10.4.11. It is not tested with Snow Leopard. 10.4Fx will not run under 10.7 Lion, as Lion does not support Rosetta and 10.4Fx is not a Universal binary.
## Getting TenFourFox ##
Make sure you select the appropriate build for your Mac from the [download page](http://www.tenfourfox.com/). The G3 version will run on any supported Macintosh, but it will not take advantage of the additional features of G4 or G5 processors. The G4 and G5 versions will not run correctly on a G3, and the G5 version will perform worse on non-G5 Macintoshes.
If you are using a G4, you should try to choose the correct version for your processor generation (7400 or 7450 "G4e") as performance may be impaired if you run the wrong one. If you don't know which G4 processor you have, the instructions in WhichVersion will tell you how to find out.
## TenFourFox 9.0 is equivalent to Firefox 9.0 ##
TenFourFox uses modified Firefox source code, rewritten to remain compatible with Mac OS X v10.4 and the Power Macintosh. It also contains specific optimizations and special features for PowerPC processors. For this reason, it is not exactly the same as Firefox. However, it is intended to be as compatible with it as possible, including most add-ons and [most standard features](TechnicalDifferences.md). You can treat 10.4Fx as equivalent with Firefox 9.0 in most circumstances, with specific exceptions noted below.
Note that add-ons which require an Intel Macintosh will not work with TenFourFox, even if they are otherwise compatible with Firefox 9, and add-ons that require 10.5 Leopard may not be compatible with TenFourFox running on Mac OS X 10.4 Tiger, even if they are compatible with PowerPC.
## TenFourFox no longer supports plugins or Flash ##
Plugins on PowerPC are of special concern because Mozilla is making updates to their plugin architecture which may require the plugins themselves to be updated, and there are certain difficult-to-correct bugs with them already on Tiger. Most importantly, Adobe Flash for PowerPC is no longer maintained and has known security risks that can crash or leak data, and QuickTime for Leopard will lose its own support with the release of OS X Lion. In addition, Flash 10.1 is rapidly becoming unsupported by many applications.
**As of TenFourFox 6.0, for these and other reasons (for details, see PluginsNoLongerSupported), plugin support ships disabled.** Plugins will not operate by default, and bug reports will no longer be accepted. Sites will now act as if no plugins were installed at all.
For Internet video, we strongly recommend the use of [Perian](http://www.perian.org/) and any of the available video download add-ons for Firefox.
For YouTube, we recommend [MacTubes](http://macapps.web.infoseek.co.jp/mactubes/index_en.html). If you have a high end G4 or G5, you can also use WebM for selected videos by visiting http://www.youtube.com/html5 and enabling HTML5 video. This will set a temporary cookie enabling browser-based video without Flash. You do not need a YouTube account for this feature, but you may need to periodically renew the cookie setting. Not all video is available in WebM.
For a more in-depth explanation of this policy and other workarounds, see PluginsNoLongerSupported.
## New features specific to TenFourFox ##
* All new standard features of Firefox 9.0, including interface improvements, enhancements to Do-Not-Track and faster dynamic web page performance (chunked XHR).
* JavaScript regular expression compilation, significantly accelerating certain common script operations ([issue 101](https://code.google.com/p/tenfourfox/issues/detail?id=101)). This is enabled on all architectures, including G3.
* Faster AltiVec-accelerated text conversion ([issue 75](https://code.google.com/p/tenfourfox/issues/detail?id=75)).
* Improved AltiVec-accelerated WebM scaling and display ([issue 64](https://code.google.com/p/tenfourfox/issues/detail?id=64)).
* Accelerated AltiVec colour management ([issue 87](https://code.google.com/p/tenfourfox/issues/detail?id=87)).
## Known issues fixed in this version of TenFourFox ##
* An issue where malformed JPEG images could crash the browser has been repaired ([issue 108](https://code.google.com/p/tenfourfox/issues/detail?id=108)). This does not affect the G3 version. This does not affect versions prior to 10.4Fx 8.0.
* An issue where JPEG decoding performance degraded in 8.0 has been mitigated ([issue 112](https://code.google.com/p/tenfourfox/issues/detail?id=112)). This affects G3 worst, but affects all versions. This is not related to AltiVec-accelerated JPEG decoding. This does not affect versions prior to 10.4Fx 8.0.
* An issue where extremely complex JavaScript could crash the browser has been mitigated ([issue 113](https://code.google.com/p/tenfourfox/issues/detail?id=113)). This affects all prior versions of 10.4Fx.
## Known issues fixed between beta and final release ##
* Icons now appear correctly in the History and Bookmarks menus (Mozilla [bug 705516](https://code.google.com/p/tenfourfox/issues/detail?id=05516)). This bug also affects regular Firefox, but less acutely.
* Mozilla Add-on pages now properly interact with the user again ([issue 117](https://code.google.com/p/tenfourfox/issues/detail?id=117)).
## Known issues specific to TenFourFox ##
* Remember: **Plugins are turned off by default, and code for them will fail to function entirely in a subsequent version.** See PluginsNoLongerSupported for an explanation and suggested workarounds.
* As of TenFourFox 8, TenFourFox uses a lighter chrome for windows and dialogue boxes than prior versions or the official Mac Firefox. This is intentional.
* When 10.4Fx has no suggestions for the awesome bar, a blank box appears instead ([issue 21](https://code.google.com/p/tenfourfox/issues/detail?id=21)). This is intentional.
* 10.4Fx does not currently support WebGL or out-of-process plugins, and Indic, Arabic and other scripts requiring glyph reordering or language-specific ligatures may not appear correctly. See TechnicalDifferences for the complete list of changes necessary for 10.4Fx. See [issue 5](https://code.google.com/p/tenfourfox/issues/detail?id=5) for notes specific to the font issue.
* Animation performance is currently poorer in Mozilla 2.0/Firefox 4.0 and later versions using software rendering, which includes 10.4Fx. Mozilla acknowledges this bug, but there is not yet an ETR. See [issue 7](https://code.google.com/p/tenfourfox/issues/detail?id=7).
* The titlebar does not always properly match the menu gradient ([issue 16](https://code.google.com/p/tenfourfox/issues/detail?id=16)). This problem is also in the official release. Installing a Persona may fix this issue if you find it bothersome.
* Crash reporting is intentionally disabled to avoid polluting Mozilla's crash tracking system with our reports. Please use your system's crash logs if you are reporting a _reproducible_ crash, or (if you are able) provide a `gdb` backtrace.
* Although 10.4Fx will tell you when an update is available, you must download updates manually at this time.
You are welcome to report other bugs that you find. However, please **do not report Mozilla bugs to us.** If the bug or crash occurs in both the official Mozilla Firefox 9 _(3.6 doesn't count!)_ and in 10.4Fx, this is a Mozilla bug, and you should file it at [Bugzilla](http://bugzilla.mozilla.org/). **You must test your bug in both places -- bugs that are not confirmed to be part of 10.4Fx will be marked invalid** so that we can keep our task list focused. This is the [current list of known issues](http://code.google.com/p/tenfourfox/issues/list). Please do not submit technical support requests by E-mail; they cannot be properly tracked or managed.

62
ReleaseNotes9Beta1.md Normal file
View File

@ -0,0 +1,62 @@
_This document may be updated for late-breaking changes, so check back here if you are having difficulty._
## System requirements ##
TenFourFox (hereafter "10.4Fx") requires a G3 Power Macintosh, Mac OS X 10.4.11, 100MB of free disk space and 512MB of RAM. 1GB of RAM and a G4 or G5 processor is recommended. Video playback is likely to be poor on systems slower than 1.25GHz; a G5 is recommended. Mac OS X 10.5.8 is supported.
Intel Macintoshes are not supported, but the G3 build is known to run under Rosetta in 10.5.8 and should run under Rosetta in Intel 10.4.11. It is not tested with Snow Leopard. 10.4Fx will not run under 10.7 Lion, as Lion does not support Rosetta and 10.4Fx is not a Universal binary.
## Getting TenFourFox ##
Make sure you select the appropriate build for your Mac from the [download page](http://www.tenfourfox.com/). The G3 version will run on any supported Macintosh, but it will not take advantage of the additional features of G4 or G5 processors. The G4 and G5 versions will not run correctly on a G3, and the G5 version will perform worse on non-G5 Macintoshes.
If you are using a G4, you should try to choose the correct version for your processor generation (7400 or 7450 "G4e") as performance may be impaired if you run the wrong one. If you don't know which G4 processor you have, the instructions in WhichVersion will tell you how to find out.
## Beta considerations ##
**This version of TenFourFox is a beta.** It is only _mostly_ complete. In particular, there may be some late breaking features planned for the final version which are not yet present in this beta (which is approximately equivalent to Mozilla Firefox 9.0 beta 3), and there may be some final additional optimizations specific to 10.4Fx which will be made just prior to final release. **You should know that you are using this software at your own risk. It may cause data loss, security breaches, system instability and crashes. If you are not comfortable with these (remote but possible) possibilities, do not use this beta release.**
## TenFourFox 9.0 is equivalent to Firefox 9.0 ##
TenFourFox uses modified Firefox source code, rewritten to remain compatible with Mac OS X v10.4 and the Power Macintosh. It also contains specific optimizations and special features for PowerPC processors. For this reason, it is not exactly the same as Firefox. However, it is intended to be as compatible with it as possible, including most add-ons and [most standard features](TechnicalDifferences.md). You can treat 10.4Fx as equivalent with Firefox 9.0 in most circumstances, with specific exceptions noted below.
Note that add-ons which require an Intel Macintosh will not work with TenFourFox, even if they are otherwise compatible with Firefox 9, and add-ons that require 10.5 Leopard may not be compatible with TenFourFox running on Mac OS X 10.4 Tiger, even if they are compatible with PowerPC.
## TenFourFox no longer supports plugins or Flash ##
Plugins on PowerPC are of special concern because Mozilla is making updates to their plugin architecture which may require the plugins themselves to be updated, and there are certain difficult-to-correct bugs with them already on Tiger. Most importantly, Adobe Flash for PowerPC is no longer maintained and has known security risks that can crash or leak data, and QuickTime for Leopard will lose its own support with the release of OS X Lion. In addition, Flash 10.1 is rapidly becoming unsupported by many applications.
**As of TenFourFox 6.0, for these and other reasons (for details, see PluginsNoLongerSupported), plugin support ships disabled.** Plugins will not operate by default, and bug reports will no longer be accepted. Sites will now act as if no plugins were installed at all.
For Internet video, we strongly recommend the use of [Perian](http://www.perian.org/) and any of the available video download add-ons for Firefox.
For YouTube, we recommend [MacTubes](http://macapps.web.infoseek.co.jp/mactubes/index_en.html). If you have a high end G4 or G5, you can also use WebM for selected videos by visiting http://www.youtube.com/html5 and enabling HTML5 video. This will set a temporary cookie enabling browser-based video without Flash. You do not need a YouTube account for this feature, but you may need to periodically renew the cookie setting. Not all video is available in WebM.
For a more in-depth explanation of this policy and other workarounds, see PluginsNoLongerSupported.
## New features specific to TenFourFox ##
* All new standard features of Firefox 9.0, including interface improvements, enhancements to Do-Not-Track and faster dynamic web page performance (chunked XHR).
* JavaScript regular expression compilation, significantly accelerating certain common script operations ([issue 101](https://code.google.com/p/tenfourfox/issues/detail?id=101)). This is enabled on all architectures, including G3.
* Faster AltiVec-accelerated text conversion ([issue 75](https://code.google.com/p/tenfourfox/issues/detail?id=75)).
* Improved AltiVec-accelerated WebM scaling and display ([issue 64](https://code.google.com/p/tenfourfox/issues/detail?id=64)).
* Accelerated AltiVec colour management ([issue 87](https://code.google.com/p/tenfourfox/issues/detail?id=87)).
## Known issues fixed in this version of TenFourFox ##
* An issue where malformed JPEG images could crash the browser has been repaired ([issue 108](https://code.google.com/p/tenfourfox/issues/detail?id=108)). This does not affect the G3 version. This does not affect versions prior to 10.4Fx 8.0.
* An issue where JPEG decoding performance degraded in 8.0 has been mitigated ([issue 112](https://code.google.com/p/tenfourfox/issues/detail?id=112)). This affects G3 worst, but affects all versions. This is not related to AltiVec-accelerated JPEG decoding. This does not affect versions prior to 10.4Fx 8.0.
* An issue where extremely complex JavaScript could crash the browser has been mitigated ([issue 113](https://code.google.com/p/tenfourfox/issues/detail?id=113)). This affects all prior versions of 10.4Fx.
## Known issues specific to TenFourFox ##
* Remember: **Plugins are turned off by default, and code for them will fail to function entirely in a subsequent version.** See PluginsNoLongerSupported for an explanation and suggested workarounds.
* As of TenFourFox 8, TenFourFox uses a lighter chrome for windows and dialogue boxes than prior versions or the official Mac Firefox. This is intentional.
* When 10.4Fx has no suggestions for the awesome bar, a blank box appears instead ([issue 21](https://code.google.com/p/tenfourfox/issues/detail?id=21)). This is intentional.
* 10.4Fx does not currently support WebGL or out-of-process plugins, and Indic, Arabic and other scripts requiring glyph reordering or language-specific ligatures may not appear correctly. See TechnicalDifferences for the complete list of changes necessary for 10.4Fx. See [issue 5](https://code.google.com/p/tenfourfox/issues/detail?id=5) for notes specific to the font issue.
* Animation performance is currently poorer in Mozilla 2.0/Firefox 4.0 and later versions using software rendering, which includes 10.4Fx. Mozilla acknowledges this bug, but there is not yet an ETR. See [issue 7](https://code.google.com/p/tenfourfox/issues/detail?id=7).
* The titlebar does not always properly match the menu gradient ([issue 16](https://code.google.com/p/tenfourfox/issues/detail?id=16)). This problem is also in the official release. Installing a Persona may fix this issue if you find it bothersome.
* Crash reporting is intentionally disabled to avoid polluting Mozilla's crash tracking system with our reports. Please use your system's crash logs if you are reporting a _reproducible_ crash, or (if you are able) provide a `gdb` backtrace.
* Although 10.4Fx will tell you when an update is available, you must download updates manually at this time.
You are welcome to report other bugs that you find. However, please **do not report Mozilla bugs to us.** If the bug or crash occurs in both the official Mozilla Firefox 9 _(3.6 doesn't count!)_ and in 10.4Fx, this is a Mozilla bug, and you should file it at [Bugzilla](http://bugzilla.mozilla.org/). **You must test your bug in both places -- bugs that are not confirmed to be part of 10.4Fx will be marked invalid** so that we can keep our task list focused. This is the [current list of known issues](http://code.google.com/p/tenfourfox/issues/list).

39
ReleaseNotesBeta11.md Normal file
View File

@ -0,0 +1,39 @@
**Beta 10 was skipped due to the rapid back-to-back release schedule.**
_This document may be updated for late-breaking changes, so check back here if you are having difficulty._
## System requirements ##
TenFourFox (hereafter "10.4Fx") requires a G3 Power Macintosh, Mac OS X 10.4.11, 100MB of free disk space and 256MB of RAM. 512MB of RAM and a G4 or G5 processor is recommended. Video playback is likely to be suboptimal on systems slower than 1.25GHz. Mac OS X 10.5.8 is supported.
Intel Macintoshes are not supported, but the G3 build is known to run under Rosetta in 10.5.8. It is not tested with Snow Leopard.
## Getting 10.4Fx ##
Make sure you select the appropriate build for your Mac from the [download page](http://www.tenfourfox.com/). The G3 version will run on any supported Macintosh, but it will not take advantage of the additional features of G4 or G5 processors. The G4 and G5 versions will not run correctly on a G3, and the G5 version will perform worse on non-G5 Macintoshes.
If you are using a G4, you should try to choose the correct version for your processor generation (7400 or 7450 "G4e") as performance may be impaired if you run the wrong one. If you don't know which G4 processor you have, the instructions in WhichVersion will tell you how to find out.
## Beta considerations ##
**This version of TenFourFox is a beta.** It is only _mostly_ complete. In particular, there are some late breaking features planned for the final version which are not yet present in this beta (which is equivalent to Mozilla Firefox 4.0 beta 11), and there will be some final additional optimizations specific to 10.4Fx which will be made just prior to final release. **You should know that you are using this software at your own risk. It may cause data loss, security breaches, system instability and crashes. If you are not comfortable with these (remote but possible) possibilities, do not use this beta release.**
## Known issues fixed in this 10.4Fx beta ##
* All known Mozilla general fixes for 4.0 beta 11.
* The PowerPC JavaScript nanojit is now enabled for content/web pages ([issue 20](https://code.google.com/p/tenfourfox/issues/detail?id=20)). This dramatically improves page speed and JavaScript support. Browser "chrome" nanojit support will be enabled once stability is assured. The nanojit is most effective on G4 and G3 processors; G5 tuning is in progress ([issue 23](https://code.google.com/p/tenfourfox/issues/detail?id=23)). Currently TenFourFox is the only browser using this code, but it has been submitted back to Mozilla as [bug 624164](https://code.google.com/p/tenfourfox/issues/detail?id=24164). **If you experience difficulty using the nanojit or encounter unexpected JavaScript behaviour,** you can try turning acceleration off by going to `about:config` and toggling `javascript.options.tracejit.content` to `false`. You may wish to restart the browser afterwards, although this is not required.
* Further improvements to the title bar ([issue 16](https://code.google.com/p/tenfourfox/issues/detail?id=16)).
* Stub for Gopher protocol support ([issue 3](https://code.google.com/p/tenfourfox/issues/detail?id=3)), which was removed in Firefox 4/Gecko 2.
* Additional window event and focus management ([issue 19](https://code.google.com/p/tenfourfox/issues/detail?id=19)).
## Known issues specific to 10.4Fx ##
* Plugins are officially deprecated as of beta 11. This is due to security, performance and technical issues from plugins such as Flash and QuickTime which will soon be no longer updated for Power Macintoshes. These plugins represent a future potential means of compromising browser security, and they use older OS APIs that Mozilla will no longer support. While they will still be supported and will continue to function throughout TenFourFox 4.0, they will be turned off by default in the next major release "4.1," and support for them will be removed entirely in a subsequent version. For more about this, [see this blog entry](http://tenfourfox.blogspot.com/2011/01/plugins-unplugged.html) and [issue 24](https://code.google.com/p/tenfourfox/issues/detail?id=24).
* 10.4Fx does not currently support WebGL or out-of-process plugins, and Indic, Arabic and other scripts requiring glyph reordering or language-specific ligatures may not appear correctly. See TechnicalDifferences for the complete list of changes necessary for 10.4Fx. See [issue 5](https://code.google.com/p/tenfourfox/issues/detail?id=5) for notes specific to the font issue.
* Animation performance is currently poorer in Mozilla 2.0/Firefox 4.0 versions using software rendering, which includes 10.4Fx. Mozilla acknowledges this bug, but there is not yet an ETR. See [issue 7](https://code.google.com/p/tenfourfox/issues/detail?id=7).
* The titlebar does not always properly match the menu gradient ([issue 16](https://code.google.com/p/tenfourfox/issues/detail?id=16)). This problem is also in the official beta, but has a different cause. Installing a Persona may fix this issue if you find it bothersome.
* Crash reporting is intentionally disabled to avoid polluting Mozilla's crash tracking system with our reports. Please use your system's crash logs if you are reporting a _reproducible_ crash, or (if you are able) provide a `gdb` backtrace.
You may also wish to read the [Mozilla Firefox beta release notes](http://www.mozilla.com/en-US/firefox/4.0b11/whatsnew/) for what's new in this version of Firefox. This page may not yet be available.
You are welcome to report other bugs that you find. However, please **do not report Mozilla bugs to us.** If the bug or crash occurs in both the official Mozilla Firefox and in 10.4Fx, this is a Mozilla bug, and you should file it at [Bugzilla](http://bugzilla.mozilla.org/). **You must test your bug in both places -- during the beta period, bugs that are not confirmed to be part of 10.4Fx will be marked invalid** so that we can keep our task list focused. This is the [current list of known issues](http://code.google.com/p/tenfourfox/issues/list).

40
ReleaseNotesBeta12.md Normal file
View File

@ -0,0 +1,40 @@
## Beta 12 will be the final TenFourFox beta ##
Due to a last-minute security fix, the version number is reported as b13pre. However, the distributed binary is the same as Firefox 4 beta 12.
_This document may be updated for late-breaking changes, so check back here if you are having difficulty._
## System requirements ##
TenFourFox (hereafter "10.4Fx") requires a G3 Power Macintosh, Mac OS X 10.4.11, 100MB of free disk space and 256MB of RAM. 512MB of RAM and a G4 or G5 processor is recommended. Video playback is likely to be suboptimal on systems slower than 1.25GHz. Mac OS X 10.5.8 is supported.
Intel Macintoshes are not supported, but the G3 build is known to run under Rosetta in 10.5.8. It is not tested with Snow Leopard.
## Getting 10.4Fx ##
Make sure you select the appropriate build for your Mac from the [download page](http://www.tenfourfox.com/). The G3 version will run on any supported Macintosh, but it will not take advantage of the additional features of G4 or G5 processors. The G4 and G5 versions will not run correctly on a G3, and the G5 version will perform worse on non-G5 Macintoshes.
If you are using a G4, you should try to choose the correct version for your processor generation (7400 or 7450 "G4e") as performance may be impaired if you run the wrong one. If you don't know which G4 processor you have, the instructions in WhichVersion will tell you how to find out.
## Beta considerations ##
**This version of TenFourFox is a beta.** It is only _mostly_ complete. In particular, there are some late breaking features planned for the final version which are not yet present in this beta (which is equivalent to Mozilla Firefox 4.0 beta 12), and there will be some final additional optimizations specific to 10.4Fx which will be made just prior to final release. **You should know that you are using this software at your own risk. It may cause data loss, security breaches, system instability and crashes. If you are not comfortable with these (remote but possible) possibilities, do not use this beta release.**
## Known issues fixed in this 10.4Fx beta ##
* All known Mozilla general fixes for 4.0 beta 12.
* When running out of suggestions, the awesome bar no longer turns off suggestions completely ([issue 21](https://code.google.com/p/tenfourfox/issues/detail?id=21)). As a side effect of this fix, when no matches are found, a blank list of suggestions appears to inform you nothing matches.
* Most Command-key sequences now work properly, including Cmd-# to switch to tabs and Cmd-Enter in the location box ([issue 22](https://code.google.com/p/tenfourfox/issues/detail?id=22)).
* Repaired a crash in the JavaScript accelerator ([issue 31](https://code.google.com/p/tenfourfox/issues/detail?id=31)).
## Known issues specific to 10.4Fx ##
* **Plugins, although most will still work, are _officially deprecated._** This is due to security, performance and technical issues from plugins such as Flash and QuickTime which will soon be no longer updated for Power Macintoshes. These plugins represent a future potential means of compromising browser security, and they use older OS APIs that Mozilla will no longer support. While they will still continue to function throughout TenFourFox 4.0, only major bugs will be repaired, and it is possible there may be graphical glitches. Plugins will be turned off by default in the next major release, and support for them will be removed entirely in a subsequent version. For more about this, [see this blog entry](http://tenfourfox.blogspot.com/2011/01/plugins-unplugged.html) and [issue 24](https://code.google.com/p/tenfourfox/issues/detail?id=24).
* 10.4Fx does not currently support WebGL or out-of-process plugins, and Indic, Arabic and other scripts requiring glyph reordering or language-specific ligatures may not appear correctly. See TechnicalDifferences for the complete list of changes necessary for 10.4Fx. See [issue 5](https://code.google.com/p/tenfourfox/issues/detail?id=5) for notes specific to the font issue.
* Animation performance is currently poorer in Mozilla 2.0/Firefox 4.0 versions using software rendering, which includes 10.4Fx. Mozilla acknowledges this bug, but there is not yet an ETR. See [issue 7](https://code.google.com/p/tenfourfox/issues/detail?id=7).
* The titlebar does not always properly match the menu gradient ([issue 16](https://code.google.com/p/tenfourfox/issues/detail?id=16)). This problem is also in the official beta, but has a different cause. Installing a Persona may fix this issue if you find it bothersome.
* Crash reporting is intentionally disabled to avoid polluting Mozilla's crash tracking system with our reports. Please use your system's crash logs if you are reporting a _reproducible_ crash, or (if you are able) provide a `gdb` backtrace.
You may also wish to read the [Mozilla Firefox beta release notes](http://www.mozilla.com/en-US/firefox/4.0b12/whatsnew/) for what's new in this version of Firefox. This page may not yet be available.
You are welcome to report other bugs that you find. However, please **do not report Mozilla bugs to us.** If the bug or crash occurs in both the official Mozilla Firefox and in 10.4Fx, this is a Mozilla bug, and you should file it at [Bugzilla](http://bugzilla.mozilla.org/). **You must test your bug in both places -- during the beta period, bugs that are not confirmed to be part of 10.4Fx will be marked invalid** so that we can keep our task list focused. This is the [current list of known issues](http://code.google.com/p/tenfourfox/issues/list).

28
ReleaseNotesBeta7.md Normal file
View File

@ -0,0 +1,28 @@
_This document may be updated for late-breaking changes, so check back here if you are having difficulty._
## System requirements ##
TenFourFox (hereafter "10.4Fx") requires a G3 Power Macintosh, Mac OS X 10.4.11, 100MB of free disk space and 256MB of RAM. 512MB of RAM and a G4 or G5 processor is recommended. Video playback is likely to be suboptimal on systems slower than 1.25GHz. Mac OS X 10.5.8 is supported.
Intel Macintoshes are not supported, but the G3 build is known to run under Rosetta in 10.5.8. It is not tested with Snow Leopard.
## Getting 10.4Fx ##
Make sure you select the appropriate build for your Mac from the [download page](http://www.tenfourfox.com/). The G3 version will run on any supported Macintosh, but it will not take advantage of the additional features of G4 or G5 processors. The G4/G5 version will not run correctly on a G3.
## Beta considerations ##
**This version of TenFourFox is a beta.** It is only _mostly_ complete. In particular, there are some late breaking features planned for the final version which are not yet present in this beta (which is equivalent to Mozilla Firefox 4.0 beta 7), and there will be some final additional optimizations specific to 10.4Fx which will be made just prior to final release. **You should know that you are using this software at your own risk. It may cause data loss, security breaches, system instability and crashes. If you are not comfortable with these (remote but possible) possibilities, do not use this beta release.**
The beta is based on the nightly build after the beta 7 code freeze. For this reason, the application will appear as "Minefield," which is the Mozilla codename for a nightly build. However, the code is substantially the same. It will appear in your Dock as TenFourFox.
## Known issues specific to 10.4Fx ##
* 10.4Fx does not currently support WebGL or out-of-process plugins, and Indic, Arabic and other scripts requiring glyph reordering or ligatures may not appear correctly. See TechnicalDifferences for the complete list of changes necessary for 10.4Fx. See [issue 5](https://code.google.com/p/tenfourfox/issues/detail?id=5) for notes specific to the font issue.
* Self-updates are not yet supported ([issue 4](https://code.google.com/p/tenfourfox/issues/detail?id=4)).
* Repeatedly trying to open the click-hold menu on the back and forward buttons may cause 10.4Fx to crash ([issue 9](https://code.google.com/p/tenfourfox/issues/detail?id=9)). Right-clicking them for the menu is safe. This will be fixed in the next beta.
* Crash reporting is intentionally disabled to avoid polluting Mozilla's crash tracking system with our reports. Please use your system's crash logs if you are reporting a _reproducible_ crash, or (if you are able) provide a `gdb` backtrace.
You may also wish to read the [Mozilla Firefox beta release notes](http://www.mozilla.com/en-US/firefox/4.0b7/whatsnew/).
You are welcome to report other bugs that you find. However, please **do not report Mozilla bugs to us.** If the bug or crash occurs in both the official Mozilla Firefox and in 10.4Fx, this is a Mozilla bug, and you should file it at [Bugzilla](http://bugzilla.mozilla.org/). **You must test your bug in both places -- during the beta period, bugs that are not confirmed to be part of 10.4Fx will be marked invalid** so that we can keep our task list focused. This is the [current list of known issues](http://code.google.com/p/tenfourfox/issues/list).

36
ReleaseNotesBeta8.md Normal file
View File

@ -0,0 +1,36 @@
_This document may be updated for late-breaking changes, so check back here if you are having difficulty._
## System requirements ##
TenFourFox (hereafter "10.4Fx") requires a G3 Power Macintosh, Mac OS X 10.4.11, 100MB of free disk space and 256MB of RAM. 512MB of RAM and a G4 or G5 processor is recommended. Video playback is likely to be suboptimal on systems slower than 1.25GHz. Mac OS X 10.5.8 is supported.
Intel Macintoshes are not supported, but the G3 build is known to run under Rosetta in 10.5.8. It is not tested with Snow Leopard.
## Getting 10.4Fx ##
Make sure you select the appropriate build for your Mac from the [download page](http://www.tenfourfox.com/). The G3 version will run on any supported Macintosh, but it will not take advantage of the additional features of G4 or G5 processors. The G4 and G5 versions will not run correctly on a G3.
If you are using a G4, you should try to choose the correct version for your processor generation (7400 or 7450 "G4e") as performance may be impaired if you run the wrong one. If you don't know which G4 processor you have, the instructions in WhichVersion will tell you how to find out.
## Beta considerations ##
**This version of TenFourFox is a beta.** It is only _mostly_ complete. In particular, there are some late breaking features planned for the final version which are not yet present in this beta (which is equivalent to Mozilla Firefox 4.0 beta 8), and there will be some final additional optimizations specific to 10.4Fx which will be made just prior to final release. **You should know that you are using this software at your own risk. It may cause data loss, security breaches, system instability and crashes. If you are not comfortable with these (remote but possible) possibilities, do not use this beta release.**
## Known issues fixed in this 10.4Fx beta ##
* New TenFourFox-specific branding.
* Enabled support for ligatures and font features ([issue 5](https://code.google.com/p/tenfourfox/issues/detail?id=5)).
* Separate builds for early G4 systems, i.e., 7400/7410 CPUs, and G5 systems ([issue 10](https://code.google.com/p/tenfourfox/issues/detail?id=10)).
* Manual updates and automatic notification are now supported ([issue 4](https://code.google.com/p/tenfourfox/issues/detail?id=4)).
* Repeatedly click-hold-opening the menu on the back and forward buttons no longer causes 10.4Fx to crash ([issue 9](https://code.google.com/p/tenfourfox/issues/detail?id=9)).
* Black bars over certain web page elements should no longer appear ([issue 2](https://code.google.com/p/tenfourfox/issues/detail?id=2)).
* Fixes to keyboard settings in plugins ([issue 12](https://code.google.com/p/tenfourfox/issues/detail?id=12)).
## Known issues specific to 10.4Fx ##
* 10.4Fx does not currently support WebGL or out-of-process plugins, and Indic, Arabic and other scripts requiring glyph reordering or language-specific ligatures may not appear correctly. See TechnicalDifferences for the complete list of changes necessary for 10.4Fx. See [issue 5](https://code.google.com/p/tenfourfox/issues/detail?id=5) for notes specific to the font issue.
* Animation performance is currently poorer in Mozilla 2.0/Firefox 4.0 versions using software rendering, which includes 10.4Fx. Mozilla acknowledges this bug and plans to fix it before final release. See [issue 7](https://code.google.com/p/tenfourfox/issues/detail?id=7).
* Crash reporting is intentionally disabled to avoid polluting Mozilla's crash tracking system with our reports. Please use your system's crash logs if you are reporting a _reproducible_ crash, or (if you are able) provide a `gdb` backtrace.
You may also wish to read the [Mozilla Firefox beta release notes](http://www.mozilla.com/en-US/firefox/4.0b8/whatsnew/) for what's new in this version of Firefox. (This page will be available after 21 December 2010.)
You are welcome to report other bugs that you find. However, please **do not report Mozilla bugs to us.** If the bug or crash occurs in both the official Mozilla Firefox and in 10.4Fx, this is a Mozilla bug, and you should file it at [Bugzilla](http://bugzilla.mozilla.org/). **You must test your bug in both places -- during the beta period, bugs that are not confirmed to be part of 10.4Fx will be marked invalid** so that we can keep our task list focused. This is the [current list of known issues](http://code.google.com/p/tenfourfox/issues/list).

40
ReleaseNotesBeta9.md Normal file
View File

@ -0,0 +1,40 @@
_This document may be updated for late-breaking changes, so check back here if you are having difficulty._
## System requirements ##
TenFourFox (hereafter "10.4Fx") requires a G3 Power Macintosh, Mac OS X 10.4.11, 100MB of free disk space and 256MB of RAM. 512MB of RAM and a G4 or G5 processor is recommended. Video playback is likely to be suboptimal on systems slower than 1.25GHz. Mac OS X 10.5.8 is supported.
Intel Macintoshes are not supported, but the G3 build is known to run under Rosetta in 10.5.8. It is not tested with Snow Leopard.
## Getting 10.4Fx ##
Make sure you select the appropriate build for your Mac from the [download page](http://www.tenfourfox.com/). The G3 version will run on any supported Macintosh, but it will not take advantage of the additional features of G4 or G5 processors. The G4 and G5 versions will not run correctly on a G3.
If you are using a G4, you should try to choose the correct version for your processor generation (7400 or 7450 "G4e") as performance may be impaired if you run the wrong one. If you don't know which G4 processor you have, the instructions in WhichVersion will tell you how to find out.
## Beta considerations ##
**This version of TenFourFox is a beta.** It is only _mostly_ complete. In particular, there are some late breaking features planned for the final version which are not yet present in this beta (which is equivalent to Mozilla Firefox 4.0 beta 9), and there will be some final additional optimizations specific to 10.4Fx which will be made just prior to final release. **You should know that you are using this software at your own risk. It may cause data loss, security breaches, system instability and crashes. If you are not comfortable with these (remote but possible) possibilities, do not use this beta release.**
## Known issues fixed in this 10.4Fx beta ##
* All known Mozilla general fixes for 4.0 beta 9.
* The first draft of the PowerPC-specific nanojit is now available, helping to accelerate certain JavaScript operations ([issue 15](https://code.google.com/p/tenfourfox/issues/detail?id=15)). This portion of code is specific to TenFourFox and is still under development, so it is not enabled by default. If you wish to try it on your system and report back to us, you can enable it by setting either or both of `javascript.options.tracejit.chrome` (for browser and browser add-on JavaScript) and `javascript.options.tracejit.content` (for webpages) in `about:config` to `true`. You should probably start with content, and later add chrome once you have ensured they function. Restart your browser after changing these options to make sure they take effect. If you are unable to start the browser after setting these options, you may need to reverse them using beta 8. It is possible that this may affect your installed add-ons.
* The title bar is now using different code that flickers less ([issue 16](https://code.google.com/p/tenfourfox/issues/detail?id=16)). Because of this, the title bar appears slightly different on Tiger. Personas are unaffected.
* Additional branding work ([issue 17](https://code.google.com/p/tenfourfox/issues/detail?id=17)).
* Fixed an issue where clicking in an inactive window did not always bring the application to the front ([issue 19](https://code.google.com/p/tenfourfox/issues/detail?id=19)).
## Known issues in this beta ##
* Certain sites such as New Twitter have portions of the page that fail to render. This is a Mozilla issue and is also in Firefox beta 9. See Mozilla [bug 623852](https://code.google.com/p/tenfourfox/issues/detail?id=23852).
## Known issues specific to 10.4Fx ##
* 10.4Fx does not currently support WebGL or out-of-process plugins, and Indic, Arabic and other scripts requiring glyph reordering or language-specific ligatures may not appear correctly. See TechnicalDifferences for the complete list of changes necessary for 10.4Fx. See [issue 5](https://code.google.com/p/tenfourfox/issues/detail?id=5) for notes specific to the font issue.
* Animation performance is currently poorer in Mozilla 2.0/Firefox 4.0 versions using software rendering, which includes 10.4Fx. Mozilla acknowledges this bug and plans to fix it before final release. See [issue 7](https://code.google.com/p/tenfourfox/issues/detail?id=7).
* The titlebar does not always properly match the menu gradient ([issue 16](https://code.google.com/p/tenfourfox/issues/detail?id=16)). This problem is also in the official beta, but has a different cause. Installing a Persona may fix this issue if you find it bothersome.
* Crash reporting is intentionally disabled to avoid polluting Mozilla's crash tracking system with our reports. Please use your system's crash logs if you are reporting a _reproducible_ crash, or (if you are able) provide a `gdb` backtrace.
You may also wish to read the [Mozilla Firefox beta release notes](http://www.mozilla.com/en-US/firefox/4.0b9/whatsnew/) for what's new in this version of Firefox. This page may not yet be available.
You are welcome to report other bugs that you find. However, please **do not report Mozilla bugs to us.** If the bug or crash occurs in both the official Mozilla Firefox and in 10.4Fx, this is a Mozilla bug, and you should file it at [Bugzilla](http://bugzilla.mozilla.org/). **You must test your bug in both places -- during the beta period, bugs that are not confirmed to be part of 10.4Fx will be marked invalid** so that we can keep our task list focused. This is the [current list of known issues](http://code.google.com/p/tenfourfox/issues/list).

204
Roadmap.md Normal file
View File

@ -0,0 +1,204 @@
Refer to [Releases - Mozilla Wiki](https://wiki.mozilla.org/Releases) for Mozilla release milestones we intend to mirror. **This document will change once source parity (see SupportLevels) is no longer possible.**
## TenFourFox 4: Beta phase ##
Done.
* ~~beta 7~~ (released 8 November 2010)
* ~~beta 8~~ (released 15 December 2010)
* ~~beta 9~~ (released 12 January 2011)
* Beta 10 was skipped.
* ~~beta 11~~ (released 2 February 2011)
* ~~beta 12~~ (released 23 February 2011). This is the final beta.
* RCs were not released.
* ~~TenFourFox 4.0 final (released 20 March 2011)~~ Retracted due to crash bug.
* ~~TenFourFox 4.0 final~~ (released 23 March 2011). Tagged internally as 4.0r.
* ~~TenFourFox 4.0 final~~ (released 24 March 2011). Tagged internally as 4.0s. Out-of-cycle security update. Note that the reported version is still 4.0.
## TenFourFox 4: Release phase ##
Pending Mozilla's work on Firefox 5, there were feature improvements to 10.4Fx 4.
* ~~4.0.1pre "beta"~~ (released 15 April 2011). This includes the improved JavaScript nanojit and enables the first work on AltiVec content acceleration.
* ~~4.0.1 "Macaw"~~ (released 22 April 2011).
* ~~4.0.2pre~~ (build 1 released 15 May 2011, build 2 released 18 May 2011). Security, performance, stability and bug fix update. This does not correspond to any official Firefox release, as Mozilla is no longer maintaining Mozilla 2.0.
* ~~4.0.2~~ (released 28 May 2011).
* ~~4.0.3~~ (released 21 June 2011). Bug and security fix rollup to follow TenFourFox 5 final. This will be the last release of 10.4Fx 4.0. No new work will be done on this branch. This completes our transition to the Mozilla rapid release schedule.
## TenFourFox 5 ##
There are no more updates planned for 5.0.
* ~~beta 1~~ (released 2 June 2011). Approximately corresponds to Firefox 5 beta 3. Introduces AltiVec-accelerated media scaling, JavaScript typed arrays, JavaScript acceleration for browser chrome and a revised build system.
* ~~beta 2~~ (released 9 June 2011). AltiVec accelerated colour conversion. Bug fixes.
* ~~RC/final~~ (released 18 June 2011). Converted to release on 21 June 2011.
## TenFourFox 6 ##
There are no more updates planned for 6.0.
* ~~beta 1~~ (released 14 July 2011). Approximately corresponds to Firefox 6 beta 2. Introduces AltiVec-accelerated text processing and conversion and faster AltiVec colour conversion and media scaling. Plugins are explicitly turned off.
* ~~RC/final (released 12 August 2011).~~ Retracted due to [issue 81](https://code.google.com/p/tenfourfox/issues/detail?id=81) and [issue 82](https://code.google.com/p/tenfourfox/issues/detail?id=82).
* ~~RC/final~~ (released 16 August 2011). Tagged internally as 6.0r. Note that the reported version is still 6.0.
* ~~6.0.1~~ (released 31 August 2011). Patch for DigiNotar malicious certificates.
## TenFourFox 7 ##
There are no more updates planned for 7.0.
* ~~beta 1~~ (released 4 September 2011). Approximately corresponds to Firefox 7 beta 4.
* ~~RC/final~~ (released 24 September 2011). Converted to release on 26 September 2011.
## TenFourFox 8 ##
There are no more updates planned for 8.0.
* ~~beta 1~~ (released 8 October 2011). Approximately corresponds to Firefox 8 beta 2. Introduces AltiVec-accelerated JPEG decoding using ImageIO.
* ~~RC/final~~ (released 5 November 2011). Converted to release on 7 November 2011.
## TenFourFox 9 ##
There are no more updates planned for 9.0.
* ~~beta 1~~ (released 1 December 2011). Approximately corresponds to Firefox 9 beta 3. Introduces YARR regular expression JIT compilation and additional AltiVec algorithm conversions. Many bug fixes.
* ~~RC/final~~ (released 17 December 2011). Secretly introduces JaegerMonkey JavaScript compilation (methodjit), turned off by default. Converted to release on 19 December 2011.
* ~~9.0.1pre~~ (released 27 December 2011). Enables methodjit by default.
## TenFourFox 10 (stable) ##
10 was based on the Firefox ESR. Although it received some 10.4Fx feature work, it did not receive new Mozilla features, though it did receive critical security and bug fixes.
* ~~beta 1~~ (released 8 January 2012). Additional AltiVec methods. Minor improvements to methodjit. Bug fixes.
* ~~RC/final~~ (released 29 January 2012). Converted to release on 30 January 2012.
* ~~10.0.1~~ (released 9 February 2012). Out-of-cycle security update. Bug fixes.
* ~~10.0.2pre~~ (released 12 February 2012). Speed improvements to JavaScript JIT. Introduces G3/G4 and G5-specific JIT code.
* ~~10.0.2~~ (released 17 February 2012). Out-of-cycle security update. Includes 10.0.2pre feature improvements.
* ~~10.0.3pre~~ (released 24 February 2012). Bug fixes. Minor speed improvements to JavaScript JIT. Fixes WebM multicore acceleration.
* ~~10.0.3RC~~ (released 7 March 2012). Additional bug fixes. No further feature development will be done on this branch. Converted to release on 12 March 2012.
* ~~10.0.4~~ (released 21 April 2012). Converted to release on 23 April 2012.
* ~~10.0.5~~ (released 2 June 2012). Official support for language packs, distributed as monkeypatch installers. Converted to release 4 June 2012.
* ~~10.0.6~~ (released 14 July 2012). Bug fixes and improved performance. Converted to release on 16 July 2012.
* ~~10.0.7~~ (released 24 August 2012). Converted to release on 27 August 2012.
* ~~10.0.8~~ (released 6 October 2012). Converted to release on 8 October 2012.
* ~~10.0.9~~ (released 12 October 2012). Out-of-cycle security update.
* ~~10.0.10~~ (released 25 October 2012). Out-of-cycle security update.
* ~~10.0.11~~ (released 15 November 2012).
Support for 10.0.x ended with 10.0.11. There are no more updates planned for 10.0.
## TenFourFox unstable (11-15) ##
Versions 11 through 15.0.1 inclusive were only released as betas.
* ~~11 beta.~~ Released 13 March 2012. Bug fixes.
* ~~12 beta.~~ Released 20 April 2012. New Azure CoreGraphics backend. Bug fixes.
* ~~13 beta.~~ Released 30 May 2012. Improved performance by eliminating PIC code. Bug fixes.
* ~~14 beta.~~ Released 13 July 2012.
* ~~15 beta.~~ Released 23 August 2012. Improved typed array code. Further performance improvements.
* ~~15.0.1.~~ Released 6 September 2012. Out-of-cycle release fixes a serious bug with private browsing mode.
* 16.0 was skipped for 17-aurora.
## TenFourFox 17 (stable) ##
17 was also based on the Firefox ESR. Like 10ESR, although it received some 10.4Fx feature work, it did not receive new Mozilla features, though it did receive critical security and bug fixes.
This was the last release series to support building with Apple `gcc` 4.0.1 or 4.2.
* ~~aurora 1~~ (released 26 September 2012). Bug fixes. Faster graphics stack.
* ~~beta 1~~ (released 13 October 2012). Bug fixes.
* ~~beta 2~~ (released 27 October 2012). Security and bug fixes.
* ~~RC/final~~ (released 16 November 2012). Converted to release 19 November 2012.
* ~~"17.0.1pre"~~ (released 24 November 2012). Improved threading performance.
* ~~17.0.1~~ (released 30 November 2012). Out-of-cycle Mozilla bug fix release. Performance improvements.
* ~~17.0.2~~ (released 6 January 2013). Font performance improvements and bug fixes. Converted to release 8 January 2013.
* ~~17.0.3~~ (released 16 February 2013). Further multithreading performance improvements on multiprocessor Power Macs. Converted to release 18 February 2013.
* ~~17.0.4~~ (released 8 March 2013). Out-of-cycle security update.
* ~~17.0.5~~ (released 29 March 2013). Fixes IndexedDB support. Converted to release 1 April 2013.
* ~~17.0.6~~ (released 10 May 2013). Includes canvas crash fix. Converted to release 13 May 2013.
* ~~17.0.7~~ (released 21 June 2013). Includes colour management fixes. Converted to release 23 June 2013.
* ~~17.0.8 (released 3 August 2013).~~ Retracted by Mozilla due to incomplete security fix.
* ~~17.0.8~~ (released 5 August 2013). Tagged internally as 17.0.8r.
* ~~17.0.9~~ (released 12 September 2013). Includes methodjit fixes. Converted to release 16 September 2013.
* ~~17.0.10~~ (released 25 October 2013). Converted to release 28 October 2013.
* ~~17.0.11~~ (released 14 November 2013). Out-of-cycle security update.
Support for 17.0.x ended with 17.0.11. There are no more updates planned for 17.0.
## TenFourFox unstable (19-22) ##
Versions 19 through 22 inclusive were only released as betas, including an extended 22 support branch that does not correspond to any official version of Firefox. This unstable branch mandated using <tt>gcc</tt> 4.6.3 and appropriate bintools, migrating from <tt>gcc</tt> 4.0.1/4.2 used for 17 and earlier versions. Due to irrevocable internal API changes, plugin support was completely removed in 19.
* 18 was skipped for 19-aurora.
* ~~"19b1"~~ (released 13 January 2013). Upgrade to new compiler and toolchain. AltiVec-accelerated blurring and shadows. Font performance improvements.
* ~~19 beta final.~~ Released 14 February 2013.
* ~~19.0.2.~~ Released 9 March 2013. Out-of-cycle security update. Note: there was no 19.0.1 release; that version number was reserved for an interim mobile Firefox release.
* ~~20 beta.~~ Released 2 April 2013. Also includes IndexedDB fix.
* ~~21 beta.~~ Released 8 May 2013.
* ~~22 beta.~~ Released 25 June 2013. Also includes colour management fix.
* ~~22.0.1.~~ Released 11 August 2013. Performance improvements to opacity, CPU cores, gradients and garbage collection. This is an interim release that does not correspond to an official version of Firefox. 23 beta was skipped for work on 24.
* ~~22.0.2.~~ Released 21 September 2013. Bugfixes to methodjit and script timeouts. This is an interim release that does not correspond to an official version of Firefox. There are no more updates planned for 22.0.
## TenFourFox 24 (stable) ##
24 was also based on the Firefox ESR. It removed the old JaegerMonkey JavaScript compiler, replacing it with PPCBC, the PowerPC-optimized version of Mozilla BaselineCompiler.
Like 10ESR and 17ESR, although it received some 10.4Fx feature work, it did not receive new Mozilla features, though it did receive critical security and bug fixes.
Unlike previous ESR versions, this ESR introduced a more typical major-minor numbering system with the third number incremented only for chemspills and emergency releases.
* ~~24.0 beta.~~ Released 16 October 2013.
* ~~24.1 beta.~~ Released 7 November 2013. Downloads moved to SourceForge because Google is a big meanie.
* ~~24.2 final~~, completing the transition, released 7 December 2013.
* ~~24.3~~ (released 2 February 2014). Bug fixes. Converted to release 3 February 2014.
* ~~24.4~~ (released 16 March 2014). Bug fixes. Converted to release 17 March 2014.
* ~~24.5~~ (released 25 April 2014). Bug fixes. Converted to release 27 April 2014.
* ~~24.6~~ (released 7 June 2014). Converted to release 9 June 2014.
* ~~24.7~~ (released 21 July 2014).
Support for 24.x ended with 24.7. There are no more updates planned for 24.0.
## TenFourFox unstable (26-29) ##
Versions 26 and 29 were only released as betas. The new Australis interface was introduced in version 29.
* 25 was skipped for further work on 24.
* 26 was issued as changesets only.
* 27 and 28 were skipped for Australis work on 29.
* ~~29 beta.~~ Released 29 April 2014 for G5 and G4-7450 only (for 10.5 testing). Introduces Australis interface. Tweaked garbage collection. Improved `xptcall` performance, especially on G5.
* 30 was skipped for work on 31.
## TenFourFox 31 (stable) ##
This is the current stable release for TenFourFox. Like previous ESR stable releases, it received some 10.4Fx feature work and critical security and bug fixes.
* ~~31.0 beta 1.~~ Released 16 June 2014.
* ~~31.0 beta 2.~~ Released 20 June 2014. Critical fixes including [issue 276](https://code.google.com/p/tenfourfox/issues/detail?id=276).
* ~~31.0 beta 3.~~ Released 4 July 2014. Performance improvements.
* ~~31.0 final~~ (released 18 July 2014). Converted to release 21 July 2014.
* ~~31.1.0~~ (released 30 August 2014). Performance improvements, fix to trackpad scrolling. Converted to release 1 September 2014.
* ~~31.1.1~~ (released 24 September 2014). Out-of-cycle security update.
* ~~31.2.0~~ (released 11 October 2014). Converted to release 13 October 2014.
* ~~31.3.0~~ (released 27 November 2014). Performance improvements. Converted to release 8 December 2014.
* ~~31.4.0~~ (released 10 January 2015). Performance improvements to garbage collection and streaming, and bug fixes. Converted to release 12 January 2015.
* ~~31.5.0~~ (released 21 February 2015). Converted to release 23 February 2015.
* ~~31.6.0~~ (released 29 March 2015). Converted to release 31 March 2015.
* ~~31.7.0~~ (released 9 May 2015). Converted to release 11 May 2015.
* 31.8.0 (released 26 June 2015).
Support for 31.x will end with 31.8.0. There are no more updates planned for 31.0.
## TenFourFox unstable (33-36) ##
These releases were changeset-only.
## TenFourFox 38 ##
This is the next scheduled stable release for TenFourFox. IonPower and MP3 audio support is scheduled for this release, timetable and milestones permitting. This will be the final browser build to support `gcc` 4.6.
* ~~38.0.1 beta 1~~. Released 28 June 2015.
* 38.1.1 beta 2. Released 1 August 2015. Critical fixes.
* 38.2 final scheduled for 11 August 2015
## TenFourFox 39+ ##
Under review due to technical limitations of OS X Tiger.

21
SupportLevels.md Normal file
View File

@ -0,0 +1,21 @@
TenFourFox "10.4Fx" is designed to be as close to Mozilla sources as possible, for as long as possible. Of course, since our code is not part of the Mozilla Mercurial repo and is simply a local commit, we can also confidently assume that other parts of the tree that we currently rely on for building will disappear as Mac OS X dissolves into that great mug of Cocoa in the sky. Rest assured that 10.4Fx will not be appearing in the Mac App Store any time soon or ever, because we abuse Apple private frameworks, don't build Universal, and still use Carbon API calls for certain portions of code. At some point as APIs break or are inevitably decommissioned by Steve Jobs' talking turtleneck, one day it will no longer be possible to hack Mozilla's code into building directly and our support level will change. This document explains our policies on what to do when that day finally arrives, and what you can expect in general terms down the road.
Support levels for 10.4Fx are defined in terms of "parity," viz., how similar we are to the Mozilla repository we are based on. We've provisionally defined three levels of parity, as follows:
### Source parity ###
This means that we are still building from a Mozilla repository, either the cutting-edge http://hg.mozilla.org/mozilla-central >>> `mozilla-central` or one of the version branches that they still maintain, using our local changeset for compatibility only. Instead of distributing the entire source, we will simply distribute our changeset and binaries; you clone their repo and apply our changeset to your local repo to build.
This is the current state and the most favourable, as it implies both feature and security parity with official tier 1 Firefox builds. Maintaining source parity as long as possible is goal #1, as when we degrade to feature parity the closer we are to current source the more successful feature updates will be. However, there is a disadvantage in source parity in that it may be harder to integrate custom features. Source parity state is likely to be one to two years, given the pace and nature of previous Mozilla releases.
### Feature parity ###
This means that we are no longer building directly from a Mozilla repository but instead from our own codebase, which was once a Mozilla-supported repo and is no longer (cf. Camino 2.0.x building from Firefox 3.0.19, which has not been supported since March 2010). Since our source is now diverging, we maintain it ourselves. Dropping to feature parity implies that the most current Mozilla as written cannot be hacked to compile anymore. Once we have degraded support to this point, we will maintain our own Mercurial repo with our own changes.
What is likely to provoke this state? Among others, the biggest killers would be requiring a compiler more advanced than `gcc` 4; requiring the Objective-C 2.x runtime; complete deprecation of Carbon; or requiring hardware OpenGL. These are currently incompatible with the Tiger build system, which 10.4Fx specifically supports.
Still, feature parity implies that we will do our best, within technical limits, to match the feature set of the current Firefox even if we are not using the same source necessarily. This typically involves monitoring Mercurial changesets and [Bugzilla](https://bugzilla.mozilla.org/) bugs for patches, and adapting and/or applying them if they are deemed useful. Only useful or critical features will be so ported, to avoid turning the browser into a series of potentially unstable patches of patches. Security parity, naturally, is considered just this sort of critical patch, but other improvements to rendering and performance will also be considered. Also, feature parity does not preclude implementing our own custom features, since the code base is ours, which is a small advantage.
### Security parity ###
This means the browser has reached a point of maximum technical evolution, either due to completely incompatible code or the processing limits of aging machines, and is the terminal stage of support. Although some custom features may be added, the browser core is essentially in a state of arrested development. However, bugs will still be fixed, and Mozilla security advisories will still be backported such that the browser will still be safe for day-to-day use even if it is no longer evolving technologically. Security parity state will likely persist for several years after source parity has ended.

22
TechnicalDifferences.md Normal file
View File

@ -0,0 +1,22 @@
TenFourFox "10.4Fx" is designed to be as close to Mozilla sources as possible, for as long as possible (see SupportLevels for how we plan to deal with the inevitable code divergence). In general, pretty much anything that applies to Firefox applies to 10.4Fx. However, because of limitations in earlier versions of OS X that we still support, there are some omissions and changes in features that should be noted by users and porters, and 10.4Fx also adds new PowerPC-specific features that are unique.
* 10.4Fx, as of 5.0, does currently support the Mozilla IPC system, but only insofar as it is needed to build. The actual IPC internals only work between threads and not processes.
* Because of increasingly poor plugin support on Tiger and PowerPC, plugins ship disabled in 10.4Fx 6.0, and no longer function at all in 19.0 and up. This is both for reasons of security (particularly with Flash) and the use of incompatible later OS X APIs. Bug reports related to plugins will not be accepted. See PluginsNoLongerSupported.
* 10.4Fx, as of 4.0.1pre, uses a modified `libvpx` with AltiVec to accelerate WebM video playback instead of the baseline C version in 4.0 and earlier versions ([issue 28](https://code.google.com/p/tenfourfox/issues/detail?id=28)). The baseline C version is still used for the G3 build, which lacks VMX. It is the only browser known to use this code.
* OpenGL support is presently disabled in 10.4Fx. This is Apple's fault, as Mozilla requires non-power-of-two texture sizes, which require OpenGL 2. Unfortunately, PPC Tiger does not support OpenGL 2 at all, and only a subset of cards support it in PPC Leopard (the really irritating part is that Intel Tiger _does_ have OpenGL 2, and OpenGL 2 came out in 2004!). It may be enabled in the future for those handful of configurations on Leopard, but this won't benefit the majority of users. Note that many graphics features will work just fine; they just won't be hardware-accelerated.
* Because there is no OpenGL 2, there is no WebGL. The Linux version of Firefox has a fallback to libOSMesa, which is a software OpenGL rendering library, and we are hoping to abuse that for our purposes. Some work has been done on porting this to 10.4 without the X11 dependencies so that it is a pure renderer suitable for this task, but it is currently not working. The libOSMesa that is built-in to 10.4 cannot be used, because it is not OpenGL 2 (10.5's may be useable, but this is not yet explored or enabled).
* As of 4.0 beta 9, 10.4Fx offers JavaScript just-in-time compilation with its custom PowerPC backends.
* Versions 4.0b9 through 9.0 defaulted to a custom PowerPC-enabled nanojit for JavaScript acceleration through tracejit/TraceMonkey ([issue 15](https://code.google.com/p/tenfourfox/issues/detail?id=15)) using code written for Tamarin by Adobe. This compiler was gradually decommissioned in 10.x, and completely disabled in 10.0.6.
* As of 9.0 RC, 10.4Fx introduced its own PowerPC method compiler for JavaScript acceleration through methodjit/JaegerMonkey ([issue 96](https://code.google.com/p/tenfourfox/issues/detail?id=96)); it became the default compiler in 10.4Fx 10, and later fully supported type inference. Methodjit support ended with Firefox 24. Parts of this compiler are still used for YARR regular expression support.
* 10.4Fx does not yet support IonMonkey, but a port is in progress ([issue 178](https://code.google.com/p/tenfourfox/issues/detail?id=178)). However, 10.4Fx does support PPCBC, a PowerPC-specialized form of BaselineCompiler ([issue 224](https://code.google.com/p/tenfourfox/issues/detail?id=224), [issue 245](https://code.google.com/p/tenfourfox/issues/detail?id=245)).
* All text rendering in 10.4Fx uses HarfBuzz, an OpenType font shaper. While some portions of code leverage Tiger's private CoreText framework (yes, CoreText is in Tiger too), Tiger's CoreText does not support enough font features to allow Mozilla's built-in CoreText shaper to function correctly. HarfBuzz actually works just fine for the vast majority of cases, and appears to be faster overall to boot, so this is a net win. However, installed fonts and scripts that require Apple Advanced Typography features to correctly render, such as Indic and Arabic fonts, will not have correct ligatures or glyph substitution or reordering. This is because HarfBuzz cannot interpret AAT information encoded in the fonts that come standard with OS X, and Tiger CoreText does not provide enough support for controlling individual glyph positions to provide a fallback. Although the characters will appear on-screen, they may not be linked or ordered properly. If the site provides an OpenType-equivalent, however, some scripts may be able to display correctly (and more will work correctly in the future). Most European and other Asian characters and scripts obviously work fine, of course. For more information, see [issue 5](https://code.google.com/p/tenfourfox/issues/detail?id=5).
* Bitmap-only fonts cannot be rendered by HarfBuzz. 17.0 and up filter them out and select a fallback.
* For reasons of UI/UX harmony, certain UI elements are preserved in 10.4Fx that are not in Firefox 4 and later, such as Check For Updates under the Application menu. These smaller changes are unlikely to be noticed by add-ons.

23
VideoDeviceSupport.md Normal file
View File

@ -0,0 +1,23 @@
As of TenFourFox 20, you can use your Power Macintosh's camera or QuickTime-compatible video or audio device to upload photos and video (securely, of course! -- you will always be asked). You can see if your device works with our [user media test page](http://www.floodgap.com/software/tenfourfox/gum_test.html) (don't worry, your images and audio are _not_ uploaded).
However, it is not possible to support all devices. In general, most audio devices will work, but video devices that do not export a standard 640x480 video image and are not IIDC or QuickTime compatible will _not_ work. Some IIDC-compatible FireWire cameras may send a non-standard image, for example, despite being otherwise compliant. These will generate a scrambled image in TenFourFox.
Built-in audio (through the line-in/microphone port) is supported on all supported Macintosh models and is always available. USB audio should work, but has not been tested.
It may be possible to get certain USB webcam devices working with the `macam` driver (available separately). While we can't necessarily support these ourselves, we'd like to know if they at least do work. Other USB video sources may not be compatible. Again, if they don't work with QuickTime, they will almost certainly not work with TenFourFox.
Please post working and non-working devices in the comments. We will try to support as many devices as reasonably possible within technical constraints.
## Working and supported ##
iSight FireWire -- both audio and video (using built-in 10.4 IIDC driver)
HP HD-3110 USB -- both audio and video (using built-in 10.4 UVC driver)
Logitech HD Webcam C310 USB -- both audio and video (using built-in 10.4 UVC driver)
## Not working (yet) ##
Rocketfish HD Webcam USB -- audio only, scrambled image (using built-in 10.4 UVC driver)
Orange Micro iBOT FireWire -- scrambled image (using built-in 10.4 IIDC driver)

37
WhichABI.md Normal file
View File

@ -0,0 +1,37 @@
# PowerPC: one architecture, many ABIs #
The PowerPC specification does not define an application binary interface, which is important for people trying to use TenFourFox JIT backends on non-OS X systems such as Linux PPC, AIX, etc. By default (if `JS_CPU_PPC_OSX` is set), TenFourFox JIT backends generate code which is ABI-compliant with Mac OS X. Unfortunately, this code is unlikely to work on systems that do not implement the same ABI. Since there are few documents collecting the various ABI used by a particular PowerPC-compatible operating system, this document tries to pull this information together for the convenience of porters.
Most PPC operating systems of recent provenance are either based on IBM's PowerOpen (Mac OS X, AIX, System i), or on UNIX System V "SysV" ABI (Linux, other BSDs, AmigaOS). This is an excellent comparison of OS X and SysV ABIs: http://www.engr.uconn.edu/~zshi/course/cse4903/refs/ppc_inst.pdf
Copies of the SysV ABI reference documentation are available many places for a variety of executable formats, including http://math-atlas.sourceforge.net/devel/assembly/elfspec_ppc.pdf
**Please note that TenFourFox is specifically for Mac OS X; this document would be of most relevance to people porting standard Firefox or SeaMonkey to a PowerPC platform running some other operating system using TenFourFox-originated code. Please help maintain this list by adding (reliable) links to documentation on a particular ABI, or the ABI for your operating system.**
---
## AIX ##
PowerOpen http://www.ibm.com/developerworks/library/pa-nlaug04-introembeddev/index.html
## BeOS ##
Be ABI (need docs)
## AmigaOS 4, MorphOS and compatible ##
Legacy 68K for code that must call 68K libraries; SysV otherwise. See http://wiki.freepascal.org/AmigaOS and http://wiki.freepascal.org/MorphOS
## Linux PPC ##
SysV
## Mac OS, Mac OS X ##
modified PowerOpen http://developer.apple.com/library/mac/documentation/DeveloperTools/Conceptual/LowLevelABI/000-Introduction/introduction.html
## NetBSD/macppc ##
SysV http://gcc.gnu.org/ml/gcc/2000-12/msg00309.html (other BSDs should also be SysV)
## IBM System i ##
PowerOpen
## WarpOS ##
modified PowerOpen

21
WhichVersion.md Normal file
View File

@ -0,0 +1,21 @@
TenFourFox comes in tuned builds for specific processor families. Choosing the wrong one could make the application crash, or run poorly. While the G3 version is generic and will run on any supported Macintosh, it is also the poorest performer on later Power Macs; similarly, you cannot run the G4 or G5 versions on a G3 as the application will behave incorrectly.
Here's how to select which one you need:
* G3 and G5 owners, just download the G3 and/or G5 build, respectively. These versions run on any G3 or G5 Power Macintosh.
* G4 owners, you need to determine if your G4 is a 7450-series CPU ("G4e"), such as the 744x or 745x series, or a 7400-series CPU, such as the 7400 and 7410. Typically the "G4e" series of CPU are in most G4s at and over 733MHz.
> The wrong version will work on your machine, but will not run as well. The easiest way to find out which version you should use is to open `Terminal.app` and type `machine`. Your output will probably look like this:
```
[old-sawtooth]$ machine
ppc7400
[new-ibook]$ machine
ppc7450
```
> Then grab either the 7400 or 7450 build based on the result.
**If you do not see `ppc750`, `ppc7400`, `ppc7450` or `ppc970`, then you do not have a Power Mac.** For example, many Intel Macs report `i486`. **TenFourFox is not officially supported on Intel Macs.** However, many users report the G3 version appears to work for them, but slowly, because it must run under Rosetta. Other architecture builds may crash. You are strongly advised to also read [our FAQ and the question about running 10.4Fx on an Intel Mac](AAATheFAQ.md).