-------------------------
 INSTALL (MozCache 1.1.1
-------------------------

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/PCRE/GNU/SYS V8/BSD
   in your libc library or in a separate package

 * Optional: zlib version 1.2.3 for decoding files

 * Optional: libiconv (GTK+-1.2 only)

 * Optional: libunicode version 0.4 (GTK+-1.2 only)

 * 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-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-nls
     If you do not want internationalization of the MozCache messages.
     With this option all messages are only displayed in english.

 * --disable-xsetlocale
     For GTK+-1.2 only. If compiling or displaying lines in the search
     dialog do not work, try this option.

 * --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-msie
     If you do not want support for the MS Internet Explorer browser.
     It is always disabled if you are not running Cygwin.

 * --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.

 * --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.

 * --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-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-pango-locale
     For GTK+-2.0 only. If searching, some lines may contain characters
     which cannot display by Pango. MozCache will be terminated then.
     If this happens, you should configure with this option and compile
     again.

 * --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.

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

 * --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.

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

 * --with-regex=[auto/posix/pcre/gnu/v8/bsd]
     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 type 'no'
     here, if you do not want regular expressions, 'auto' is the default.

 * --without-regex
     If you do not want regular expressions, type this.

 * --with-unicode=[gnome/PFX]
     For GTK+-1.2 only. Include the unicode lib version 0.4 from the gnome
     package. if you type 'gnome', the install directory of Gnome, else
     the install directory 'PFX' will be used. 'PFX' may be '/usr/local'
     or any other path, wich contains the 'lib' and 'include' folders.
     Without this option, first it will be searched in '/usr', then 'gnome'

 * --without-unicode
     For GTK+-1.2 only. No unicode support.

/* EOF */
