Galeon Frequently asked questions
---------------------------------

The following are items you probably shouldn't e-mail or post in the 
mailing lists about, as they are often repeated.

[Index]

1. I'm trying to compile Galeon and it needs gtkmozembed.h.  Where is it?
2. How can I configure what mail program to use for "mailto:" links?
3. Galeon crashes when I goto page X.
4. When starting Galeon, I get a gtkmozembed assertion failed 'retval == TRUE'
   error.  What does this mean?
5. Why doesn't downloading work?
6. How can I get my scrollwheel mouse to work with Galeon?
7. Why does Galeon depend on GNOME?  There should be a GTK+ only version!   
8. I can't compile Galeon.  I get ld errors such as this:
   (/usr/include/mozilla/nsCOMPtr.h:552: undefined reference to
   `nsCString type_info node').  Help!
9. I compiled Galeon and Mozilla but I still get ld errors.
10. Galeon is using 80MB+ of memory!  What's going on?
11. Galeon segfaults on startup.  What's wrong?
12. Galeon segfaults when opening the preferences dialog.  What's wrong ?
13. Galeon claims that it was killed last time it was run, but it's currently
    running!  Can't i run two copies at once?
14. Galeon hangs when I try accessing my secure banking/intranet site.
    Doesn't Galeon support https?
15. F6 for Find? These keyboard shortcuts are all wrong!
16. I {want, don't want} Galeon to be my default Web Browser { any more }.
17. How can I fix this syntax error during configure?
18. When I run a second Galeon instance it says it crashed and starts
    a separate process, can I fix it?
    


[Q&A]


1. I'm trying to compile Galeon and it needs gtkmozembed.h.  Where is it?

This header is part of Mozilla, and you need to either install the Mozilla
source or find a Mozilla-devel package containing the appropriate headers.
This also applies for nsI*.h.  These steps are described in detail on
the website (http://galeon.sourceforge.net) and in the INSTALL file.


2. How can I configure what mail program to use for "mailto:" links?

We don't have a configuration option for this because Galeon uses the
GNOME URL handler for "mailto:".  Please add/edit a mailto handler
in the GNOME control center for the client of choice.


3. Galeon crashes when I goto page X

Unless you are really sure that it's Galeon's fault, it's likely
Mozilla.  Try updating to a newer version, and if that doesn't work
consider reporting the problem to the Mozilla team.


4. When starting Galeon, I get a gtkmozembed assertion failed 'retval == TRUE'
   error.  What does this mean?

The full error message for this usually looks like this:

** CRITICAL **: file gtkmozembed.cpp: line 298 (void gtk_moz_embed_init
(struct GtkMozEmbed *)): assertion 'retval == TRUE' failed.

If this happens, it usually means there is a problem or incompatibility
with your Mozilla installation.  Try manually exporting/setting your
MOZILLA_FIVE_HOME environment variable and then executing 'galeon-bin'.
This is known to work sometimes, but it's also known to not work for some
users (Debian installations in particular).

Another time when this has been known to happen is when the Mozilla
has been updated/changed with old lingering user files that (for some reason)
are causing problems.  Removing Mozilla user files ("rm -rf ~/.mozilla")
and/or removing galeon's mozilla profile files ("rm -rf ~/.galeon/mozilla/galeon")
may fix this problem.  Be sure to back up any important files in these
directories (such as Mozilla bookmarks, preferences), if necessary.


5. Why doesn't downloading work?

GTM (Gnome Transfer Manager) is used with Galeon for downloading.  Galeon
uses CORBA to request that GTM downloads files, so a working GNOME/CORBA
setup is required.

GTM is available at http://gtm.sourceforge.net


6. How can I get my scrollwheel mouse to work with Galeon?

Galeon supports scrollwheel mice natively.  If your other applications
work fine with the wheel and Galeon does not, it could be because other
programs (such as Imwheel) are interfering.  However, even with Imwheel
the wheel can still be used if the wheel is pushed down while scrolled
(I'm not sure why, and this may only be true for Logitech mice).

If your wheel doesn't work at all for any applications, you probably need
to configure your X server.  For XFree86, this can be done by adding
the line "ZAxisMapping 4 5" to the "Pointer" (mouse) section of XF86Config.

If you still want to use imwheel for the wheelmouse support in other
applications, you can place the following two lines in your ~/.imwheelrc
file to tell imwheel not to interfere with Galeon:

"^Galeon"
@Exclude

Simply place that in your imwheelrc file and restart imwheel.


7. Why does Galeon depend on GNOME?  There should be a GTK+ only version!

First of all, from the very start Galeon has always intended to be a
GNOME web browser.  If you don't use GNOME, then Galeon probably isn't
a very good choice for the time being.

So why lock Galeon into the GNOME environment?  There are many advantages
to using the existing GNOME libraries.  Contrary to what some think,
depending on existing libraries to do typical tasks in modern desktop
applications is NOT bloat.  In fact, it's the exact opposite of bloat.
The bottom line is that implementing our own toolbar, our own configuration
mechanism, our own session management, our own download manager, and our
own dialogs would be counter-productive.

Galeon relies on many standard GNOME libraries (GTK+, libgnome, libglade,
libxml, etc.).  Given these requirements, how much would we gain by removing
the GNOME dependency?  This is not only illogical, but conflicts with
some of Galeon's other goals of integrating nicely with the GNOME desktop.

However, if you absolutely don't want to use GNOME, there is now a project
known as SkipStone which implements a GTK+-only web browser.
See http://www.muhri.net/skipstone/ for more information.


8. I can't compile Galeon.  I get ld errors such as this (/usr/include/mozilla
/nsCOMPtr.h:552: undefined reference to `nsCString type_info node'). Help!

This is due to the fact that you're trying to compile galeon and mozilla with 
a different compiler version.  Download the right mozilla package for your
distribution. (Take a look at http://galeon.sourceforge.net/download.html)


9. I compiled Galeon and Mozilla but I still get ld errors.

Note that both applications must be compiled not only with the same
version of compiler, but also with the same compiler flags.  For
example, with gcc Mozilla by default adds -fno-rtti and -fno-exceptions
or -fno-handle-exceptions (depends on gcc version).  Galeon now adds
-fno-rtti, which should be normally be sufficient. This can be
disabled with the --enable-cpp-rtti flag to ./autogen.sh.

If you need further flag changes, you have two chances to get things
in sync:

1)  Compile Mozilla with this .mozconfig script:
    (You must place it in your home directory) 

# sh
# Build configuration script
#
# See http://www.mozilla.org/build/unix.html for build instructions.
#

# Options for 'configure' (same as command-line options).
ac_add_options --disable-tests
ac_add_options --disable-debug
ac_add_options --enable-strip-libs
ac_add_options --disable-mailnews
ac_add_options --enable-optimize

2)  Configure Mozilla with standard configure script and compile it.  Before
    configuring Galeon set the proper CXXFLAGS. For example, with latest
    version of gcc:

