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 as:

    * epm 'portable' tar file

Thrid (fans of the 'Burkiss Way' will know this is not a typo)
parties make supply:

    * RPM
    * DEB

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'

   # /tmp/ooodi.install

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

   # /tmp/ooodi.install now

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

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

GTK2+
libcurl
libpopt

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://ftp.services.openoffice.org/pub/OpenOffice.org/contrib/dictionaries

Status
------

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

Thanks to
---------

Bug reports, translations and change requests are welcomed. I am
grateful to Marco Huggenberger (de_DE), Takeshi Aihana (ja_JP),
Michalis Kabrianis (el_GR), Andrea Sanavia (it_IT), Andre Mazouer
(fr_FR) and Tamas Gervai (hu_HU) for their translations. Any errors
and omissions are entirely mine as OOodi has been something of a
moving target.

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,2003. 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>.
		   Note: Also made the GTK-2 source release

0.55.1 2002/11/16  'Leaky Gutter' (fixed). Also fixed the configure.in
		   to check for popt.h. Reported by Jos van den Oever
		   <jos@vandenoever.info>. No new binaries for a
		   trivial configure fix.

0.60   2003/03/15  'Traviata' (at the Met). GTK-2 port. No new GTK-1
		   versions will be made.

0.61   2003/05/16  'Sparsholts Open Day'. Daria's gone to worship at
		   the feet of the "Gardener's Question Time"
		   team. I'm staying at home and releasing a fixed
		   OOodi that may not crash at the feet of
		   non-existant 'available.lst' files. 

0.62  2003/07/20   'King Priam'. I'm determined to listen to every
		   Prom this year, even this. Also fixed the 'no help'
		   bug, and the binary installer.

0.63  2003/09/01   "Gusty North-easterly", but quite a nice sail
		   anyway. Fixed the download URL, and date checking
		   on files. Thanks to Tamas Gervai <crown@tolna.net>
		   for the bug reports and the Hungarian translation.

0.64 2003/10/14	   "Do geese see god" [0]. Use UTF-8 for the
		   dictionary list, so the new internationalisted
		   lists work. Set maxiumum dictionaries limit to 1024
		   (was 64), so it doesn't core dump in the immediate
		   future. Added the Spanish translation from Pedro
		   A. Gracia Fajardo <pedro@neuroomante.com>. Thanks.
		   Failed to change the file names to lower case to
		   achieve standards compliance ... need something for
		   the next release.

		   [0] with compliments to Iris Murdoch.

0.65 2003/10/18	   "Travelling light". Clean up i18n fixes, install with
		   link to ooodi, clean up the jade upgrade related
		   ugliness in the manual.
