Annotation of embedaddon/libiconv/djgpp/README.in, revision 1.1.1.1
1.1 misho 1: This is a port of GNU Libiconv @VER@ 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 licv@packageversion@b.zip or
18: djtarx licv@packageversion@b.zip or
19: pkunzip -d licv@packageversion@b.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 (patchlevel 2),
28: bshNNNb.zip, gccNNNb.zip, bnuNNNb.zip, makNNNb.zip, filNNNb.zip,
29: shlNNNb.zip, txtNNNb.zip, txiNNNb.zip, grepNNNb.zip, sedNNNb.zip,
30: and difNNN.zip
31:
32: NNN represents the latest version number of the binary packages. All
33: this packages can be found in the current/v2gnu/ directory of any
34: ftp.delorie.com mirror.
35:
36: 3.2.: Create a temporary directory and copy the source package: licv@packageversion@s.zip
37: into the temporary directory. If you download the source distribution
38: from one of the DJGPP archives, just unzip it preserving the directory
39: structure, runnig ONE of the following commands:
40: unzip32 licv@packageversion@s.zip or
41: djtarx licv@packageversion@s.zip or
42: pkunzip -d licv@packageversion@s.zip
43:
44: Source distributions downloaded from one of the GNU FTP sites need
45: some more work to unpack. First, you MUST use the `djtar' program
46: to unzip the package. That's because some file names in the official
47: distributions need to be changed to avoid problems on the various
48: platforms supported by DJGPP. `djtar' can rename files on the fly
49: given a file with name mappings. The distribution includes a file
50: `djgpp/fnchange.lst' with the necessary mappings. So you need first
51: to retrieve that file, and then invoke `djtar' to unpack the
52: distribution. Here's how:
53:
54: djtar -x -p -o @V@/djgpp/fnchange.lst @V@.tar.gz > lst
55: djtar -x -n lst @V@.tar.gz
56:
57: (The name of the distribution archive and the top-level directory will
58: be different for versions other than @VER@.)
59:
60: 3.3.: If you have downloaded the source package from one of the GNU FTP sites
61: you will have to configure the package running the command:
62: djgpp\config.bat
63:
64: 3.4.: If you have downloaded the source package from one of the delorie FTP
65: sites the package is already preconfigured for djdev203 or later. In
66: any case, to build the products you must run the following command:
67: make
68:
69: After the compilation has finished, you can check the products
70: running the command:
71: make check
72:
73: To install the products run the command:
74: make install
75:
76: This will install the products (iconv.exe iconv.h localcharset.h libconv.a
77: libcharset.a iconv.1 iconv.3 iconv_open.3 iconv_close.3) into your DJGPP
78: installation tree. As usual, prefix is defined as "/dev/env/DJDIR".
79: If you prefer to install into same other directory run the command:
80: make install prefix=z:/some/other/dir
81:
82: Of course, you should replace "z:/some/other/dir" by an appropriate path
83: that will meet your requeriments.
84:
85: 3.5.: If for some reason you want to reconfigure the package cd into the top
86: srcdir (libiconv.@treeversion@) and run the following commands:
87: del djgpp\config.cache
88: make distclean
89: djgpp\config
90:
91: Please note that you *MUST* delete the config.cache file in the djgpp
92: subdir or you will not really reconfigure the sources because the
93: configuration informations will be read from the cache file instead
94: of being newly computed.
95: To build the programs in a directory other than where the sources are,
96: you must add the parameter that specifies the source directory,
97: e.g:
98: x:\src\gnu\libiconv.@treeversion@\djgpp\config x:/src/gnu/libiconv.@treeversion@
99:
100: Lets assume you want to build the binaries in a directory placed on a
101: different drive (z:\build in this case) from where the sources are,
102: then you will run the following commands:
103: z:
104: md \build
105: cd \build
106: x:\src\gnu\libiconv.@treeversion@\djgpp\config x:/src/gnu/libiconv.@treeversion@
107:
108: You *MUST* use forward slashes to specify the source directory.
109: After having configured the package run the folowing commands to create
110: the binaries and docs and install them:
111: make
112: make check
113: make install
114:
115: Send suggestions and bug reports concerning the DJGPP port to
116: comp.os.msdos.djgpp or djgpp@delorie.com. Libiconv specific bugs
117: must be reported to <bug-gnu-libiconv@gnu.org>.
118:
119:
120: Guerrero, Juan Manuel <juan.guerrero@gmx.de>
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>