This directory contains Solaris builds of Firefox 52.0 ESR,
which are contributed by Oracle Solaris Desktop Beijing Team.
If you have any problem with these builds, please send email to
ginnchen at gmail dot com

This is the last contrib build before I leave Oracle.
My job is eliminated.
Thanks everyone for supporting me.
ginnchen@gmail.com

What's New:
-----------
52.0
X multithread is re-enabled on Solaris 10.
If you have drag & drop X hang issue, update your Xserver or stay with 45.x.
If you are on Sun Ray, stay with 45.x.

Solved the exit crash issue.

Fontconfig 2.8.0 or above is required for version > 45.0.
A library of fontconfig 2.8.0 is included in Firefox/Thunderbird
for Solaris 10 contrib build.
For OpenSolaris, you need to install Fontconfig 2.8.0 by yourself.

Installation:
-------------
* Tarball format

Extract the tarball to a proper location[1]
$ bzip2 -dc <tarball basename>.tar.bz2 | tar -xf -

[1]: Make sure there is no firefox directory there before you 
extract the tarball, it's not recommended to just overwrite the old 
firefox directory.

* Pkgadd format

1, First uncompress the zip file
$ bzip2 -d <zip file basename>.bz2 
You will get a package datastream file named <zip file basename>

2, Install the package as root
# pkgadd -d ./<zip file basename>
The default install location would be /opt/sfw/lib/firefox


To Enable Java:
---------------
cd /path/to/<install location>/plugins
ln -s /path/to/<jave home>/lib/<sparc|i386>/libnpjp2.so
Run Firefox with:
LD_PRELOAD_32=/usr/lib/libCstd.so.1 firefox

To Enable Flash Player:
--------------------------
1, Download the Flash Player plugin from
http://get.adobe.com/flashplayer/

2, Extract the tarball and place the files under
/path/to/<install location>/plugins


To Run The Application:
-----------------------
a, Execute the application by specifying the absolute path 
$ /path/to/<install location>/firefox

b, Add <install location> to your PATH and execute "firefox"

c, Add the desktop file and start from menu(pkgadd format only)
# cat >/usr/share/applications/firefox.desktop<<EOF
[Desktop Entry]
Version=1.0
Encoding=UTF-8
Type=Application
Exec=/path/to/<install location>/firefox
TryExec=/path/to/<install location>/firefox
Icon=/path/to/<install location>/icons/mozicon50.xpm
X-GNOME-DocPath=
Terminal=false
Name=firefox
GenericName=firefox
Comment=firefox
Categories=Application;Network;
EOF


Troubleshooting:
----------------

* If you could not start up the application or encounter some 
unexpected crash, try to do this,

1, Rename the profile directory("$HOME/.mozilla" for Mozilla suite, 
"$HOME/.mozilla/firefox" for Firefox and "$HOME/.thunderbird" for 
Thunderbird)

2, Start up the application without importing anything

* For Solaris 10 users, if you have font display problems or crashes with some pages.
Please apply the fontconfig and Freetype patch.
#138353, #119813 (x86)
#138352, #119812 (SPARC)

Build Configuration:
--------------------
* Firefox and Mozilla suite

Start up Mozilla/Firefox that you just installed and type 
"about:buildconfig" in the URL field, and then you would see all the 
build configurations used for this build.

* Thunderbird

Extract "buildconfig.html" from <install location>/chrome/toolkit.jar, 
which records all the build configure information of this build. 
$ jar xf /path/to/<install location>/chrome/toolkit.jar \
    content/global/buildconfig.html