1This is a port of GNU Libiconv 1.11 to MSDOS/DJGPP.
2
31.:     DJGPP specific changes.
4        =======================
5        There are no DJGPP specific changes. This package should
6        configure and compile out-of-the-box.
7        Please read the documentation to become familiar with this
8        product.
9
10
112.:     Installing the binary package.
12        ==============================
13
142.1.:   Copy the binary distribution into the top DJGPP installation
15        directory and unzip the binary distribution running *ONE* of
16        the following commands:
17          unzip32 licv111b.zip      or
18          djtarx licv111b.zip       or
19          pkunzip -d licv111b.zip
20
21
22
233.:     Building the binaries from sources.
24        ===================================
25
263.1.:   To build the binaries you will need the following binary packages:
27          djdev203.zip, bsh204b.zip, gcc2952b.zip,
28          bnu210b.zip, mak3791b.zip, fil316b.zip,
29          shl112b.zip, txt20b.zip, txi40b.zip,
30          grep24b.zip and sed302b.zip
31
32
33        All this packages can be found in the v2gnu directory of any
34        Simtel.NET mirror.
35        You will need bsh204b.zip and *NOT* a prior version or the build will fail.
36        The same applies to djdev203.zip. You *MUST* use the updated versions of
37        fil316b.zip (date: 2000-05-30) and shl112b.zip (date: 2000-08-11). This
38        updated versions have been recompiled with djdev203.zip and know about
39        the "/dev/env" functionality introduced with djdev203.zip. All the other
40        packages are the ones I have used to build the binaries from this sources.
41        Previuos and/or later versions of this packages may do the job as well but
42        I have not tested this.
43
443.2.:   Create a temporary directory and copy the source package: licv111s.zip
45        into the temporary directory. If you download the source distribution
46        from one of the DJGPP archives, just unzip it preserving the directory
47        structure, runnig ONE of the following commands:
48          unzip32 licv111s.zip      or
49          djtarx licv111s.zip       or
50          pkunzip -d licv111s.zip
51
52        Source distributions downloaded from one of the GNU FTP sites need
53        some more work to unpack.  First, you MUST use the `djtar' program to
54        unzip the package.  That's because some file names in the official
55        distributions need to be changed to avoid problems on the various
56        platforms supported by DJGPP.  `djtar' can rename files on the fly
57        given a file with name mappings.  The distribution includes a file
58        `djgpp/fnchange.lst' with the necessary mappings.  So you need first
59        to retrieve that file, and then invoke `djtar' to unpack the
60        distribution.  Here's how:
61
62          djtar -x -p -o libiconv-1.11/djgpp/fnchange.lst libiconv-1.11.tar.gz > lst
63          djtar -x -n lst libiconv-1.11.tar.gz
64
65        (The name of the distribution archive and the top-level directory will
66        be different for versions other than 1.11.)
67
68
693.3.:   The package is preconfigured for djdev203. To build the products you
70        should run the following command:
71          make
72
73        After the compilation has finished, you can check the products
74        running the command:
75          make check
76
77        To install the products run the command:
78          make install
79
80        This will install the products (iconv.exe iconv.h localcharset.h libconv.a
81        libcharset.a iconv.1 iconv.3 iconv_open.3 iconv_close.3) into your DJGPP
82        installation tree. As usual, prefix is defined as "/dev/env/DJDIR".
83        If you prefer to install into same other directory run the command:
84          make install prefix=z:/some/other/dir
85
86        Of course, you should replace "z:/some/other/dir" by an appropriate path
87        that will meet your requeriments.
88
893.4.:   If you need/want to reconfigure the package you will have to run the
90        following commands:
91          make distclean
92          djgpp\config
93
94        Please note that you *MUST* use the "distclean" option or the config.cache
95        file will *NOT* be deleted. In this case you are *NOT* reconfiguring
96        because the configuration informations is read from the cache file instead
97        of being newly computed.
98        To build the programs in a directory other than where the sources are,
99        you must add the parameter that specifies the source directory,
100        e.g:
101          x:\src\gnu\libiconv.16\djgpp\config x:/src/gnu/libiconv.16
102
103        Lets assume you want to build the binaries in a directory placed on a
104        different drive (z:\build in this case) from where the sources are,
105        then you will run the following commands:
106          z:
107          md \build
108          cd \build
109          x:\src\gnu\libiconv.16\djgpp\config x:/src/gnu/libiconv.16
110
111        You *MUST* use forward slashes to specify the source directory.
112        After having configured the package run the folowing commands to create
113        the binaries and docs and install them:
114          make
115          make check
116          make install
117
118        Send suggestions and bug reports concerning the DJGPP port to
119        comp.os.msdos.djgpp or djgpp@delorie.com. Libiconv specific bugs
120        must be reported to Bruno Haible <haible@clisp.cons.org>.
121
122
123          Guerrero, Juan Manuel <st001906@hrz1.hrz.tu-darmstadt.de>
124