#####################################################################
##
## Seamonkey v1.1.7 for Solaris 8 (SPARC) GTK1.2 and higher
##
## Build platform: SunBlade 100 (Solaris 8 2/04)
## Compilers used: Sun Studio 11 (Patched to 1st November 2007)
## Build date    : 17th December 2007
## Build by      : Michael Kelleher (michael.kelleher@analog.com)
##
#####################################################################

This build of Seamonkey 1.1.7 was produced on a sparc-sun-solaris2.8 platform.
Build options chosen to optimise Seamonkey for UltraSPARC 2+ processors.
Queries about this build to Michael Kelleher (michael.kelleher@analog.com).
Any bugs/issues should be reported in the Bugzilla support site (http://bugzilla.mozilla.org).



#####################################################################
## INSTALLATION NOTES
#####################################################################
    * Executables are dynamically linked against Gtk.  You will need to set
      LD_LIBRARY_PATH to the directory where your Gtk 1.2.10 shared libraries
      are installed.

      It is recommended that you also keep a copy of the libraries in the Seamonkey directory
      The Gtk libraries should reside in <installed-location>/dist/lib.
      Set your LD_LIBRARY_PATH to include this directory.


    * If you get a lot of warnings on startup like

          Gdk-WARNING **: shmat failed!

      then you may need to increase your shared memory segment sizes.
      On Solaris 8, you can add the following lines to /etc/system and
      reboot (with a reconfigure):

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


    * Ensure the GTK 1.2 libraries have been compiled with a version of Sun's compilers.
      The compilers are free to download from the Sun website (http://www.sun.com).
      Installing GTK 1.2 libraries is only applicable to Solaris 8 (Solaris 9+ includes GTK 1.2 by default).
      Alternatively you can use the GTK packages that come with Solaris 9 on a Solaris 8 system.
      The GTK libraries in those packages will install in /usr/sfw


    * NOTE: The Solaris patch checker is out of date and you may need updated C++ patches on your system.
      Solaris 8 (SPARC) systems may need 108434-18+ and 108435-18+
      Solaris 9 (SPARC) systems may need 111711-12+ and 111712-12+
      If Seamonkey crashes with a "fatal: relocation error/referenced symbol not found" type error then
      most likely these patches will need updating.


    * After a number of requests from people this build has the LDAP feature enabled.
      I have tested it against a Sun ONE Directory server and Active Directory and both worked for me.

      An example of adding an Active Directory directory to the list of Directory servers in the Address Book is...
      Name: Company Active Directory		<-- Logical name of server.
      Hostname: limkdc1.ad.analog.com		<-- Hostname of an AD server.
      Base DN: ou=users,ou=limk,dc=ad,dc=analog,dc=com		<-- NT admin can give you this.
      Port number: 389		<-- This is the default but can change.
      Bind DN: CN=Kelleher\, Michael,OU=Users,OU=LIMK,DC=ad,DC=analog,DC=com	<-- Almost same as base DN with my full name in AD.

      If you want to get Seamonkey to lookup names while creating emails then go to the "Composition & Addressing" tab
      in the account settings and select the "Use a different LDAP server" and click on your Logical name chosen above.
      Please don't query me for help on getting this working for you, your NT admin should know this information.


 
#####################################################################
## COMPILERS AND LIBRARIES USED
#####################################################################
The following tools/libraries were used for compilation:
    Sun Studio 11
    GNU Make 3.80
    GTK 1.2.10
    libIDL 0.6.8



#####################################################################
## OPTIONS USED TO CONFIGURE SEAMONKEY BEFORE COMPILING
#####################################################################
The following options were used in the .mozconfig file before compiling Seamonkey
ac_add_options --enable-application=suite
ac_add_options --enable-optimize=-xO4
ac_add_options --enable-crypto
ac_add_options --enable-xinerama
ac_add_options --enable-image-decoders=all
ac_add_options --enable-extensions=all
ac_add_options --enable-x11-shm
ac_add_options --enable-ctl
ac_add_options --enable-default-toolkit=gtk
ac_add_options --enable-ldap
ac_add_options --disable-tests
ac_add_options --disable-debug
ac_add_options --disable-auto-deps
ac_add_options --with-xprint
mk_add_options MOZ_CO_PROJECT=suite
mk_add_options BUILD_OFFICIAL=1
mk_add_options MOZILLA_OFFICIAL=1



#####################################################################
## COMMANDS TO COMPILE SEAMONKEY
#####################################################################
The following commands were used to build the distribution (Bourne and Korn shells):
  $ MOZILLA_OFFICIAL=1;export MOZILLA_OFFICIAL
  $ BUILD_OFFICIAL=1;export BUILD_OFFICIAL
  $ CFLAGS="-xlibmil -xstrconst -mt";export CFLAGS
  $ CXXFLAGS="-xlibmil -xlibmopt -features=tmplife -norunpath -mt";export CXXFLAGS
  $ LD_FLAGS="-R$ORIGIN -R/usr/sfw/lib";export LD_FLAGS
  $ LD_LIBRARY_PATH="/opt/SUNWspro/lib:/usr/lib:/usr/openwin/lib:/usr/sfw/lib:/opt/sfw/lib:.";export LD_LIBRARY_PATH
  $ gmake -f client.mk build_all
  $ cd xpinstall/packager
  $ gmake



#####################################################################
## OPTIONAL MODIFICATIONS TO DEFAULT PREFERENCE FILES
#####################################################################
Below are a list of some optional configuration changes we make to
the Seamonkey configuration files for use in a corporate environment.
You can choose to use any of the changes if they help.

We use standard western fonts, if you are not in that location then
choose an alternative font. We disable Java by default as it's a hog
on system resources.

We also use the UK English dictionary so we specify to use it in the
preferences file.

FILE: seamonkey/defaults/pref/mailnews.js
  pref("mail.migration.copyMailFiles", false);
  pref("mail.migration.copyMailFilesPopupWindow", false);
  pref("mailnews.headers.showOrganization", true);
  pref("mail.identity.organization", "Your Company Name");
  pref("mail.server.default.empty_trash_on_exit", true);
  pref("spellchecker.dictionary", "en-GB");

FILE: seamonkey/greprefs/all.js
  pref("font.FreeType2.enable", true);
  pref("font.name.serif.x-western", "adobe-helvetica-iso8859-1");
  pref("font.name.sans-serif.x-western", "adobe-helvetica-iso8859-1");
  pref("font.name.monospace.x-western", "adobe-helvetica-iso8859-1");
  pref("font.default", "sans-serif");
  pref("font.size.variable.x-western", 12);
  pref("font.minimum-size.x-western", 12);
  pref("print.print_edge_top", 25);
  pref("print.print_edge_left", 25);
  pref("print.print_edge_right", 25);
  pref("print.print_edge_bottom", 25);
  pref("network.http.pipelining", true);
  pref("network.http.proxy.pipelining", true);
  pref("network.http.pipelining.maxrequests", 100);
  pref("browser.cache.disk.capacity", 5120);
  pref("security.enable_java", false);
  pref("browser.display.use_document_fonts", 0);



#####################################################################
## OPTIONAL CONFIGURATION STEPS
#####################################################################
The following are a list of optional steps that can be done on Seamonkey.
   * Seamonkey is built by default with the US English spelling dictionary.
     If you require a different language then you'll need to download it
     from... http://www.mozcafe.com/download
     You then place your dictionary files in 'seamonkey/components/myspell'.
     You can remove the en-US files if you don't want the US dictionary.


   * If you need to configure default MIME-TYPES so the right application
     will automatically start when you click on a link then you must modify
     the file 'seamonkey/defaults/profile/mimeTypes.rdf'. Please save a copy
     of this file incase you re-install Seamonkey again.


   * Plugins for Flash, Java, and Acrobat Reader are located in 'seamonkey/plugins'.
     You can link to the plugin on your local installation of Java by running...
     username% cd seamonkey/plugins
     username% ln -s /usr/java/jre/plugin/sparc/ns610/libjavaplugin_oji.so
     <OR> (for Java 1.5)
     username% ln -s /usr/java/jre/plugin/sparc/ns7/libjavaplugin_oji.so
     NOTE: Your version of Java should be at least 1.4 or higher.
     We choose to disable the plugin as it is a hog on system resources.
