1: This is a port of GNU Libiconv 1.11 to MSDOS/DJGPP.
2:
3: 1.: 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:
11: 2.: Installing the binary package.
12: ==============================
13:
14: 2.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:
23: 3.: Building the binaries from sources.
24: ===================================
25:
26: 3.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:
44: 3.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.7/djgpp/fnchange.lst libiconv-1.7.tar.gz > lst
63: djtar -x -n lst libiconv-1.7.tar.gz
64:
65: (The name of the distribution archive and the top-level directory will
66: be different for versions other than 1.7.)
67:
68: 3.3.: The package is preconfigured for djdev203. To build the products you
69: should run the following command:
70: make
71:
72: After the compilation has finished, you can check the products
73: running the command:
74: make check
75:
76: To install the products run the command:
77: make install
78:
79: This will install the products (iconv.exe iconv.h localcharset.h libconv.a
80: libcharset.a iconv.1 iconv.3 iconv_open.3 iconv_close.3) into your DJGPP
81: installation tree. As usual, prefix is defined as "/dev/env/DJDIR".
82: If you prefer to install into same other directory run the command:
83: make install prefix=z:/some/other/dir
84:
85: Of course, you should replace "z:/some/other/dir" by an appropriate path
86: that will meet your requeriments.
87:
88: 3.4.: If you need/want to reconfigure the package you will have to run the
89: following commands:
90: make distclean
91: djgpp\config
92:
93: Please note that you *MUST* use the "distclean" option or the config.cache
94: file will *NOT* be deleted. In this case you are *NOT* reconfiguring
95: because the configuration informations is read from the cache file instead
96: of being newly computed.
97: To build the programs in a directory other than where the sources are,
98: you must add the parameter that specifies the source directory,
99: e.g:
100: x:\src\gnu\libiconv.111\djgpp\config x:/src/gnu/libiconv.111
101:
102: Lets assume you want to build the binaries in a directory placed on a
103: different drive (z:\build in this case) from where the sources are,
104: then you will run the following commands:
105: z:
106: md \build
107: cd \build
108: x:\src\gnu\libiconv.111\djgpp\config x:/src/gnu/libiconv.111
109:
110: You *MUST* use forward slashes to specify the source directory.
111: After having configured the package run the folowing commands to create
112: the binaries and docs and install them:
113: make
114: make check
115: make install
116:
117: Send suggestions and bug reports concerning the DJGPP port to
118: comp.os.msdos.djgpp or djgpp@delorie.com. Libiconv specific bugs
119: must be reported to Bruno Haible <haible@clisp.cons.org>.
120:
121:
122: Guerrero, Juan Manuel <st001906@hrz1.hrz.tu-darmstadt.de>
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>