1Installation 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
47