blob: 6245667075e9a391934949354cb382f76d6419b4 [file] [log] [blame]
This is a port of GNU Libiconv 1.11 to MSDOS/DJGPP.
1.: DJGPP specific changes.
There are no DJGPP specific changes. This package should
configure and compile out-of-the-box.
Please read the documentation to become familiar with this
2.: Installing the binary package.
2.1.: Copy the binary distribution into the top DJGPP installation
directory and unzip the binary distribution running *ONE* of
the following commands:
unzip32 or
djtarx or
pkunzip -d
3.: Building the binaries from sources.
3.1.: To build the binaries you will need the following binary packages:,,,,,,,,, and
All this packages can be found in the v2gnu directory of any
Simtel.NET mirror.
You will need and *NOT* a prior version or the build will fail.
The same applies to You *MUST* use the updated versions of (date: 2000-05-30) and (date: 2000-08-11). This
updated versions have been recompiled with and know about
the "/dev/env" functionality introduced with All the other
packages are the ones I have used to build the binaries from this sources.
Previuos and/or later versions of this packages may do the job as well but
I have not tested this.
3.2.: Create a temporary directory and copy the source package:
into the temporary directory. If you download the source distribution
from one of the DJGPP archives, just unzip it preserving the directory
structure, runnig ONE of the following commands:
unzip32 or
djtarx or
pkunzip -d
Source distributions downloaded from one of the GNU FTP sites need
some more work to unpack. First, you MUST use the `djtar' program to
unzip the package. That's because some file names in the official
distributions need to be changed to avoid problems on the various
platforms supported by DJGPP. `djtar' can rename files on the fly
given a file with name mappings. The distribution includes a file
`djgpp/fnchange.lst' with the necessary mappings. So you need first
to retrieve that file, and then invoke `djtar' to unpack the
distribution. Here's how:
djtar -x -p -o libiconv-1.7/djgpp/fnchange.lst libiconv-1.7.tar.gz > lst
djtar -x -n lst libiconv-1.7.tar.gz
(The name of the distribution archive and the top-level directory will
be different for versions other than 1.7.)
3.3.: The package is preconfigured for djdev203. To build the products you
should run the following command:
After the compilation has finished, you can check the products
running the command:
make check
To install the products run the command:
make install
This will install the products (iconv.exe iconv.h localcharset.h libconv.a
libcharset.a iconv.1 iconv.3 iconv_open.3 iconv_close.3) into your DJGPP
installation tree. As usual, prefix is defined as "/dev/env/DJDIR".
If you prefer to install into same other directory run the command:
make install prefix=z:/some/other/dir
Of course, you should replace "z:/some/other/dir" by an appropriate path
that will meet your requeriments.
3.4.: If you need/want to reconfigure the package you will have to run the
following commands:
make distclean
Please note that you *MUST* use the "distclean" option or the config.cache
file will *NOT* be deleted. In this case you are *NOT* reconfiguring
because the configuration informations is read from the cache file instead
of being newly computed.
To build the programs in a directory other than where the sources are,
you must add the parameter that specifies the source directory,
x:\src\gnu\libiconv.111\djgpp\config x:/src/gnu/libiconv.111
Lets assume you want to build the binaries in a directory placed on a
different drive (z:\build in this case) from where the sources are,
then you will run the following commands:
md \build
cd \build
x:\src\gnu\libiconv.111\djgpp\config x:/src/gnu/libiconv.111
You *MUST* use forward slashes to specify the source directory.
After having configured the package run the folowing commands to create
the binaries and docs and install them:
make check
make install
Send suggestions and bug reports concerning the DJGPP port to
comp.os.msdos.djgpp or Libiconv specific bugs
must be reported to Bruno Haible <>.
Guerrero, Juan Manuel <>