README.os2

   1 Installation on OS/2:
   2
   3 - Port done by Akira Hatakeyama <akira@sra.co.jp>, see
   4   http://www.sra.co.jp/people/akira/os2/libiconv/index.html
   5
   6 - Requires emx+gcc, recommend emx-0.9d with fix03 or newer.
   7
   8   Also requires a few GNU utilities to be installed: GNU fileutils (cp, mv,
   9   rm, ...), GNU textutils (cat, cmp, uniq, ...), GNU sed, GNU make.
  10
  11 - Cannot build in a separate directory.
  12
  13 - Build instructions:
  14
  15   No configure script needs to be run. Just
  16
  17        make -f Makefile.os2 all
  18
  19   Checking it:
  20
  21        make -f Makefile.os2 check
  22
  23 - Installation:
  24
  25        make -f Makefile.os2 install prefix="X:/emx"
  26
  27   The prefix option specifies where you have EMX installed and wish the
  28   iconv library and headers to be installed.
  29
  30   This will install
  31    * an include file                                  $(prefix)/include/iconv.h
  32    * a DLL                                            $(prefix)/dll/iconv.dll
  33    * an import library for .o (use without "-Zomf")   $(prefix)/lib/iconv.a
  34    * an import library for .obj (use with "-Zomf")    $(prefix)/lib/iconv.lib
  35    * a few manual pages                            $(prefix)/man/man3/iconv*.3
  36
  37 - Use:
  38
  39   Your main program should include <iconv.h> when using the iconv* functions.
  40
  41   If you compile as .o (no "-Zomf"), link with iconv.a.
  42   If you compile as .obj (with "-Zomf"), link with iconv.lib.
  43
  44   The DLL was built with "-Zmt -Zcrtdll" options. So your main program must
  45   be built with "-Zmt -Zcrtdll" as well (or the shorthand "-Zmtd").
  46