.. -*- coding: utf-8 -*-
.. include:: header.rst

=================================
 Installing gadict dictionaries.
=================================
.. contents::
   :local:

Document version.
=================

.. include:: VERSION.rst

Obtaining.
==========

For distribution tarbol use (for regular users)::

  gadict-$major.$minor.tar.bz2

For source tarboll use::

  gadict-$major.$minor_src.tar.gz

``$major`` and ``$minor`` represent version components.

To get these files use appropriate links:

 * https://sourceforge.net/projects/gadict/files/v$major.$minor/gadict-$major.$minor_src.tar.gz
 * https://sourceforge.net/projects/gadict/files/v$major.$minor/gadict-$major.$minor.tar.gz

Manual installation instruction for GoldenDict.
===============================================

Get distribution tarboll and extract all files to any directory. Select::

 Edit ==> Dictionaries...

in GoldenDict menu (or just press ``F3``) and add directory to where you
extracted files. Press ``Refresh`` button. That's all.

**Note** only ``*.dict.dz`` and ``*.index`` files are required for GoldenDict.
You can safely remove other fils.

How to build and install from supplied Makefile.
================================================

To build and install in /usr/local/ run as root::

  $ make install

If you run as regular user ``prefix`` set to::

  $HOME/usr

To build and install in different place run::

  $ make install prefix=PREFIX

How to uninstall from supplied Makefile.
========================================

To uninstall run one command from list accordingly to installation procedure::

  $ make uninstall
  $ make uninstall prefix=PREFIX
  $ make prefix=PREFIX uninstall uninstall-local-symlink