Iceape for Debian
=================

Please read the file /usr/share/bug/iceape/presubj for information
you may want to know if you will report a bug.

Why is it not called SeaMonkey ?
--------------------------------

Due to our inability to use the Firefox logo because of a non-free
copyright, the Mozilla Corporation insisted that we not use the
trademarked name Firefox either. Most of the details are documented in
#354622 <http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=354622>.

SeaMonkey follows the same trademark policy as Firefox, which is why,
not unlike Firefox, it was renamed.

Even though it is not called SeaMonkey, it still comes from exactly the
same upstream, and is by and large exactly the same (the differences
some distribution specific customizations, rebranding and the
occasional bug fix).

Application Update
------------------

From version 1.0.7 onwards, the automatic application update has been
disabled. From version 2.0 onwards, it is disabled through the
app.update.enabled preference, locked to 'false' in
/usr/lib/iceape/defaults/pref/vendor.js.

Packaged Extensions
-------------------

With older versions of Iceape, an update-iceape-chrome script was
provided so that extensions are correctly enabled in Iceape. This has been
obsoleted by the new Extensions Manager, and the update-iceape-chrome
script removed. Packages that are still using this script without checking
for its existence are very much likely to fail in the new Iceape chrome
anyways. Please report a bug to any such package.

Sound
-----

By default, iceape detects and runs the correct dsp wrapper for esd,
arts, or alsa. If this is not the desired behaviour, edit
/etc/iceape/iceaperc or ~/.mozilla/iceaperc and set the ICEAPE_DSP
variable to:

"auto": The default, auto-detection.

"esddsp": Use esd.

"artsdsp": Use arts.

"aoss": Use alsa.

"none": Don't use any sound wrapper.

using Java. (You should use plugin which compiled with gcc-3.2 or newer)
----------

You can install one of the following packages: 
 - gcjwebplugin,
 - java-gcj-compat-plugin,
 - sun-java5-plugin.

Alternatively, you can grab a binary Java distribution from
http://java.sun.com/, install the java-package package and do a make-jpkg
on the file.

Buttons
-------

Some people have complained that the button order in dialogs is
non-intuitive (ie, they don't like it). To reverse the order, add the
following to your chrome/userChrome.css file, under the
~/.mozilla/ directory:

.dialog-button-box { -moz-box-direction: reverse; -moz-box-pack: right; }
.dialog-button-box spacer { display: none ! important; }

Emacs keybindings
-----------------

To enable Emacs keybindings in GTK, follow the instructions at
http://kb.mozillazine.org/Emacs_Keybindings_(Firefox).

Pango
-----

From version 2.0-1, pango is the only font backend upstream.
MOZ_DISABLE_PANGO now has no effect.

Well Known Ports
----------------

To prevent Iceape from being used to launch attacks against other
protocols, certain ports cannot be connected to by default. See
http://www.mozilla.org/projects/netlib/PortBanning.html for further
information. To allow the port numbers being used, enter
"about:config" in the URL bar and edit the
"network.security.ports.banned.override" entry to list the ports you
wish to allow (eg "2049,4045,6000").

 -- Mike Hommey <glandium@debian.org>  Sat, 7 Nov 2009 08:40:02 +0100
