2.1. Source Archive

The source archive has dependencies on the following:

• GTK+

• libcurl. You are advised to use libcurl 7.9.5 or later.

• libpopt

To build and install the source distribution, unpack the archive to a suitable location, then:

    ./configure
    make
    make install (as root)
    

2.2. Binary Installation

4.1. Getting Started

OOodi is invoked by the command OOodi (note capitalisation is significant). When invoked by a unprivileged user, it can install and remove dictionaries from that user's private directory. If the user has write access to the system-wide shared dictionary area (for OpenOffice.org v1.0.1), then the user may install or remove system wide shared dictionaries. The root user may invoke OOodi with an additional option to allow installation and removal of shared dictionaries even if the root user does not have a personal OpenOffice.org installation (see here for further details). If the root invokes the program without the option, the a file selector is displayed to locate the installation directory.

    
    $ OOodi [--base=directory]
   

The --base=dir option is only available to the root user and defines where OpenOffice.org installation directory for (see shared dictionaries).

Normally, OOodi is invoked as:

    $ OOodi
   

If a file defining the available dictionaries is available in the source directory defined by your preferences (or the current directory if you haven't defined a source directory), then the opening window is displayed, listing the available dictionaries and the user (U) and shared (S) dictionaries installed (indicated by a green tick). The final column in the list annotates the type of dictionary, either Dict for a spelling dictionary, or Hyph for a hyphenation dictionary. Hyphenation dictionaries are also colour-coded with a different background colour. Hyphenation dictionaries are only included if the Include hyphenation dictionaries preference is set. An asterisk after the type indicates that a more recent dictionary is available for download. The check is accessed from the Tools->Update Dictionary List menu option.

If a local available.lst file is not found, then the user is presented with a number of options:

If the Include hyphenation dictionaries preference is set, but the hyphavail.lst file is not found, then a similar dialogue is displayed. In this case it is possible to continue without using hyphenation dictionaries. The file selector will require hyphavail.lst.

4.2. Preferences

Preferences are accessed either from the startup options, the Settings->Preferences menu or from a right mouse button popup menu.

4.3. Installing and Removing Dictionaries

Once the list of available dictionaries is displayed, dictionaries may be selected for installation or removal. Once items have been selected, the Install and Remove buttons are available if you have a local OOodi installation. If you are running OpenOffice.org v1.01 or later and have write access to the shared dictionary directory, then the Install Shared and Remove Shared buttons are also enabled.

Dictionaries may be installed or deleted by pressing the appropriate button. If necessary, the dictionary file will be downloaded from the Internet. In this case, the file name and progress will be shown in the status bar, and the Cancel D/L button is enabled. The screenshot illustrates the root user installing a shared dictionary.

if you cancel a download or errors occur, a dialogue will be displayed.

4.4. Shared Dictionaries

Shared dictionaries may be installed either by:

• A user with a current OpenOffice.org installation in their home directory and write access to the shared dictionary area. A symbolic link from the user area is followed to determine the shared dictionary area.

• The root user. As root is unlikely to have a local OpenOffice.org installation, a file requester is displayed enabling root to define the base of the OpenOffice.org installation (as the --base=dir command line option).

4.5. Menu Options

A number of options are available only from the menus.

4.6. Diagnostics

When Install is clicked, the program (attempts to) download the selected dictionaries from 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 valid zip file, then the file is preserved as xx_XX.zip.failed. This may contain a HTTP or proxy error message. Likewise, if the program repeated fails to download a valid list of available dictionaries, then the available.lst file may contain a HTTP or proxy error message.