What is it?
-----------

Mozilla-bonobo is a browser plugin. It "bridges" the browser to bonobo, the
GNOME component technology. It tries to support the Netscape 4 plugin API,
and it should work on many different browsers.

In short: this plugin makes your browser use bonobo controls to display
supported file types inside the browser window or frame.

*** This is alpha-quality software *** Use at your own risk ***

See the "Known Bugs" section below for trouble you might run into.

Browser compatibility
---------------------

- Mozilla 1.3 (and other mozilla-based browsers):
  resizing is slightly broken - see mozilla bug #201158

- Netscape 4.8: 
  Currently not working

- Konqueror 3.1.1:
  resizing severely broken

- Opera 6.12 & 7.1 beta 1:
  does not work at all - StreamAsFile is never called I think.

Configurability
---------------

If you want the plugin to not support some mime type, you can
add that mime type to the list contained in the GConf key
/apps/mozilla-bonobo/mime-types/ignore. Items in this list may
contain the wildcards "*" and "?", so if you don't want any
video files to be handled, add "video/*", for example.

To get mozilla to respect your new GConf settings, you need
to get it to flush its mime type cache. The easiest way to
achieve this is to delete your $HOME/.mozilla/pluginreg.dat
and to restart mozilla.

There's currently no easy way for this to happen automatically,
because mozilla caches these mime types very aggressively.
Please see (and vote for!) mozilla bug #125469.

Building
--------

You need development packages for some GNOME libraries that are used
(bonobo, bonoboui, gnome-vfs and so on) and for mozilla.

You need to give one mandatory parameter to "configure":
--with-plugin-install-dir=/path/to/mozilla/plugin/directory

Known Bugs
----------

- Resizing is broken on mozilla. See mozilla bug #201158.

- Many many more...
