[%- mypath = "${template.name}"|replace('[^\/]*$','') -%] [%- PROCESS "${mypath}/relnote.var" -%]

# [% rnote.name %]

These release notes describe system requirements, installation instructions, and known issues for [% rnote.name %]. These notes are updated when we receive feedback, so please check back for new information.

## What's New in [% rnote.name %]

[% rnote.name %] contains the following noteworthy changes relative to [% rnote.relativeto.name %]:

- Security fixes
- Fixes for a number of non-security-relevant crashes, increasing the stability of the whole platform and the Mail & Newsgroups part of SeaMonkey
- ChatZilla localization packs work again (Bug 540842)
- FTP file upload was fixed (Bug 467524)
- The internal help content was updated some more

The changes page lists more details on those new features and fixes relative to [% rnote.relativeto.stable.name %].

## Downloading

The SeaMonkey project provides official versions of [% rnote.name %] for Windows, Linux, and Mac OS X in US English and other languages. Community volunteers are also contributing builds for other platforms. You can download [% rnote.name %] here.

## System Requirements, Installation and Uninstallation

Before installing, make sure your computer meets the system requirements. [% rnote.name %] will offer to migrate your data from SeaMonkey 1.x or Mozilla 1.x at the first start after installation. You can find more details about installation, profile data and uninstallation in our install and uninstall document.

## Extensions and Themes

Extensions installed under SeaMonkey 1.x are not migrated to SeaMonkey 2, and may not be compatible for reinstalling in this version due to major changes in our architecture. Please report any issues to the maintainer of the extension. Extensions and Themes for [% rnote.name %] can be installed from the SeaMonkey Add-Ons website or the "Get Add-Ons" section in the Add-Ons manager.

## Known Issues

This list covers some of the known problems with [% rnote.name %]. Please read this before reporting any new bugs.

- Installing [% rnote.name %] into the same location where a 1.x version of SeaMonkey is installed will result in a non-working installation. Either install [% rnote.name %] to a different location - for example the default installation location as given by the installer - or un-install the older version of SeaMonkey first. (Bug 526202)
- Only one profile from SeaMonkey 1.x is migrated to [% rnote.name %] automatically (Bug 383006)
  Workaround: Manually start migration as described in the knowledge base.
- MailNews account password prompts are no longer serial at startup (Bug 338549)
  Workaround: If a Master Password is set and you saved your login credentials, only one prompt will appear at startup. You can disable this new behavior by setting `signon.startup.prompt` to false in `about:config`.
- If you have newsgroups that keep messages forever, SeaMonkey can use a lot of CPU and freeze temporarily in some situations (Bug 539194)
  Workaround: Go into the "Synchronization & Storage" panel of your news account settings and set it to delete older message by some criteria.
- Profile Roaming is not working any more (Bug 378647)
  Workaround: Try the Weave Sync add-on from Mozilla Labs.
- "Turbo mode" (quick launch), including the tray icon, has been removed (Bug 361682)
  Workaround: Try the MinimizeToTray Plus add-on that replaces some of this functionality.
- Form manager has been replaced with a new web form remembering functionality that works very much differently (Bug 304309)
  Tips: For improving form management experience and getting some of the previous control back, please try the Form History Control, Autofill Forms, and/or FireForm add-ons made available by our community.
- Splash screen support (was shown by default on Windows) has been removed due to not being implemented in the new toolkit (Bug 329742)
- Download manager sometimes uses high amounts of CPU time with multiple downloads active or in the list (Bug 506731)

## Troubleshooting

- Some anti-virus software keeps detecting our installers as containing a "Trojan" or "Downloader". This is a false positive and is some wrong detection mechanism in the anti-virus software. The code in question is actually from 7-Zip and decompresses the installer so that its contents can run and install SeaMonkey. That technology is widely used and probably can be used to compress bad as well as good software, but the 7-Zip code itself is perfectly safe. Mozilla scans all our files routinely when putting them on the FTP server and we assure you that our installers are as clean as the official Firefox downloads that are scanned by the same mechanisms.
- Poorly designed or incompatible extensions can cause problems with SeaMonkey, including make it crash, slow down page display, etc. If you encounter strange problems relating to parts of SeaMonkey no longer working, the browser not starting, windows with strange or distorted appearance, degraded performance, etc, you may be suffering from Extension or Theme trouble. Restart SeaMonkey in Safe Mode. On Windows, start using the "Safe Mode" shortcut created in your Start menu or by running `seamonkey.exe -safe-mode`. On Linux, start with `./seamonkey -safe-mode` and on Mac OS X, run:

  `cd /Applications/SeaMonkey.app/Contents/MacOS/
  ./seamonkey-bin -safe-mode`

  When started in Safe Mode all extensions are disabled and the Default theme is used. Disable the Extension/Theme that is causing trouble and then start normally.
- 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 SeaMonkey 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 SeaMonkey 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

What can I do to help?
  We need help from developers and the testing community to provide as much feedback as possible to make SeaMonkey even better. Please read these notes and the bug filing instructions before reporting any bugs to Bugzilla. You can also give us your feedback through this feedback form.
Why haven't you responded to the mail I sent you?
  Use the newsgroup. The SeaMonkey team reads it regularly, and your email may have gotten lost.
Where can I get extensions and themes (add-ons)?
  Extensions and Themes can be downloaded from SeaMonkey Add-ons.
Who makes SeaMonkey?
  Lots of people. See Help->About SeaMonkey, contributors for a list of some of the people who have contributed to Mozilla and SeaMonkey.
Where's the [% rnote.name %] source code?
  A tarball of the [% rnote.name %] source code is available at the download page. The latest development code can be obtained from the source repository. SeaMonkey-specific source is in the "suite" directory. Please follow the build instructions.

## Other Resources and Links

The following resources contain useful information about [% rnote.name %]:

- SeaMonkey Documentation & Help
- MozillaZine Knowledge Base
- "New for 2.0" wiki page
- For extension developers