Installation instructions for gettext 0.10.39 (OS/2)

Make sure you have installed the software required to configure, compile
and install GNU software packages (See README.OS2 section I. for details).
Prepare your shell for the configuration process (See README.OS2 section
II. for details).


I. Short installation instructions

If you want to recreate your configuration files (for developers only)
you must have installed autoconf 2.50 and automake 1.4p5.
Enter the following:

export EMXSHELL=ksh
aclocal -I m4
automake
autoconf
autoheader


If you want to install this software into subdirectories of x:/usr
enter the following:

(note: as a developer you may want to execute a) first and then b),
 as a normal user you will most likely only need b) ).

a) If you choose large, statically linked, DOS/OS/2 combined executables:

   - (optional, only if you want to restrict support to a few languages,
     see README.OS2 for details)
     export LINGUAS="en de fr"
     This will install only "de" and "fr" ("en" is the default)

   - enter the following:
     export CFLAGS="-O2 -s -Zmt -D__ST_MT_ERRNO__"
     export LDFLAGS=""
     export RANLIB=""
     ./configure --prefix=x:/usr --with-included-gettext --disable-shared

     if you're using gcc/pgcc 2.95 or higher you may want to add also
     -lgcc for your LDFLAGS. Then your program will not require the
     compiler dependent library gcc????m.dll, but your executable may
     (or may not) increase in size.

   - make

   - make install aclocaldir=x:/usr/share/aclocal.gettext

     Note: because gettext wants to install some of its own aclocal macro files
           you have to specify aclocaldir=... that must be different from your
           real aclocal directory (normally x:/usr/share/aclocal). Otherwise
           you will run into trouble when you try to compile other packages.


b) If you choose smaller, dynamically linked, compressed, OS/2 only executables/libraries:

   - (optional, only if you want to install support for some languages
     but not for all, see README.OS2 for details)
     export LINGUAS="en de fr"

   - Enter the following lines without linebreaks:
     export CFLAGS="-O2 -s -Zmt -D__ST_MT_ERRNO__ -Zomf"
     export LDFLAGS="-Zcrtdll -Zlinker /exepack:2 -Zlinker /pm:vio"
     export RANLIB="echo"
     ./configure --prefix=x:/usr --with-included-gettext --disable-static

     if you're using gcc/pgcc 2.95 or higher you may want to set also
     use -lgcc for your LDFLAGS. Then your program will not require the
     compiler dependent library gcc????m.dll, but your executable may
     (or may not) increase in size.

   - make AR=emxomfar

   - due to a bug the *.exe file may be compiled in the wrong directories.
     move the *.exe file from src\.libs\*.exe to src\*.exe
     move the *.exe file from tests\.libs\*.exe to tests\*.exe

   - make install aclocaldir=x:/usr/share/aclocal.gettext

     Note: because gettext wants to install some of its own aclocal macro files
           you have to specify aclocaldir=... that must be different from your
           real aclocal directory (normally x:/usr/share/aclocal). Otherwise
           you will run into trouble when you try to compile other packages.


   Now some executables have been installed into x:/usr/bin
   and some other files into subdirectories of x:/usr
   Add x:\usr\bin to your PATH
   Add x:\usr\lib to your LIBPATH
   Add x:/usr/include to your C_INCLUDE_PATH
   Add x:/usr/lib to your LIBRARY_PATH
   Add x:/usr/local/man to your MANPATH
   Add x:/usr/local/info to your INFOPATH



II. Installation of gettext 0.10.39 from the original GNU source:

1. Download the autoconf package from ftp://ftp.gnu.org/gnu/gettext/.
   Apply the patches from diff-patches/*.
   Replace mkinstalldirs by an OS/2 compatible version.

2. export EMXSHELL=ksh
   aclocal -I m4
   automake
   autoconf
   autoheader

3. Proceed with the normal installation process in section II.



III. Uninstallation

1. Configure the package as normal if not already done.

2. To remove all previous installed files, enter:

   make uninstall



IV. Special notes:

1. Additionally to the original GNU package gettext-0_10_39_tar.gz this
   special OS/2 patch contains the following files:

   INSTALL.OS2
   README.OS2
   diff-patches/*

2. Some paths may be linked into the executables. If you move some of the
   files from this package to another location you may have to reinstall
   the whole package.

3. This version of gettext supports NLS including charset translation (single byte
   character sets only). For VIO consoles the correct charset is determined and
   the translation to your national codepage is performed.
   You can use the environment variable OUTPUT_CHARSET to overwrite the autodetection
   of your codepage (e.g. SET OUTPUT_CHARSET="CP850").

4. This version of gettext supports the UNIXROOT environment variable. This means
   if any program requests a NLS directory/file, first this directory/file is
   searched for, then the same directory/file on your UNIXROOT drive is searched for
   (e.g. c:/usr/share/locale is requested by your program; if this directory does
   not exist, this library will also try %UNIXROOT%/usr/share/locale).

--

Maintainer: Andreas Buening, <andreas.buening@nexgo.de>

