1. Introduction
   1.1. Project/Component Working Name:
        Firefox 3.1 for Solaris Nevada

   1.2. Name of Document Author/Supplier:
        Author: Brian Lu 
        Sponsor: John Fischer

   1.3. Date of This Document:
        Nov 21th, 2008

2. Project Summary
   2.1. Project Description:

        Firefox 3.1 is an upcoming version of Firefox which is based on 
        an improved rendering engine Gecko 1.9.1. 
   
        Firefox 3.1 supports CSS 2.1, CSS 3.0 and <video>, <audio> elements defined
        in HTML5.


4. Technical Description:
   4.1. Details:

        . Web standards improvements in the Gecko layout engine

          Firefox 3.1 is based on the new Gecko 1.9.1 Web rendering platform which
          is an incremental release with significant changes to improve web compatibility,
          performance and ease of use. 
     
        . Added support for CSS 2.1 and CSS 3 properties

          Newly supported features:
            * CSS media queries
            * @font-face allows sites to link to downloadable fonts so that Firefox may render sites more precisely as intended 
 
          Newly supported CSS properties:

            * text-shadow
            * box-shadow as -moz-box-shadow
            * border-image as -moz-border-image
            * column-rule as -moz-column-rule , -moz-column-rule-width , -moz-column-rule-style , and -moz-column-rule-color
            * column-gap as -moz-column-gap
            * word-wrap
            * pre-line as a white-space value.
            * Remove support for the deprecated -moz-opacity in favor of opacity
            * Added the custom color value -moz-nativehyperlinktext, which selects the computer's native hyperlink color.
            * -moz-window-shadow for controlling window shadows and -moz-system-metric(mac-graphite-theme) for determining 
              the type of theme on Macs.
            * New values for -moz-appearance: -moz-win-glass and -moz-mac-unified-toolbar.
            * -moz-transform and -moz-transform-origin are now supported for CSS transforms.

            All the properties starting with "-moz" are Mozilla extensions. Detailed information about them can be found 
            at https://developer.mozilla.org/en/CSS_Reference/Mozilla_Extensions

          Newly supported selectors:

            * :nth-child
            * :nth-last-child
            * :nth-of-type
            * :nth-last-of-type
            * :first-of-type
            * :last-of-type
            * :only-of-type
 
          For detailed descriptions of these selectors, see http://www.w3.org/TR/css3-selectors/

        . A new tab-switching shortcut that shows previews of the tab you're switching to

        . Improved control over the Smart Location Bar using special characters to restrict your search

          Smart Location Bar is a new feature in Firefox 3. It provides a quick way to get the site you want.
          It learns as you use it and over time it adapts to your preferences and offers better matches. 

          Special characters are:
            * '^': search only in history
            * '*': search only in bookmarks
            * '@': match only in URL

          e.g. typing "news^" in location bar only searches "news" in history

          For a detailed description, see 
           http://ed.agadak.net/2008/03/using-the-awesomebar and
           http://ed.agadak.net/2008/07/firefox-31-restricts-matches-keywords

        . Support for new web technologies such as HTML5 <video> and <audio> elements.

          Only Vorbis is currently supported for <audio> elements and only Theora is 
          currently supported for <video> elements

 
   4.5. Interfaces: 

   +---------------------------------------+----------------------------------+
   |                             Interfaces Exported                          |
   +------------------------+------------------+------------------------------+
   | Interface Name         |  Classification  |            Comment           |
   +========================+==================+==============================+
   | $HOME/.mozilla/firefox |  Volatile        |  The location of user        |
   |                        |                  |  profiles                    |
   +------------------------+------------------+------------------------------+
   | /usr/lib/firefox       |  Uncommitted     |  Install location            |
   |                        |                  |                              |
   +------------------------+------------------+------------------------------+
   | /usr/bin/firefox       |  Committed       |  Link pointing to the        |
   |                        |                  |  default firefox, normally   |
   |                        |                  |  /usr/lib/firefox/firefox    |
   +------------------------+------------------+------------------------------+
   | Firefox CLI            |  Uncommitted     |  Firefox command line        |
   |                        |                  |  interface                   |
   +------------------------+------------------+------------------------------+
   | Firefox GUI            |  Volatile        |  Firefox graphical user      |
   |                        |                  |  interface                   |
   +------------------------+------------------+------------------------------+
   |<InstallLocation>/plugins| Committed       |  system-wide Firefox plugin  |
   |                        |                  |  directory                   |
   +------------------------+------------------+------------------------------+
   | $HOME/.mozilla/plugins |  Uncommitted     |  user Firefox plugin         |
   |                        |                  |  directory                   |
   +------------------------+------------------+------------------------------+
   | MOZ_PLUGIN_PATH        |  Uncommitted     | environment variable pointing|
   |                        |                  | to additional plugin directory|
   +------------------------+------------------+------------------------------+
   | SUNWfirefox            |  Uncommitted     |  Package name for firefox    |
   |                        |                  |                              |
   +------------------------+------------------+------------------------------+ 
   | SUNWfirefox-devel      |  Uncommitted     |  Package name for firefox    |
   |                        |                  |  developer package           |
   +------------------------+------------------+------------------------------+ 
   | SUNWfirefox-apoc-adapter|  Uncommitted    |  Package name for firefox    |
   |                        |                  |   apoc adapter               |
   +------------------------+------------------+------------------------------+ 
   +---------------------------------------+----------------------------------+
   |                             Interfaces Imported                          |
   +------------------------+------------------+------------------------------+
   | Interface Name         |  Classification  |            Comment           |
   +========================+==================+==============================+
   | NSS/NSPR               |  Committed       |  needs NSS 3.12 and NSPR 4.7 |
   |                        |                  |  uses NSS/NSPR under         |
   |                        |                  |  /usr/lib/mps                |
   |                        |                  |  WSARC/2007/548              |
   +------------------------+------------------+------------------------------+ 
   | SQLite                 |  Volatile        |  needs SQLite 3.X            |
   |                        |                  |  SQLite is being integrated  |
   |                        |                  |  into nevada                 |
   |                        |                  |  PSARC/2008/120              |
   |                        |                  |  SUNWsqlite3                 | 
   +------------------------+------------------+------------------------------+ 
   | Cairo                  |  Volatile        |  needs Cairo 1.6             |
   |                        |                  |  LSARC/2006/202              |
   +------------------------+------------------+------------------------------+ 
   | theora                 |  Volatile        |  needs theora 1.0            |
   |                        |                  |  SUNWlibtheora               |
   |                        |                  |  SUNWlibtheora-devel         |
   +------------------------+------------------+------------------------------+ 


   4.10. Packaging & Delivery 
         The project will be delivering the following packages: 
 
           SUNWfirefox                Firefox Web Browser
           SUNWfirefox-devel          Firefox Web Browser
                                      developer package 
           SUNWfirefox-apoc-adapter   Firefox apoc adapter

   4.11. Security Impact:
         
         None.

   4.12. Dependencies:
         Refer to Imported Interface table.
 
5. Reference Documents:
   Sun Mozilla Project Website - http://jdsbj.prc/wiki/index.php/Browser
   Firefox home page - http://wiki.mozilla.org/Firefox3.1
   Mozilla Foundation Security Advisories - 
        http://www.mozilla.org/security/announce/

   Other Related ARC case
   LSARC/2008/158       Firefox 3 for Solaris Nevada 
   LSARC/2006/694       Firefox 2 for Solaris Nevada and Solaris10 Update
   LSARC/2004/840       Firefox for JDS4
   LSARC/2004/733       Firefox
   LSARC/2006/202       GNOME 2.14 - Vermillion
   WSARC/2007/548       NSPR/NSS/JSS Reclassification 
   WSARC/2002/366       NSS WSARC case
   WSARC/2002/217       NSPR WSARC case
   LSARC/2007/662       FreeType move from /usr/sfw to /usr
   PSARC/2008/120       SQLite