$OpenBSD: README,v 1.2 2011/06/02 13:41:41 ajacoutot Exp $

+-----------------------------------------------------------------------
| Running firefox36-3.6.28p1 on OpenBSD
+-----------------------------------------------------------------------

If you encounter strange problems relating to bookmarks, downloads,
window placement, toolbars, history, or other settings, it is
recommended that you create a new profile and attempt to
reproduce the problem before filing bugs.  To create a new profile,
start Firefox with the -ProfileManager switch, e.g.
firefox -ProfileManager, and click "Create Profile".

If Firefox doesn't start at all, try starting it with -safe-mode
switch, which disables extensions and themes for your session.

To disable anti-aliasing (xft) set GDK_USE_XFT=0 in the environment.

Using mailto: links

To enable mailto: links in Firefox to open in your mail program,
you may have to set a mailto protocol handler. Type "about:config"
in Firefox's URL text field.  Type "mailto" in the filter.  If there
is a string called "network.protocol-handler.app.mailto", its value
names the application for mailto URLs. If present, right click,
choose Modify, and enter the path to your mail program, e.g.,
"/usr/local/bin/thunderbird" or "/usr/local/bin/kmail" (other
programs may work, but these two have been tested).  If absent,
right click, choose New String. Set the name to
"network.protocol-handler.app.mailto" and the value to the path to
your mailer.

Plugins

Firefox looks for plugins in ~/.mozilla/plugins,
/usr/local/lib/mozilla/plugins, and /usr/local/mozilla-firefox/plugins.
If the environment variable MOZ_PLUGIN_PATH is specified, this
location will be overridden.

Using Java Applets

To make Applets work, you must symlink (not copy) the file
libjavaplugin_oji.so into one of the directories listed above.
This might be done like the following:

$ cd ~/.mozilla/plugins
$ ln -s /usr/local/jdk-1.5.0/jre/plugin/i386/ns7/libjavaplugin_oji.so .
$   

Information on building Java (on some platforms) can be found in
http://www.openbsd.org/faq/faq13.html#javaflash

Enabling ECC cipher suites

Open the URL about:config and type security.ssl3 in the search
filter. This will bring up a list of all available cipher suites.
Double-click on any cipher to toggle its state. For example, to
enable TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA, double-click on
security.ssl3.ecdhe_ecdsa_aes128_sha until its boolean entry in the
Value column changes to true.

Using CUPS and LPR for printing

Since version 3, Firefox uses the standard printing dialog from gtk+2.
In order to use CUPS for printing, you will need to install the cups
subpackage of gtk+2, i.e.:

# pkg_add gtk+2-cups

Debugging

If you encounter crashes, you might want to build the debug FLAVOR of
this package, and run 'firefox -g' to run firefox inside gdb, so
that you can gather debugging logs and traces.
Bug reports without that information will be ignored.
