===================================================================

CyrillicTools -- a macro library for OpenOffice.org 1.1.0 and above.

Version 1.2

Installation instructions
===================================================================

Getting CyrillicTools
~~~~~~~~~~~~~~~~~~~~~

First, obtain the latest version of the CyrillicTools macro library. It is
distributed in a zipped archive called cyrtools*.uno.zip, where * stands 
for version number. There is no need to unzip this file to install it.
You can install the library either for a single user or as a part of a 
shared OpenOffice.org installation.

To install CyrillicTools for a single user:
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Place the cyrtools*.uno.zip package into an OpenOffice.org 1.1.* 
user-specific package directory. By default, the directory for 
user-specific packages is <OfficeHome>/user/uno_packages. <OfficeHome> 
stands for a directory where user's settings are stored, for example, 
C:\Documents and Settings\<User's Name>\OpenOffice.org1.1.0\
or /home/<User's Name>/OpenOffice.org1.1.0.

Run a command line shell and change to <OfficePath>/program. <OfficePath> 
stands for a directory where OpenOffice.org is installed, for example,
C:\Program Files\OpenOffice.org1.1.0\ or /opt/OpenOffice.org1.1.0.

Close all instances of OpenOffice.org and run the tool pkgchk from the program 
directory. The pkgchk tool is part of the OpenOffice.org installation.

For a user package, simply run pkgchk without options:

[<OfficePath>/program] $ pkgchk

The tool analyzes the packages in the package directories, matches them 
with a cache directory for custom extensions used by OpenOffice.org, registers 
the components found in the packages and configures them as needed.

To install Cyrillic Tools for all users:
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Place the cyrtools*.uno.zip package into an OpenOffice.org 1.1.* 
shared package directory. By default it is <OfficePath>/share/uno_packages.

Change to <OfficePath>/program and run pkgchk with the -s (or --shared)
option:

[<OfficePath>/program] $ pkgchk --shared

As an alternative, the package can also be specified as command line argument.
In that case, the cyrtools*.uno.zip file will be automatically copied into 
the package directory and installed afterwards.

[<OfficePath>/program] $ pkgchk /foo/bar/cyrtools*.uno.zip

Uninstall procedures
~~~~~~~~~~~~~~~~~~~~

To remove CyrillicTools from the OpenOffice.org installation, the opposite 
steps are necessary:

Remove the package from the packages directory.

Close all instances of OpenOffice.org and run pkgchk or pkgchk -s.

Further information
~~~~~~~~~~~~~~~~~~~

For further information about installing/uninstalling UNO packages under
OpenOffice.org 1.1.* refer to the OOo Developer's Guide, chapter 4.9.1
"UNO Package Installation".