CXXFLAGS='-fno-exceptions'
export CXXFLAGS

For more see configure.in in the Mozilla source.  You can save some space by
disabling RTTI.


10. Galeon is using 80MB+ of memory!  What's going on?

On Linux systems, threads are essentially visible as separate processes
to many user-space applications.  This means that process X, using
10MB of memory with 5 threads sharing that same 10MB will appear to
consume 50MB (though it is not).  Only count one process, not all of
them (this is true for many other applications besides Galeon).


11. Galeon segfaults on startup.  What's wrong?

Make sure the MOZILLA_FIVE_HOME environment variable points to the
directory where the Mozilla executables are installed.  If Mozilla is
compiled from source, try mozilla_build_dir/dist/bin.


12. Galeon segfaults when opening the preferences dialog.  What's wrong?

Run Galeon from an xterm and check if you get this message:

GnomeUI-ERROR **: file gnome-icon-item.c: line 304 (get_default_font):
assertion failed: (default_font != NULL)

If so you need to properly set your language environment.
Example: export LANG=de_DE


13. Galeon claims that it was killed last time it was run, but it's
    currently running! Can't i run two copies at once?

This is caused by the galeon.oafinfo file not being installed in a
place that oaf can look for it.

If you've compiled Galeon from a source tarball, chances are it's
installed it in /usr/local/share/oaf/galeon.oafinfo.  However, oaf
isn't searching this directory, so when you start another copy, oaf
tells Galeon that it isn't running and it doesn't know to attach.

To fix this, make a symlink called /usr/share/oaf/galeon.oafinfo
which links to /usr/local/share/oaf/galeon.oafinfo.  When you start
Galeon twice, it should attach and open a new window/tab in the
existing process.


14. Galeon hangs when I try accessing my secure banking/intranet site?
    Doesn't Galeon support https?

Yes, Galeon does support https (as long as you have the Mozilla PSM
module configured / installed).  But you may have a problem if the site
uses self signed certificates, as Galeon can't currently show the
dialog box to allow you to accept the certificate (it's a problem with
the embedding widget).  Here's a fix: 

(1) Quit Galeon
(2) Delete the file ~/.galeon/mozilla/galeon/cert7.db
(3) Link to the mozilla cert7.db.
    Example: ln -s ~/.mozilla/default/cert7.db ~/.galeon/mozilla/galeon/
(4) Run Mozilla, go to the site you're trying to use, and accept
    the certificate "forever".
(5) Quit Mozilla, and start Galeon again. You should now be able to
    enter and use the site normally.


15. F6 for Find? These keyboard shortcuts are all wrong!

F6 is the standard GNOME shortcut for Find. If you want to rebind it,
Galeon supports the standard GTK+ way of changing shortcuts: simply
hover over the menu option with the mouse pointer and press the
keyboard shortcut you want to rebind it to.


16. I {want, don't want} Galeon to be my default Web Browser { any more }.

When Galeon is first used, it asks you if you want to make it the
default Web Browser in GNOME. This setting is stored in the GNOME
Control Center under Document Handlers / URL Handlers. To stop Galeon
from being the default web browser, delete the association with HTTP,
HTTPS and whichever other protocols you set it up for. The make Galeon
the default Web Browser, add a binding from these protocols to:

		galeon "%s"


17. How can I fix this syntax error during configure?
    ./configure: line 538: syntax error near unexpected token `AM_INIT_AUTOMAKE(galeon,'

Make sure you have xml-i18n-tools installed and try again.


18. When I run a second Galeon instance it says it crashed and starts
    a separate process, can I fix it?

This problem has been observed with out of date versions of Oaf
(including 0.6.1). Upgrade to 0.6.5 (availble from Ximian).
