General
-------

This hotfix ZIP file consists of the following files:

 * LICENSE.txt		- Information about the Apache License v2
 * MACOSX.README.txt    - The file you are reading
 * MACOSX.README_de.txt - README auf Deutsch
 * NOTICE.txt		- Software notes
 * libtl.dylib		- Patch file that you will need to install
 * libtl.dylib.asc	- Public signature file of the developer who built the
                      patch file

You can use whatever GPG tools you have to verify the signature against the 
information provided in the Apache OpenOffice KEYS file:

https://dist.apache.org/repos/dist/release/openoffice/KEYS



Prerequisites
-------------

Download the hotfix ZIP file to a location on your PC where it can be used and 
its content extracted. In Mac OS X the typical folder is "Downloads". But you 
can use any other folder.



Installation Instructions
-------------------------

This file contains two sets of instructions. The first (I) outlines how to 
install the new library file using a Terminal window and the command line. The 
second (II) outlines how to install the new library file using the Finder. 
Both sets of instructions assume you downloaded the zip file and "unzipped" it 
directly into Downloads.

I.   Using the Terminal window.

I.1. Directions for updating the file using a Terminal window.
    These directions assume (1) familiarity with using the command line in a 
    Terminal window; and (2) that the user has administrator privileges.

I.2. Make sure that OpenOffice is not running.

I.3. Open the Finder App (or another file manager of your choice).

I.4. Determine the installation path.
    Locate the installation path of the OpenOffice program files. The default 
    path is "/Applications/OpenOffice.app/Contents/program/").

I.5. Make a backup of the existing file by renaming it.
    Rename the old file "libtl.dylib" to "libtl.dylib.original".
    You can keep the file "libtl.dylib.original" as a backup as long as you 
    want.

I.6. Copy the new file "libtl.dylib".
    From the extracted ZIP file copy the file "libtl.dylib" to the
    "/Applications/OpenOffice.app/Contents/program/" folder. You need 
    Administrator privileges for this.

    In a terminal window these commands will accomplish the file copy. It is 
    assumed that you downloaded and extracted the contents of the ZIP file
    directly into "Downloads":

    $ cd ~/Downloads
    $ sudo cp -v libtl.dylib /Applications/OpenOffice.app/Contents/program



II.   Using the Finder App - or another file manager of your choice.

II.1. Directions for updating the file without using a Terminal window.
    These instructions assume:

    (1) that the user account has Administrator privileges; and
    (2) that the file "libtl.dylib" was saved to the Downloads folder.

II.2. In Finder select the "Go" menu on the Application menu bar (at the top 
    of the screen) and open a window to the Downloads folder.

II.3. In Finder open another Finder window and in the sidebar select the 
    Applications folder:
    Do the follwoing steps:

    - Hold down the "Control" key and select the OpenOffice application.
    - Select "Show Package Contents" from the drop-down menu.

    - Open the Contents folder now displayed in the Finder window.
    - Select and open the "program" folder displayed in the Finder window.

    - Scroll through the list of files shown and find "libtl.dylib".
    - Hold down the "Control" key and select the "libtl.dylib" file.

    - Select "Duplicate" from the drop-down menu.
      (a file named "libtl copy.dylib" is created)
    - Select the back button "<" from the Finder window top menu.
      (the Finder displays the list of files and folders in the Contents 
      folder)

II.4. Select the Finder window showing the "Downloads" folder contents.
    Do the following steps:

    - Hold down the "Control" key and select the "libtl.dylib" file.
    - Select "Copy 'libtl.dylib'" from the drop-down menu.

    - Select the other Finder window showing the list of files in the Contents 
      folder.

    - Hold down the "Control" key and select the "program" folder.
    - Select "Paste Item" from the drop-down menu.

    - A window appears with the message:

      "An older item named "libtl.dylib" already exists in this location. Do 
      you want to replace it with the newer one you're moving?"

    - Select the "Replace" button.

Now the patch work is done and you can exit any opened Terminal window and
Finder.

Start Apache OpenOffice as you normally would as a non-privileged user.