--------------------------
 INSTALL (MozCache 1.0.4)
--------------------------

MozCache is distributed under GNU-GPL 2 or later.

Note: Mozilla means also Firefox, SeaMonkey and
      Netscape 6.1 (or higher version) browsers.

To compile MozCache properly, you will need an ANSI-C compiler
and the following additional libraries:

 * Required: either GTK+-1.2 or GTK+-2.x installed

 * Optional: the libintl library (or libc with gettext support) for 
   internationalization of the MozCache messages

 * Optional: one of the regexp implemantation POSIX/BSD/GNU/SYS V8/PCRE
   in your libc library or in a separate package

 * Optional: Cygwin for MS Internet Explorer support

If you do not know whether you have this or not and you like the
easy way, just do the following steps - configure will inform you
if a problem occurs:

./configure
make
su
make install-strip
exit

Now you can get a help message with 'mozcache -h', to run MozCache
with X11, type 'mozcache &'.
If your browser is running while launching MozCache, it is possible
that the database cannot be readed. Then you should close your browser
and try open the database again.

If you like an icon displayed in your window manager other than gnome,
you have to copy it to the right location at your own -
'cp mozcache.xpm destination'.

It is possible to install only the translated messages you will need.
To do so, you need the environment variable 'LINGUAS'.
Before starting the configure script, you can specify your languages,
e.g. export LINGUAS="de fr it". This will install only messages in
german, french and italian. Have a look into the folder 'po' to make
sure your languages are existing.
If 'LINGUAS' is not defined, or it is empty, all translations will be
installed.

You can also run configure with some options:

 * --disable-berkeley-db
     If you do not want support for Netscape 4.x and Netscape 6.0
     browser. You will only be able to view Mozilla cache contents.

 * --disable-glob
     If you only have one database and no need for the filename
     completition, you can disable it.

 * --disable-gnome
     MozCache contains configuration files for the GNOME panel menu.
     These files are only installed when the configure script finds
     the location of your GNOME installation. If you do not want to
     install these files, use this option.

 * --disable-msie
     If you do not want support for the MS Internet Explorer browser.
     It is always disabled if you are not running Cygwin.

 * --disable-nls
     If you do not want internationalization of the MozCache messages.
     With this option all messages are only displayed in english.

 * --disable-swap-columns
     You can reorder the columns, e.g. you may put the local file
     column most right. If you do not need this, use this option.

 * --disable-tree-model
     If MozCache was compiled with GTK+-2.x, the tree model used here
     is not working well on slow computers. You can speed up things
     by disabling this and using instead the older GTK+-1.2 model.

 * --enable-focus-bugfix
     For GTK+-2.0 only. I think you can configure and compile without
     this workaround, but if you've got problems, read the BUGS file.

 * --enable-gtk-1v2
     Without this option the configure script will first look for
     GTK+-2.0, and if not found, for GTK+-1.2. If you have both libraries
     installed, and you want compile MozCache with GTK+-1.2, you can force
     it using this option.

 * --enable-pdp-endian
     Additional to Big- and Little-Endian this option allows reading data
     bases written in PDP-Endian. However, it seems neither Mozilla nor
     GLib are supporting this byteorder, and, since I haven't got databases
     stored in this format (which means that this feature isn't well tested),
     you should leave this disabled.

 * --enable-readonly
     With this option you will not be able to remove files from the
     database! Launching MozCache with 'mozcache -r &' will do the same,
     but you can change this at next start. When compiling MozCache with
     this option, the readonly modus is permanent.

 * --with-nlsdir=PATH
     You can specify a location for the translated messages. Without this
     option this will be usually '/usr/local/share/locale'.

 * --with-regex=[none/auto/posix/gnu/v8/bsd/pcre]
     With the MozCache find dialog you can search for something in the
     stored cache files. Select the type of regular expressions you like
     to use there (you must have the proper library). You can say 'none'
     here, if you do not want regular expressions, 'auto' is the default.

/* EOF */
