
******************** MOZILLA 1.2.1  README ********************


READ THIS DOCUMENT BEFORE INSTALLING MOZILLA 1.2.1

This build of mozilla 1.2.1 was produced on a sparc-sun-solaris2.8 platform.
If you encounter any problem with the package,
you may contact Henry Jia <henry.jia@sun.com>

This build was made from the MOZILLA_1_2_1_RELEASE tagged sources in the CVS
repository.

--------------------------------------------------------------------------------
SUPPORT
--------------------------------------------------------------------------------
Mozilla 1.2.1 is supported under the SunSpectrum support program.
Customers with a SunSpectrum Metal support contract for their system 
or with a SunSpectrum Software only option for Solaris are entitled
to support for Mozilla 1.2.1 .  For additional information on Solaris
Software Support please refer to  

       http://www.sun.com/service/support/sw_only/solaris1.html


By default, the "mozilla" shell script, the script you will use to start
Mozilla 1.2.1 , will redirect all of its output to the /dev/null
file. However, this is not very useful when a problem occurs. If you 
are having a problem with Mozilla 1.2.1 , run the "mozilla" script 
with the "-debug" option and use the generated output when reporting problems. 

--------------------------------------------------------------------------------
SYSTEM REQUIREMENTS
--------------------------------------------------------------------------------

Mozilla 1.2.1  can run on:
   - Solaris for SPARC(TM) with Solaris version 8, or
   - Solaris for SPARC(TM) with Solaris version 9.

--------------------------------------------------------------------------------
INSTALLATION INSTRUCTIONS
--------------------------------------------------------------------------------

1.Set LD_LIBRARY_PATH

Executables are dynamically linked against Gtk. You will need to set
LD_LIBRARY_PATH to the directory where your Gtk 1.2 shared libraries
are installed. You can do this before starting mozilla or edit
run-mozilla.sh. Please note that this build is built using Sun's Forte
compiler. If you don't have a Forte compiled Gtk, you will need to
get one from the Sun's Netscape 7 bundle below:

http://wwws.sun.com/software/solaris/netscape/getnetscape70.html


2. JAVA

This build does not include the Java bundle. You will need to set
up the link yourself in order to have Java support. See example below:

$ cd <mozilla-installed-location>/plugins
$ ln -s <java-installed-location>/jre/plugin/sparc/ns610/libjavaplugin_oji.so
	<mozilla-installed-location>/plugins/libjavaplugin_oji.so

You can install the latest version of Java from

	http://java.sun.com


3.Known-problems

1)After installing all the files you must run mozilla as
the user who installed the files (e.g. root if the files are owned by
root) once to create the file `components.reg'. If you don't,
mozilla will crash on startup. This is documented behavior that
Netscape has so far declined to fix; see
http://bugzilla.mozilla.org/show_bug.cgi?id=49345 for details.

2)If you get a lot of warnings on startup like

Gdk-WARNING **: shmat failed!

then you may want to increase your shared memory segment sizes.
On Solaris 8, you can add the following lines to /etc/system and
reboot:

Set for libgtk shared memory usage
	set shmsys:shminfo_shmmax = 8388608
	set shmsys:shminfo_shmmni = 0x1000
	set shmsys:shminfo_shmseg = 0x100


4. Used tools/libraryies/commands

The following tools/libraries were used for compilation:
Forte 6 Update 1
plus patches 109513-05, 109508-03, 109505-0, 109510-03, 109516-02
GNU Make 3.75
GTK 1.2.10

The following commands were issued to check out and build the distribution:

$ cvs -d :pserver:anonymous@cvs-mirror.mozilla.org:/cvsroot co -r MOZILLA_1_2_1_RELEASE mozilla/client.mk
$ cd mozilla
$ gmake -f client.mk checkout
$ cat << EOF > .mozconfig
ac_add_options --disable-tests
ac_add_options --disable-debug
ac_add_options --with-xprint
ac_add_options --enable-xinerama
ac_add_options --enable-ldap
ac_add_options --enable-crypto
ac_add_options --enable-x11-shm
ac_add_options --with-glib-prefix=/usr/sfw
ac_add_options --with-gtk-prefix=/usr/sfw
ac_add_options --with-libIDL-prefix=../dist
ac_add_options --enable-ctl
EOF

$ export MOZILLA_OFFICIAL=1
$ export BUILD_OFFICIAL=1
$ export NS_USE_NATIVE=1
$ export CFLAGS="-xO5 -xlibmil"
$ export CXXFLAGS="-xO5 -xlibmil -xlibmopt"
$ gmake -f client.mk build_all
$ cd xpinstall/packager
$ gmake 


================================================================================
Copyright 2002 Sun Microsystems, Inc.,  4150 Network Circle, Santa Clara,
California 95054 U.S.A. All rights reserved.

Sun, Sun Microsystems, Java, SunOS, OpenWindows, and Solaris are trademarks, 
registered trademarks, or service marks of Sun Microsystems, Inc. in the U.S.A. 
and other countries. All SPARC trademarks are used under license and are 
trademarks or registered trademarks of SPARC International, Inc. in the U.S.A. 
and other countries. Products bearing SPARC trademarks are based upon an 
architecture developed by Sun Microsystems, Inc. Netscape is a trademark of 
Netscape Communications Corporation.  PostScript is a trademark of Adobe 
Systems, Incorporated, which may be registered in certain jurisdictions.  
