INSTALL.rst
author Oleksandr Gavenko <gavenkoa@gmail.com>
Fri, 13 Jul 2012 00:09:11 +0300
changeset 237 40f8ce891969
parent 236 19a1a3d73121
child 243 deede3c3386f
permissions -rw-r--r--
Update to new 0.5 release.
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
226
7f69e82d1a32 Move installation instruction to separate file.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
     1
.. -*- fill-column: 78 -*-
7f69e82d1a32 Move installation instruction to separate file.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
     2
7f69e82d1a32 Move installation instruction to separate file.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
     3
.. include:: header.rst
7f69e82d1a32 Move installation instruction to separate file.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
     4
7f69e82d1a32 Move installation instruction to separate file.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
     5
=================================
7f69e82d1a32 Move installation instruction to separate file.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
     6
 Installing gadict dictionaries.
7f69e82d1a32 Move installation instruction to separate file.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
     7
=================================
7f69e82d1a32 Move installation instruction to separate file.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
     8
.. contents::
7f69e82d1a32 Move installation instruction to separate file.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
     9
7f69e82d1a32 Move installation instruction to separate file.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
    10
Document version.
7f69e82d1a32 Move installation instruction to separate file.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
    11
=================
7f69e82d1a32 Move installation instruction to separate file.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
    12
7f69e82d1a32 Move installation instruction to separate file.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
    13
.. include:: VERSION.rst
7f69e82d1a32 Move installation instruction to separate file.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
    14
235
4a96c81d6c23 Obtaining instructions.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 229
diff changeset
    15
Obtaining.
4a96c81d6c23 Obtaining instructions.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 229
diff changeset
    16
==========
4a96c81d6c23 Obtaining instructions.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 229
diff changeset
    17
4a96c81d6c23 Obtaining instructions.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 229
diff changeset
    18
For distribution tarbol use (for regular users)::
4a96c81d6c23 Obtaining instructions.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 229
diff changeset
    19
4a96c81d6c23 Obtaining instructions.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 229
diff changeset
    20
  gadict-$major.$minor.tar.bz2
4a96c81d6c23 Obtaining instructions.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 229
diff changeset
    21
4a96c81d6c23 Obtaining instructions.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 229
diff changeset
    22
For source tarboll use::
4a96c81d6c23 Obtaining instructions.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 229
diff changeset
    23
4a96c81d6c23 Obtaining instructions.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 229
diff changeset
    24
  gadict-$major.$minor_src.tar.gz
4a96c81d6c23 Obtaining instructions.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 229
diff changeset
    25
4a96c81d6c23 Obtaining instructions.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 229
diff changeset
    26
``$major`` and ``$minor`` represent version components.
4a96c81d6c23 Obtaining instructions.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 229
diff changeset
    27
4a96c81d6c23 Obtaining instructions.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 229
diff changeset
    28
To get these files use appropriate links:
4a96c81d6c23 Obtaining instructions.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 229
diff changeset
    29
4a96c81d6c23 Obtaining instructions.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 229
diff changeset
    30
 * https://sourceforge.net/projects/gadict/files/v$major.$minor/gadict-$major.$minor_src.tar.gz
4a96c81d6c23 Obtaining instructions.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 229
diff changeset
    31
 * https://sourceforge.net/projects/gadict/files/v$major.$minor/gadict-$major.$minor.tar.gz
4a96c81d6c23 Obtaining instructions.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 229
diff changeset
    32
236
19a1a3d73121 Manual installation instruction for GoldenDict.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 235
diff changeset
    33
Manual installation instruction for GoldenDict.
19a1a3d73121 Manual installation instruction for GoldenDict.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 235
diff changeset
    34
===============================================
19a1a3d73121 Manual installation instruction for GoldenDict.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 235
diff changeset
    35
19a1a3d73121 Manual installation instruction for GoldenDict.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 235
diff changeset
    36
Get distribution tarboll and extract all files to any directory. Select::
19a1a3d73121 Manual installation instruction for GoldenDict.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 235
diff changeset
    37
19a1a3d73121 Manual installation instruction for GoldenDict.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 235
diff changeset
    38
 Edit ==> Dictionaries...
19a1a3d73121 Manual installation instruction for GoldenDict.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 235
diff changeset
    39
19a1a3d73121 Manual installation instruction for GoldenDict.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 235
diff changeset
    40
in GoldenDict menu (or just press ``F3``) and add directory to where you
19a1a3d73121 Manual installation instruction for GoldenDict.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 235
diff changeset
    41
extracted files. Press ``Refresh`` button. That's all.
19a1a3d73121 Manual installation instruction for GoldenDict.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 235
diff changeset
    42
19a1a3d73121 Manual installation instruction for GoldenDict.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 235
diff changeset
    43
**Note** only ``*.dict.dz`` and ``*.index`` files are required for GoldenDict.
19a1a3d73121 Manual installation instruction for GoldenDict.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 235
diff changeset
    44
You can safely remove other fils.
19a1a3d73121 Manual installation instruction for GoldenDict.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 235
diff changeset
    45
229
b7b92f209bd5 Fix header.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 228
diff changeset
    46
How to build and install from supplied Makefile.
b7b92f209bd5 Fix header.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 228
diff changeset
    47
================================================
226
7f69e82d1a32 Move installation instruction to separate file.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
    48
229
b7b92f209bd5 Fix header.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 228
diff changeset
    49
To build and install in /usr/local/ run as root::
226
7f69e82d1a32 Move installation instruction to separate file.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
    50
7f69e82d1a32 Move installation instruction to separate file.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
    51
  $ make install
7f69e82d1a32 Move installation instruction to separate file.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
    52
227
d988124ee012 Split file on sections.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 226
diff changeset
    53
If you run as regular user ``prefix`` set to::
d988124ee012 Split file on sections.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 226
diff changeset
    54
d988124ee012 Split file on sections.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 226
diff changeset
    55
  $HOME/usr
d988124ee012 Split file on sections.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 226
diff changeset
    56
229
b7b92f209bd5 Fix header.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 228
diff changeset
    57
To build and install in different place run::
226
7f69e82d1a32 Move installation instruction to separate file.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
    58
7f69e82d1a32 Move installation instruction to separate file.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
    59
  $ make install prefix=PREFIX
7f69e82d1a32 Move installation instruction to separate file.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
    60
227
d988124ee012 Split file on sections.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 226
diff changeset
    61
How to uninstall from supplied Makefile.
d988124ee012 Split file on sections.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 226
diff changeset
    62
========================================
d988124ee012 Split file on sections.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 226
diff changeset
    63
226
7f69e82d1a32 Move installation instruction to separate file.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
    64
To uninstall run one command from list accordingly to installation procedure::
7f69e82d1a32 Move installation instruction to separate file.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
    65
7f69e82d1a32 Move installation instruction to separate file.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
    66
  $ make uninstall
7f69e82d1a32 Move installation instruction to separate file.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
    67
  $ make uninstall prefix=PREFIX
7f69e82d1a32 Move installation instruction to separate file.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
    68
  $ make prefix=PREFIX uninstall uninstall-local-symlink
227
d988124ee012 Split file on sections.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 226
diff changeset
    69