Beta 0.XX for OOodi OpenOffice.org Dictionary Installer
-------------------------------------------------------

Inspired by the Windows Dictionary Installer by Lee Corbin and the
perl/TK dictinstall by Kevin Hendricks.

To Install
----------

From source:
~~~~~~~~~~~~

Download (and possibly build) libcurl if you don't have it.
Download (and possibly build) libpopt if you don't have it.

	 ./configure
	 make
	 make install (as root)

Precompiled Binary:
~~~~~~~~~~~~~~~~~~~

The precompiled binary is available in a number of formats:

    * epm 'portable' tar file
    * RPM
    * DEB

The precompiled binary is available in two flavours:

    * ooodi	       : depends on X11, GTK+, popt
    * ooodi-static     : no dependencies 

    If GTK+ is installed on your system, then you should choose
    'ooodi' which is built against a static libcurl.

    If GTK+ is _not installed_ on your system, then you should choose
    'ooodi-static'.

The reason for this is that a version linked statically against GTK+
may not work correctly when your GTK+ theme uses a dynamic library GTK
theme engine.

Installing a binary OOodi
~~~~~~~~~~~~~~~~~~~~~~~~~

epm (Easy Package Manager, <URL:http://www.easysw.com/epm/>) is
used to create all binary distribution formats. To install the
'portable' distribution:

 * Unpack the archive in a scratch directory (/tmp for example).

   e.g. tar -xzvf ooodi-0.53-i386-linux.tar.gz -C /tmp/

 * As root, run the script '/tmp/ooodi.install' (or
   '/tmp/ooodi-static.install' for the static variant).

   # /tmp/ooodi.install
   or
   # /tmp/ooodi-static.install

 * To bypass the 'are you sure/do you accept this licence' questions,
   use 

   # /tmp/ooodi.install now
   or
   # /tmp/ooodi-static.install now

 * A script to remove the software is also installed.
   (/etc/software/ooodi.remove or /etc/software/ooodi-static.remove)

Dependencies
------------

GTK+
libcurl
libpopt

GTK+ 1.2.10 and libcurl 7.9.8 were used for development. Other
versions may also work. libcurl may be found at
<URL:http://curl.haxx.se/>. Due to some confusion over the parameters
for the download callback function, it is recommended that you use
7.9.5 or later.

There is a run time requirement for the InfoZip unzip program
<URL:http://www.info-zip.org/pub/infozip/>.

Configuration
-------------

The first time it runs, OOodi creates a directory ~/.ooodi. It writes
a gtkrc file in this directory, which defines the fonts and sizes used
for some labels.

A file ooodi.rc is also used. This file is maintained by the
'Properties' page. It allows the use of an HTTP proxy, if required.

Operation
---------

Invoke as

 OOodi

The program looks for a file "available.lst", defining available OOo
dictionaries in the current directory. If this file does not exist, it
attempts to download one from <URL:http://dict.progbits.com>. The
first time the program is run, there may be a short delay while this
file is downloaded. This file is used to populate the list displayed
to the user.

The program reads ~/.sversionrc and uses the last "OpenOffice.org "
entry for the path to the OpenOffice.org installation. The
"user/wordbook/dictionary.lst" is read for installed dictionaries,
(which are indicated with a tick in the list).

The user may select dictionaries from the list. 

When "Install" is clicked, the program (attempts to) download the
selected dictionaries from <URL:http://dict.progbits.com>. The
download is checked for a ZIP signature.  If the file is a zip file,
then the .dic and .aff files are installed under "user/wordbook" and
"dictionary.lst" is updated. If the file is not a zip file (e.g. the
HTTP 404 error when you attempt to get 'de_CH.zip' [at 2002/05/04, now
fixed]), then the file is preserved as "xx_XX.zip.failed". This may
contain a HTTP or proxy error message.

If "Remove" is clicked, the selected dictionaries are removed from the
OpenOffice.org dictionary list, however the dictionary files (*.dic,
*.aff) are not deleted. An option to perform the deletion will be
offered in a later version.

A right mouse button popup menu offers "Properties", "About" and
"Quit".

Properties
----------

From the right mouse button menu, inter-alia:

Proxy:
~~~~~

The name of an (optional) proxy, in the form http://host:port (e.g.
http://proxy.daria.co.uk:8080).

URI:
~~~

The location of the host providing the dictionary list and
archives. You are advised to leave this as http://dict.progbits.com.

Status
------

This is a beta release (but it's quite stable). 

Thanks to
---------

Marco Huggenberger, Takeshi Aihana, Michalis Kabrianis and Andrea Sanavia
for de_DE, ja_JP, el_GR and it_IT translations. The omissions and errors are
mine.

Mark Finlay <sisob@eircom.net> who maintains 'Evolved OpenOffice'
<URL:http://evolvedoo.dyndns.org/> has been responsible for many
improvements to the user interface for 0.53.

Bugs/Omissions
--------------

The program cannot distinguish between two different dictionaries
where the locale code is the same (el_GR and el_GR_enhanced and it_IT
and it_IT_latin). Fixing this would be quite ugly.

Author/Licence
--------------

(c) Jonathan Hudson <jonathan@daria.co.uk> 2002. This software is
    released under the LGPL (please see the file COPYING for further
    information).

Bug reports, translations and change requests are welcomed.

v0.1  2002/05/04 - Initial release
v0.2  2002/05/05 - Added REMOVE and Properties
v0.3  2002/05/19 - 'Stranded at Narita'. Prevent segfault with no
		   available.lst. Thanks to the UK AirTraffic Control
		   system for delaying the London flight sufficiently
		   long to get this done :-).
v0.4  2002/05/19 - Added Japanese translation from Takeshi Aihana
		   <aihana@jcom.home.ne.jp>. 'Arigato gozaimasu'. 
v0.41 2002/05/20 - Added Greek translation from Michalis Kabrianis
		   <mk@interzone.gr>
0.42  2002/05/23   Fix setting URL via preferences bug (reported by
		   Michalis Kabrianis)
0.50  2002/06/03   Added 'front screen' when on available.lst
      		   Italian translation by Andrea Sanavia <a.sanavia@tin.it>
		   Experimental support for v1.0.1 shared
		   dictionaries.
0.52  2002/06/09   'Rainy season', added support for hyphenation
		   dictionaries, repair, check status, local
		   installation, keep etc.
0.53  2002/06/16   'Memories of summers past'. Added Mark Finlay's UI 
		   suggestions.	 As a result, fixed a number of bugs
		   as well :-). Added .deb, .rpm and epm
		   distributions.
0.54  2002/08/05   'Ellan Vannin'. What else can one do on a 3 hour
		   ferry journey ? If the Austrian dictionary ever
		   makes it it to progbits, and the available.lst is
		   done the way I'd have done it, then this OOodi will
		   install it. Also includes a French translation by 
		   Andre Mazouer <andre.mazouer@freesurf.ch>. Merci
		   beaucoup.
0.55 2002/08/12	   'Perseids'. Fixes a bug that prevented a local
		   hyphenation dictionary being loaded the first time
		   the program was run. Reported by Thomas Huemmler
		   <thomas@hogwarts.huemmler.de>.

