Some of the changes in Gecko 1.9 Alpha 1 will affect the web and platform compatibiltity of Gran Paradiso Alpha 1:

• Windows 95, Windows 98 and Windows ME are no longer supported platforms
• OS X 10.2 is no longer supported, and OS X 10.3.9 or better is recommended
• Moving DOM nodes between documents now requires a call to importNode or adoptNode as per the DOM specification.

Downloading and Installing

System Requirements

Before installing, make sure your computer meets the system requirements.

Downloading Gran Paradiso Alpha 1

Mozilla.org provides Gran Paradiso for Windows, Linux, and Mac OS X in a variety of languages. To get the latest version of Gran Paradiso, browse the FTP site. For builds for other systems and languages not provided by mozilla.org, see the Contributed Builds section at the end of this document.

Installing Gran Paradiso

Once you have downloaded Gran Paradiso, follow these instructions to install:

Windows

Double click the Gran Paradiso Setup Alpha 1.exe installer to start the install.

Mac OS X

Double click the Gran Paradiso Alpha 1.dmg Disk Image to uncompress and mount it. Your browser may have already done this for you. Double click the GranParadiso Disk Image to open it in Finder and drag the Gran Paradiso application onto your hard disk. Do not double click the icon in the disk image! Be sure to drag the Gran Paradiso application out of the disk image and onto your Hard Disk before running it. Drag the icon to your Dock if you want it to appear there.

Linux/GTK2

Extract the tarball and run ./firefox:

tar -xzvf granparadiso-alpha1.tar.gz
cd firefox
./firefox

Other Platforms

Extract the compressed archive and run firefox

Uninstalling Gran Paradiso

To uninstall Gran Paradiso, follow these instructions:

Windows

From the Start menu, choose Control Panel. When the Control Panel appears, double click Add/Remove Programs. Find "Gran Paradiso (3.0a1)" in the list and click Remove to uninstall.

Mac OS X

Drag the GranParadiso application to the Trash.

Others

Remove the firefox folder.

These instructions leave your profile in place in case you install Firefox again in the future. If you wish to remove your profile folder, remove the location described below in the "Profile Folder" section. Note that by doing this you are destroying all of your downloaded Extensions and Themes, Bookmarks, saved passwords, settings and other information and should you decide to use Firefox again you will be starting with a clean profile.

Other Information

Profile Folder

Gran Paradiso stores your user data in one of the following locations:

Windows 2000, XP	Documents and Settings\<UserName>\Application Data\Mozilla\Firefox
Windows NT	WINNT\Profiles\<UserName>\Application Data\Mozilla\Firefox
Windows 98, ME	Windows\Application Data\Mozilla\Firefox
Mac OS X	~/Library/Application Support/Firefox
Linux and Unix systems	~/.mozilla/firefox

Add-ons

Add-ons installed under previous versions of Firefox may be incompatible and/or require updates to work with Gran Paradiso. Please report any issues to the maintainer of the extension. When you install Gran Paradiso, and all of your Add-ons will be disabled until Gran Paradiso determines that either a) they are compatible with the Gran Paradiso release or b) there are newer versions available that are compatible.

Known Issues

This list covers some of the known problems with Gran Paradiso Alpha 1. Please read this before reporting any new bugs, and watch for updates as new bugs are discovered.

All Systems

Windows

• Upscaling images can result in misrendering, causing the edges of the image to appear blurry.

Mac OS X

• The user's choice of a default font may not always be honored.
• Font decorations such as underline and strikethrough may be drawn incorrectly.
• Complex scripts may be misrendered.

Linux and Unix systems

• Loading any page with Chinese, Japanese or Korean text can hang the browser (see bug 357637).
• Performance on complex scripts may be slower than previous versions of Gecko.
• Compatibility issues have been reported when users are not running Xorg 7.0 or better.
• Users may experience problems when attempting to print complex pages.

Web Page Rendering

• The Cairo graphics system has drastically changed the way all text and images are rendered from previous versions of Gecko, so occasional misrenderings of non-latin scripts and fonts may occur.

Troubleshooting

• Poorly designed or incompatible Add-ons can cause problems with your browser, including make it crash, slow down page display, etc. If you encounter strange problems relating to parts of the browser no longer working, the browser not starting, windows with strange or distorted appearance, degraded performance, etc, you may be suffering from trouble with your Add-ons. Restart the browser in Safe Mode. On Windows, start using the "Safe Mode" shortcut created in your Start menu or by running firefox.exe -safe-mode. On Linux, start with ./firefox -safe-mode and on Mac OS X, run:

  cd /Applications/BonEcho.app/Contents/MacOS/
./firefox-bin -safe-mode

  When running in Safe Mode, you can disable the add-ons that are causing trouble and then restart to try again.

If you uninstall an extension that is installed with your user profile (i.e. you installed it from a web page) and then wish to install it for all user profiles using the -install-global-extension command line flag, you must restart the browser once to cleanse the profile extensions datasource of traces of that extension before installing with the switch. If you do not do this you may end up with a jammed entry in the Extensions list and will be unable to install the extension globally.

If you encounter strange problems relating to bookmarks, downloads, window placement, toolbars, history, or other settings, it is recommended that you try creating a new profile and attempting to reproduce the problem before filing bugs. Create a new profile by running Firefox with the -P command line argument, choose the "Manage Profiles" button and then choose "Create Profile...". Migrate your settings files (Bookmarks, Saved Passwords, etc) over one by one, checking each time to see if the problems resurface. If you do find a particular profile data file is causing a problem, file a bug and attach the file.

Frequently Asked Questions

1. What can I do to help?

   We need help from developers and the testing community to provide as much feedback as possible to make Firefox even better. Visit this Gran Paradiso page to learn more.

2. Why haven't you responded to the mail I sent you?

   Use the forums. The Gran Paradiso team reads them regularly. We all get a lot of email and your email may get lost.

3. Where can I get add-ons?

   Extensions and themes can be downloaded from Mozilla Add-ons.

4. Who is working on Gran Paradiso?

   Lots of people. See Help->About Mozilla Gran Paradiso, Credits for a list of some of the people who have contributed to Gran Paradiso.

5. Where's the Gran Paradiso source code?

   A tarball of the Gran Paradiso source code is available for download. The latest development code can be obtained by cvs. Firefox-specific source is in "mozilla/browser", "mozilla/toolkit", and "mozilla/chrome". Please follow the build instructions.

6. Where is the mail client?

   Gran Paradiso works with whatever mail client is the default on your system. However, we recommend Mozilla Thunderbird, our next generation email client and the perfect complement to Firefox.

Other Resources and Links

The following resources contain useful information about Gran Paradiso Alpha 1:

• MozillaZine's Knowledge Base
• Developer Information

Contributed Builds

These are unofficial builds and may be configured differently than the official Mozilla.org builds. They may also be optimized and/or tested for specific platforms.

Other Systems

Builds for platforms other than the trio officially offered by Mozilla.org can be found on the FTP site.

Localized Builds

Many localized builds are now produced and distributed by Mozilla.org on behalf of their authors.

Builds that have not yet been certified as official Gran Paradiso Alpha 1 localizations are available by browsing the FTP site.